Connect Amazon Q Developer to the CloudBees CI MCP Router

Amazon Q Developer is an AI-powered coding assistant that integrates with the CloudBees CI MCP Router through the Jenkins MCP Server plugin, connecting your development environment to CloudBees CI on modern cloud platforms. This enables context-aware assistance, automation, and access to real CloudBees CI data, allowing you to interact with Jenkins resources directly from your development environment using natural language queries and commands.

Prerequisites

Before you begin, ensure that you have:

Set up the CloudBees CI MCP Router, and have a copy of your encoded credentials for HTTP basic authentication.
The CloudBees CI MCP Router installed.
Amazon Q Developer installed. For instructions, refer to Installing the Amazon Q Developer extension or plugin in your IDE or Installing Amazon Q for command line.

Connect Amazon Q Developer to the CloudBees CI MCP Router

After completing the prerequisites, connect Amazon Q Developer to the CloudBees CI MCP Router.

To connect Amazon Q Developer to the CloudBees CI MCP Router:

Create or open the mcp.json configuration file in your Amazon Q Developer configuration directory (typically located at ~/.aws/amazonq/mcp.json).

You can also create a workspace-specific configuration by placing the mcp.json file in your project’s .amazonq/ directory (for example, /path/to/your/project/.amazonq/mcp.json). Workspace-level configurations take precedence over global configurations.

Add your CloudBees CI MCP Router configuration to the mcp.json file, including the encoded HTTP basic authentication credentials you generated in Set up the CloudBees CI MCP Router.
```
{
  "mcpServers": {
    "ci-mcp-router": {
      "type": "http",
      "url": "http://localhost:9000/mcp",
      "headers": {
        "Authorization": "Basic dXNlcm5hbWU6dG9rZW4="(1)
      }
    }
  }
}▼
```
1 Replace dXNlcm5hbWU6dG9rZW4= with your actual encoded credentials.
Save the mcp.json file.
Restart Amazon Q Developer to apply the new configuration.
Verify the connection to the CloudBees CI MCP Router.
- If you are using an IDE with the Amazon Q Developer extension or plugin, you can verify the connection by asking Amazon Q a question such as How many CloudBees CI jobs are there? If the connection is successful, Amazon Q will respond with information from your CloudBees CI instance.
- If you are using the Amazon Q Developer CLI, run the qchat command to start an interactive chat session with Amazon Q. When the connection is established, you should see output similar to:
  ✓ ci-mcp-router loaded in 0.11 s
  ▼

Use Amazon Q Developer for development tasks

Now that Amazon Q Developer is connected to the CloudBees CI MCP Router, you can use the following tools and commands to accelerate your development workflow. For a list of supported Jenkins tools, refer to MCP Server plugin - Available Tools.