Install the Goose client for CloudBees Unify MCP Server

The local CloudBees CloudBees Unify MCP Server (stdio transport) is being deprecated as of May 31, 2026. This documentation is no longer maintained.

Migrate to the remote CloudBees CloudBees Unify MCP Server for continued support and access to new capabilities. The remote server is hosted by CloudBees, requires no local installation, and uses OAuth-based authentication.

Refer to Migrate to the remote MCP server for migration steps.

Goose is an agentic open-source client that can query and interact with MCP servers. Use these steps to install and configure the Goose agent to enable secure communication with CloudBees Unify MCP Server. For more information, refer to the Goose installation guide.

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.

Docker-based installation

You can install and configure CloudBees Unify MCP Server using a Docker-based setup. This option is useful when integrating with tools like Goose or working across platform environments.

Configure a Goose extension

You can configure a Goose extension to connect with the MCP Docker container using stdio mode.

extensions:
  cloudbees/unify:
    type: stdio
    name: cloudbees/unify
    cmd: docker
    args:
    - run
    - --rm
    - -i
    - --env=CLOUDBEES_PERSONAL_ACCESS_TOKEN
    - cloudbees/unify-mcp-server:latest
    - stdio
    - --mode=unify
    - --organization-id=<ORGANIZATION_ID>
    enabled: true
    env_keys:
    - CLOUDBEES_PERSONAL_ACCESS_TOKEN
    timeout: 300▼

Native installation

You can also install the Goose extension using a native CloudBees Unify MCP Server binary.

Goose does not support the automatic installation of extensions using native binaries.

extensions:
  cloudbees/unify:
    type: stdio
    name: cloudbees/unify
    cmd: cloudbees-unify-mcp-server
    args:
    - stdio
    - --mode=unify
    - --organization-id=<ORGANIZATION_ID>
    enabled: true
    timeout: 300▼