Install the Amazon Q CLI client for CloudBees MCP

Amazon Q Developer is a generative artificial intelligence (AI) powered conversational assistant that can help you understand, build, extend, and operate AWS applications. You can ask questions about AWS architecture, your AWS resources, best practices, documentation, support, and more.

For more information, refer to:

In both installation methods below, you must ensure the CLOUDBEES_PERSONAL_ACCESS_TOKEN environment variable is set before booting the CLI. You can also set this variable in ~/.aws/.env.

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 MCP using a Docker-based setup.

Configure the MCP extension

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

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

$ q mcp add --name cloudbees \
    --scope global \
    --command "docker" \
    --args 'run' \
    --args '--rm' \
    --args '-i' \
    --args '--env' \
    --args 'CLOUDBEES_PERSONAL_ACCESS_TOKEN' \
    --args 'cloudbees/cloudbees-mcp:latest' \
    --args 'stdio' \
    --args '--mode=platform' \
    --args '--organization-id=<ORGANIZATION_ID>'▼

Native installation

You can also install the agent using a native CloudBees MCP binary.

$ q mcp add --name cloudbees \
    --scope global \
    --command "cloudbees-mcp" \
    --args 'stdio' \
    --args '--mode=platform' \
    --args '--organization-id=<ORGANIZATION_ID>'▼