Configuring AI tools with the remote MCP server

This page explains how to configure your AI tool to work with the remote Buildkite MCP server.

The Buildkite MCP server is available both locally and remotely. This page is about configuring AI tools with the remote MCP server. If you are using an AI tool or agent and would prefer it to work with the local MCP server, ensure you have followed the required instructions on Installing the Buildkite MCP server locally first, before proceeding with the relevant instructions on its Configuring AI tools page.

Amp

You can configure Amp with the remote Buildkite MCP server, by adding the following JSON configuration to your Amp settings.json file, which requires the mcp-remote command argument to allow OAuth authorization. Learn more about this type of configuration in the Custom Tools (MCP) section of the Amp docs.

{
  "amp.mcpServers": {
    "buildkite": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.buildkite.com/mcp"
      ]
    }
  }
}

Once connected to the remote MCP server, if you need a new OAuth token, the Authorize Application for the Buildkite MCP Server page appears. If so, scroll down and select your Buildkite organization in Authorize for organization, followed by Authorize.

You're now ready to use the Buildkite's remote MCP server through Amp for this Buildkite organization.

Claude Code

You can configure Claude Code with the remote Buildkite MCP server by running the relevant Claude Code command, after installing Claude Code.

claude mcp add --transport http buildkite https://mcp.buildkite.com/mcp

You're now ready to use the Buildkite's remote MCP server through Claude Code for this Buildkite organization.

Claude Desktop

You can configure Claude Desktop with the remote Buildkite MCP server, by doing the following to configure this server in Claude Desktop.

This process assumes you are on an Enterprise, Team, Pro or Max plan for Claude Desktop.

Select Settings > Connectors.
In the Connectors section, and if you are on an Enterprise or Team plan, select the Organization connectors tab.
Select the Add custom connector button.
In the Add custom connector dialog, for the Name field, specify Buildkite.
For the Remote MCP server URL field, specify https://mcp.buildkite.com/mcp.
Select Add to complete the configuration.
Back in the Connectors section, select the Connect button for Buildkite to connect to the remote MCP server.

Note: If you are on the Enterprise or Team plan, to access this Connect button, you may need to select the Your connectors tab first.

If you need a new OAuth token, the Authorize Application for the Buildkite MCP Server page appears. If so, scroll down and select your Buildkite organization in Authorize for organization, followed by Authorize.

You're now ready to use the Buildkite's remote MCP server through Claude Desktop for this Buildkite organization.

If you need more assistance with this process, follow Anthropic's guidelines for Getting Started with Custom Connectors.

Cursor

You can configure Cursor with the remote Buildkite MCP server by adding the relevant configuration to your Cursor's mcp.json file, which is usually located in your home directory's .cursor sub-directory.

From your Cursor Settings, select MCP & Integrations.
Under MCP Tools, select Add Custom MCP to open the mcp.json file.
Implement the following update to this file, where if you have other MCP servers configured in Cursor, just add the "buildkite": { ... } object to this JSON file.

{
  "mcpServers": {
    "buildkite": {
      "url": "https://mcp.buildkite.com/mcp"
    }
  }
}

You're now ready to use the Buildkite's remote MCP server through Cursor for this Buildkite organization.

Goose

Goose is a local AI tool and agent that can be configured with different LLM (AI model) providers.

You can configure Goose with the remote Buildkite MCP server by adding the relevant configuration to the extensions: section of your Goose config.yaml file.

extensions:
  buildkite:
    available_tools: []
    bundled: null
    description: null
    enabled: true
    env_keys: []
    envs: {}
    headers: {}
    name: Buildkite HTTP
    timeout: 300
    type: streamable_http
    uri: https://mcp.buildkite.com/mcp

You're now ready to use the Buildkite's remote MCP server through Goose for this Buildkite organization.

Visual Studio Code

You can configure Visual Studio Code with the remote Buildkite MCP server by adding the relevant configuration to your Visual Studio Code's mcp.json file.

{
  "servers": {
    "buildkite": {
      "url": "https://mcp.buildkite.com/mcp",
      "type": "http"
    }
  }
}

Alternatively, you can initiate this process through the Visual Studio Code interface. To do this:

In the Command Palette, find and select the MCP: Add Server command.
Select HTTP (HTTP or Server-Sent Events) to start configuring a remote MCP server.
For Enter Server URL, specify https://mcp.buildkite.com/mcp.
For Enter Server ID, specify buildkite.

Follow the remaining prompts to complete this configuration process.

You're now ready to use the Buildkite's remote MCP server through Visual Studio Code for this Buildkite organization.

Windsurf

You can configure Windsurf with the remote Buildkite MCP server by adding the relevant configuration to your Windsurf's mcp_config.json file.

{
  "mcpServers": {
    "buildkite": {
      "url": "https://mcp.buildkite.com/mcp"
    }
  }
}

You're now ready to use the Buildkite's remote MCP server through Windsurf for this Buildkite organization.