Install the Claude Code CLI client for CloudBees MCP

Claude Code is Anthropic’s official command-line interface (CLI) tool for AI-powered conversational assistance in your development workflow. Use Claude Code CLI to ask questions, generate code, explore best practices, and get help with architecture, documentation, and support tasks, all from your terminal. For detailed usage instructions and advanced features, refer to the Claude Code documentation.

MCP client configuration examples are provided for demonstration purposes only, and they do not constitute an endorsement or recommendation. Review and adapt configurations to meet your organization’s environment and security requirements.

Install the Claude Code CLI

Follow the official Claude Code setup guide to install Claude Code CLI.

Run a test command after installation to confirm your CLI can communicate with Claude Code CLI.

Configure the MCP extension

You can connect Claude Code CLI to the CloudBees MCP server using one of the following methods:

Local CloudBees MCP server
Docker-based CloudBees MCP server

Local CloudBees MCP server

Use this method only if you have installed the CloudBees MCP server binary on your local machine, and it is available in your system PATH. This option does not work for Docker-based or remote CloudBees MCP server deployments.

If you have not installed the CloudBees MCP server locally, use the Docker-based CloudBees MCP server option below.

You must acquire your organization ID first and then place it directly into the configuration. For more information, refer to how to retrieve your organization ID.

claude mcp add cloudbees \
  --env CLOUDBEES_PERSONAL_ACCESS_TOKEN=YOUR_TOKEN \
  --scope user \
  --transport stdio \
  -- cloudbees-mcp stdio --mode=platform --organization-id=<ORGANIZATION_ID>▼

Docker-based CloudBees MCP server

Use this method if you want to run the CloudBees MCP server in a Docker container.

claude mcp add cloudbees \
  --env CLOUDBEES_PERSONAL_ACCESS_TOKEN=YOUR_TOKEN \
  --scope user \
  --transport stdio \
  -- docker run --rm -i --env CLOUDBEES_PERSONAL_ACCESS_TOKEN \
  cloudbees/cloudbees-mcp:latest stdio --mode=platform --organization-id=<ORGANIZATION_ID>▼

Verify the CloudBees MCP server connection

After configuration, verify that Claude Code CLI can connect to your CloudBees MCP server instance. For troubleshooting, refer to the Claude Code documentation.

Example usage

Once configured, you can interact with CloudBees MCP through Claude Code CLI.

Basic MCP interaction

To list available MCP tools, run:

claude mcp list▼

In the Claude Code CLI interface, you can ask questions such as:

Find the "development" organization.
Show me the pipelines in my organization.
What are the recent builds for project X?
Using CloudBees Unify, find all the security vulnerabilities for the current project and then create a branch with fixes.