Connect Claude Desktop to the CloudBees Unify MCP Server so you can work with CloudBees Unify conversationally from Claude Desktop. For an overview of the CloudBees Unify MCP Server, refer to Understanding the CloudBees Unify MCP Server.
| Claude Desktop calls MCP servers "connectors." The CloudBees Unify MCP Server is available as a connector directly from the Anthropic Claude Directory — no manual configuration required. |
Prerequisites
Complete the following before you begin:
-
Install Claude Desktop on your machine.
-
Have an active CloudBees Unify account.
-
Have a web browser available for OAuth authentication.
Add the CloudBees Unify MCP Server
-
In Claude Desktop, open Settings and select Connectors.
-
Select the Discover tab.
-
Search for
CloudBeesand locate CloudBees Unify MCP Server in the results. -
Select + next to CloudBees Unify MCP Server.
A browser window opens to begin the sign-in flow.
-
Sign in to CloudBees Unify using Google, GitHub, or your SSO provider.
-
Select your Root Organization from the list.
Only organizations you have access to are listed.
-
Select Open desktop app to return to Claude Desktop.
Claude Desktop completes the connection.
During setup, Claude Desktop may display a notice that community connectors have undergone automated review but are not verified by Anthropic. This is expected — the CloudBees Unify MCP Server is distributed through the Anthropic Claude Directory and this notice appears for all directory-listed connectors. Proceed with the setup.
Filter tools
|
For optimal performance, enable no more than two toolsets at a time. Enabling all available toolsets increases the number of tools exposed to the CloudBees Unify MCP Server, which may degrade performance and response quality. Enable only the toolsets required for your workflow. |
The CloudBees Unify MCP Server connected through the Claude Directory uses the all toolset by default.
To select specific toolsets, add a custom connector using a URL that includes the toolset query parameter.
For instructions on adding a custom connector in Claude Desktop, refer to Get started with custom connectors using remote MCP in the Anthropic Help Center.
When adding the CloudBees Unify MCP Server as a custom connector, use the following server URL:
https://mcp.cloudbees.io/v1/mcp
To filter to specific toolsets, append the toolset query parameter:
https://mcp.cloudbees.io/v1/mcp?toolset=workflows,application-security
To restrict to read-only tools, add the readonly parameter:
https://mcp.cloudbees.io/v1/mcp?toolset=workflows,application-security&readonly=true
The OAuth client ID is public-mcp-client.
Use this exact value. Do not register your own OAuth client ID.
For the full list of available toolsets, refer to CloudBees Unify MCP Server tool reference.
After you add the connector, it appears in your connectors list as type Web with a Custom badge and a Connect button.
Verify the connection
After connecting, the CloudBees Unify MCP Server appears as an active connector in Claude Desktop. Start a new conversation to use the CloudBees Unify MCP Server.
Test the connection with an example prompt:
Claude Desktop calls the CloudBees Unify MCP Server and returns your component list.
If you receive an error, refer to Troubleshoot CloudBees Unify MCP Server issues.
Manage the connection
After connecting to the CloudBees Unify MCP Server, you can reauthenticate or remove the connector as needed.
Reauthenticate the CloudBees Unify MCP Server
If your authentication expires or you need to switch organizations:
-
In Claude Desktop, open Settings and select Connectors.
-
Find CloudBees Unify MCP Server and select it to reauthenticate.
-
Complete the OAuth flow in your browser.
-
Select your organization.
Troubleshoot
If you encounter connection or authentication issues, refer to Troubleshoot CloudBees Unify MCP Server issues.