Connect Claude Code

This guide shows you how to configure Claude Code to connect to the CloudBees Unify MCP Server.

Before you begin

Complete the following prerequisites before you begin:

Claude Code installed on your machine.
An active CloudBees Unify account.
A web browser for OAuth authentication.

Add the CloudBees Unify MCP Server

You can add the CloudBees Unify MCP Server using either a command or by editing the configuration file directly.

Option 1: Add via command (recommended)

In your terminal, run:

claude mcp add \
  "unify-mcp-server" \
  "https://mcp.cloudbees.io/v1/mcp" \
  --transport http \
  --client-id public-mcp-client▼

Claude Code adds the CloudBees Unify MCP Server to your MCP configuration.

public-mcp-client is the shared OAuth client ID for the CloudBees Unify MCP Server. Use this exact value. You do not need to register your own.

If you get an error about --client-id being an unknown option, run claude update to get the latest version.

Option 2: Add via configuration file

Locate your Claude Code MCP configuration file:
- macOS: ~/.claude.json
- Linux: ~/.claude.json
- Windows: %USERPROFILE%\.claude.json
Open the file in a text editor.

Add the CloudBees Unify MCP Server entry:

{
  "mcpServers": {
    "unify-mcp-server": {
      "type": "http",
      "url": "https://mcp.cloudbees.io/v1/mcp",
      "oauth": {
        "clientId": "public-mcp-client"
      }
    }
  }
}▼

If you already have other CloudBees Unify MCP Servers configured, add the unify-mcp-server entry to the existing mcpServers object.

Save the file.
Restart Claude Code or reload the MCP configuration.

Authenticate with CloudBees Unify

After adding the server, authenticate with CloudBees Unify:

In Claude Code, enter /mcp or check the MCP servers panel to view your MCP servers list.
Find "unify-mcp-server" in the list.
Select Connect or Authenticate.
A new browser window opens showing the CloudBees Unify sign-in page:
1. Sign in using Google, GitHub, or your SSO provider.
2. Select your Root Organization from the list.
3. The browser shows "Authentication successful."
4. Return to Claude Code.
Claude Code confirms the connection.

If you’re already signed in to CloudBees Unify in your browser, you may only need to select your Root Organization. You only see organizations you have access to.

Verify the connection

Test the connection by asking Claude Code a question that requires CloudBees Unify:

List my CloudBees Unify components.

Claude Code should call the CloudBees Unify MCP Server and return your component list.

You can also verify the connection in the CloudBees Unify MCP Server panel:

Enter /mcp in Claude Code.
Look for "unify-mcp-server" with a connected status indicator.
Select View Tools to view the available CloudBees Unify tools.

Manage the connection

After connecting to the CloudBees Unify MCP Server, you can disconnect, reauthenticate, or remove the server configuration as needed.

Disconnect from the CloudBees Unify MCP Server

If you need to disconnect:

In Claude Code, enter /mcp to open the MCP servers panel.
Find "unify-mcp-server".
Select Disconnect.

Your configuration remains in place; you can reconnect at any time.

Reauthenticate the CloudBees Unify MCP Server

If your authentication expires or you need to switch organizations:

In Claude Code, enter /mcp to open the MCP servers panel.
Find "unify-mcp-server".
Select Reauthenticate.
Complete the OAuth flow in your browser.
Select the desired organization.

Remove the CloudBees Unify MCP Server

To completely remove the CloudBees Unify MCP Server, run:

claude mcp remove unify-mcp-server▼

Alternatively, open your MCP configuration file (refer to Option 2: Add via configuration file above), remove the unify-mcp-server entry from the mcpServers object, save the file, and restart Claude Code.

Troubleshooting

If you encounter connection or authentication issues, refer to Troubleshoot common issues with the CloudBees Unify MCP Server.

What’s next

Continue learning about the CloudBees Unify MCP Server with these related topics.