> ## Documentation Index
> Fetch the complete documentation index at: https://docs.honeycomb.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Connecting to Honeycomb MCP

> Connect your AI agent to the Honeycomb MCP Server.

Connect Honeycomb to any AI agent that supports the Model Context Protocol (MCP) so it can query your telemetry, investigate issues, and answer questions using your live Honeycomb data.
This guide covers the fastest way to connect, manual configuration for specific clients, and authentication with an API key.

## Before you begin

Make sure that:

* Your Honeycomb team has [enabled Honeycomb Intelligence](/configure/teams/manage-behavior#enable-honeycomb-intelligence).
* Your AI agent supports remote MCP servers or plugins.

## Put your agent to work

Two prompts are all it takes: one connects your agent to Honeycomb, the other starts onboarding using your live data.

1. Select your region and run the associated prompt in your AI agent:

   <Tabs>
     <Tab title="US">
       <Prompt description="Connect to the Honeycomb MCP server (US)" icon="sparkle">
         Add the Honeycomb MCP server at [https://mcp.honeycomb.io/mcp](https://mcp.honeycomb.io/mcp) and authenticate with OAuth.
       </Prompt>
     </Tab>

     <Tab title="EU">
       <Prompt description="Connect to the Honeycomb MCP server (EU)" icon="sparkle">
         Add the Honeycomb MCP server at [https://mcp.eu1.honeycomb.io/mcp](https://mcp.eu1.honeycomb.io/mcp) and authenticate with OAuth.
       </Prompt>
     </Tab>
   </Tabs>

2. Once your agent authenticates, run this prompt to start onboarding:

   <Prompt description="Begin Honeycomb onboarding" icon="sparkle">
     /honeycomb-onboarding
   </Prompt>

Your agent introduces itself, asks a few quick questions about your role and which services you work on, and looks at what is actually sending data to your Honeycomb account.
From there, you choose what to focus on: debugging a live issue, exploring your data, or checking reliability.
Your agent tailors everything that follows to the service and path you pick.

## Connect manually

For step-by-step configuration instructions, select your client:

<div className="hny-client-tabs">
  <Tabs>
    <Tab title="Amazon Q">
      Connect Amazon Q Developer to Honeycomb MCP using the qchat CLI:

      1. Select your region and run the associated command in your terminal:

               <Tabs>
                 <Tab title="US">
                   ```bash wrap theme={}
                   qchat mcp add --name honeycomb --command npx --args mcp-remote,https://mcp.honeycomb.io/mcp
                   ```
                 </Tab>

                 <Tab title="EU">
                   ```bash wrap theme={}
                   qchat mcp add --name honeycomb --command npx --args mcp-remote,https://mcp.eu1.honeycomb.io/mcp
                   ```
                 </Tab>
               </Tabs>

      2. Run this prompt in Amazon Q and authenticate with Honeycomb when asked:

               <Prompt description="Set up Honeycomb" icon="sparkle">
                 /honeycomb-setup
               </Prompt>

      3. Once your agent authenticates, run this prompt to start onboarding:

               <Prompt description="Begin Honeycomb onboarding" icon="sparkle">
                 /honeycomb-onboarding
               </Prompt>
    </Tab>

    <Tab title="Auggie CLI">
      Connect Augment (Auggie CLI) to Honeycomb MCP by installing the Honeycomb plugin:

      1. Add the [honeycomb/agent-skill](https://github.com/honeycombio/agent-skill) repo as a plugin source:

         ```bash theme={}
         auggie plugin marketplace add honeycombio/agent-skill
         ```

      2. Install the Honeycomb plugin.

         ```bash theme={}
         auggie plugin install honeycomb
         ```

      3. Run this prompt in Auggie and authenticate with Honeycomb when asked:

               <Prompt description="Set up Honeycomb" icon="sparkle">
                 /honeycomb-setup
               </Prompt>

      4. Once your agent authenticates, run this prompt to start onboarding:

               <Prompt description="Begin Honeycomb onboarding" icon="sparkle">
                 /honeycomb-onboarding
               </Prompt>
    </Tab>

    <Tab title="ChatGPT">
      Connect ChatGPT to Honeycomb MCP by installing the Honeycomb app from ChatGPT's app directory:

      1. Go to the [Honeycomb plugin](https://chatgpt.com/plugins/plugin_asdk_app_6a51b29fa2d48191b215ff28f9a64fb4) page.
      2. Select **Install plugin**.
      3. When prompted, sign in to Honeycomb to finish authentication.
      4. Once your agent authenticates, run this prompt to start onboarding:

               <Prompt description="Begin Honeycomb onboarding" icon="sparkle">
                 /honeycomb-onboarding
               </Prompt>
    </Tab>

    <Tab title="Claude Code">
      Connect Claude Code to Honeycomb MCP by installing the Honeycomb plugin:

      1. Install Honeycomb as a Claude Code plugin:

         ```bash theme={}
         claude plugin marketplace add honeycombio/agent-skill
         claude plugin install honeycomb
         ```

      2. Run this prompt in Claude Code and authenticate with Honeycomb when asked:

               <Prompt description="Set up Honeycomb" icon="sparkle">
                 /honeycomb-setup
               </Prompt>

      3. Once your agent authenticates, run this prompt to start onboarding:

               <Prompt description="Begin Honeycomb onboarding" icon="sparkle">
                 /honeycomb-onboarding
               </Prompt>

      <Accordion title="Set up Claude Code manually">
        1) Select your region and run the associated command in your terminal:

                   <Tabs>
                     <Tab title="US">
                       ```bash wrap theme={}
                       claude mcp add honeycomb --transport http https://mcp.honeycomb.io/mcp
                       ```
                     </Tab>

                     <Tab title="EU">
                       ```bash wrap theme={}
                       claude mcp add honeycomb --transport http https://mcp.eu1.honeycomb.io/mcp
                       ```
                     </Tab>
                   </Tabs>

        2) Run this prompt in Claude Code and authenticate with Honeycomb when asked:

                   <Prompt description="Set up Honeycomb" icon="sparkle">
                     /honeycomb-setup
                   </Prompt>

        3) Once your agent authenticates, run this prompt to start onboarding:

                   <Prompt description="Begin Honeycomb onboarding" icon="sparkle">
                     /honeycomb-onboarding
                   </Prompt>
      </Accordion>
    </Tab>

    <Tab title="Claude Desktop">
      Connect Claude Desktop to Honeycomb MCP using the Honeycomb connector:

      1. Go to the [Honeycomb connector](https://claude.ai/directory/connectors/honeycomb) page.
      2. Select **Connect** to add the Honeycomb connector to your Claude Desktop.
      3. When prompted, sign in to Honeycomb to finish authentication.
      4. Once your agent authenticates, run this prompt to start onboarding:

               <Prompt description="Begin Honeycomb onboarding" icon="sparkle">
                 /honeycomb-onboarding
               </Prompt>
    </Tab>

    <Tab title="Codex">
      Connect OpenAI Codex to Honeycomb MCP by installing the Honeycomb app:

      1. Go to the [Honeycomb plugin](https://chatgpt.com/plugins/plugin_asdk_app_6a51b29fa2d48191b215ff28f9a64fb4) page.
      2. Select **Install plugin**.
      3. When prompted, sign in to Honeycomb to finish authentication.
      4. Once your agent authenticates, run this prompt to start onboarding:

               <Prompt description="Begin Honeycomb onboarding" icon="sparkle">
                 /honeycomb-onboarding
               </Prompt>

      <Accordion title="Set up Codex manually">
        1) Select your region and run the associated command in your terminal:

                   <Tabs>
                     <Tab title="US">
                       ```bash wrap theme={}
                       codex mcp add honeycomb --url https://mcp.honeycomb.io/mcp
                       ```
                     </Tab>

                     <Tab title="EU">
                       ```bash wrap theme={}
                       codex mcp add honeycomb --url https://mcp.eu1.honeycomb.io/mcp
                       ```
                     </Tab>
                   </Tabs>

        2) Run this prompt in Codex and authenticate with Honeycomb when asked:

                   <Prompt description="Set up Honeycomb" icon="sparkle">
                     /honeycomb-setup
                   </Prompt>

        3) Once your agent authenticates, run this prompt to start onboarding:

                   <Prompt description="Begin Honeycomb onboarding" icon="sparkle">
                     /honeycomb-onboarding
                   </Prompt>
      </Accordion>
    </Tab>

    <Tab title="Copilot">
      Connect GitHub Copilot to Honeycomb MCP by installing the Honeycomb plugin:

      1. Install Honeycomb as a Copilot plugin:

         ```bash theme={}
         copilot plugin install honeycombio/agent-skill:honeycomb
         ```

      2. Run this prompt in Copilot and authenticate with Honeycomb when asked:

               <Prompt description="Set up Honeycomb" icon="sparkle">
                 /honeycomb-setup
               </Prompt>

      3. Once your agent authenticates, run this prompt to start onboarding:

               <Prompt description="Begin Honeycomb onboarding" icon="sparkle">
                 /honeycomb-onboarding
               </Prompt>
    </Tab>

    <Tab title="Cursor">
      Connect Cursor to Honeycomb MCP using a one-click install link: [Add Honeycomb to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=honeycomb\&config=eyJ1cmwiOiJodHRwczovL21jcC5ob25leWNvbWIuaW8vbWNwIn0=)

      <Accordion title="Set up Cursor manually">
        1. Open Cursor and navigate to **Customize**.

        2. Select **MCP** then select **+New**.

        3. Select your region and update `mcp.json` with the associated configuration:

                   <Tabs>
                     <Tab title="US">
                       ```json theme={}
                       {
                         "mcpServers": {
                           "honeycomb": {
                             "url": "https://mcp.honeycomb.io/mcp"
                           }
                         }
                       }
                       ```
                     </Tab>

                     <Tab title="EU">
                       ```json theme={}
                       {
                         "mcpServers": {
                           "honeycomb": {
                             "url": "https://mcp.eu1.honeycomb.io/mcp"
                           }
                         }
                       }
                       ```
                     </Tab>
                   </Tabs>

        4. Save the configuration file and restart Cursor.

        5. Run this prompt in Cursor and authenticate with Honeycomb when asked:

                   <Prompt description="Set up Honeycomb" icon="sparkle">
                     /honeycomb-setup
                   </Prompt>

        6. Once your agent authenticates, run this prompt to start onboarding:

                   <Prompt description="Begin Honeycomb onboarding" icon="sparkle">
                     /honeycomb-onboarding
                   </Prompt>
      </Accordion>
    </Tab>

    <Tab title="VS Code">
      Connect VS Code to Honeycomb MCP using a one-click install link: [Add Honeycomb to VS Code](vscode:mcp/install?%7B%22name%22%3A%22honeycomb%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.honeycomb.io%2Fmcp%22%7D)
    </Tab>
  </Tabs>
</div>

## Authenticate with an API key

If you are building autonomous or unattended agents and cannot use OAuth, then you can authenticate with an API key.
Only team owners can generate an API key.

<Note>
  Prefer OAuth in most use cases.
  Use an API key only when your agent cannot support interactive login.
</Note>

<Steps titleSize="h3">
  <Step title="Generate an API key in Honeycomb">
    1. Log in to your Honeycomb account.
    2. Navigate to **Account** > **Team Settings** > **API Keys**.
    3. Select **Create Management API Key**.
    4. Name your key (for example, "MCP Integration").
    5. Choose the **Model Context Protocol** and **Environments** scopes, then grant permissions:
       * **Read**: Required for all Honeycomb MCP operations.
         **Be sure to grant read for both MCP and Environments**.
       * **Write**: Required for tools that create or update Honeycomb resources, including Boards, Triggers, SLOs, notification/alert recipients, and Canvas investigations.
         To explore the complete list of write tools, visit the [MCP Tools Reference](/integrations/mcp/tools/#required-scopes-for-write-tools).
    6. Copy the **Key ID** and **Key Secret**, and store them somewhere safe.
       You will need them later, and you won't be able to see them again.
  </Step>

  <Step title="Add your API key to your agent">
    The exact configuration process varies by agent, but here is an example configuration `mcp.json` snippet used by agents like Claude Code or Cursor:

    <Tip>
      Be sure to use the appropriate endpoint for your region, and replace `KEY_ID` and `SECRET_KEY` with your actual key values.
    </Tip>

    ```json theme={}
    {
      "mcpServers": {
        "honeycomb": {
          "command": "npx",
          "args": [
            "-y",
            "mcp-remote",
            "https://mcp.honeycomb.io/mcp",
            "--header",
            "Authorization: Bearer $HONEYCOMB_API_KEY"
          ],
          "env": {
            "HONEYCOMB_API_KEY": "<KEY_ID>:<SECRET_KEY>"
          }
        }
      }
    }
    ```

    <Info>
      Pay attention to formatting, including spacing and colon (`:`) characters.

      If your tool cannot parse the `Authorization` header correctly, try putting the `Bearer` prefix directly in the environment variable:
      `"HONEYCOMB_API_KEY": "Bearer KEY_ID:SECRET_KEY"`.
    </Info>

    As a security best practice, make sure that keys being used for MCP integrations do not carry any other scopes, and that you do not commit them to source control.
  </Step>

  <Step title="Confirm the connection">
    Once connected, test by asking your agent to list available tools or fetch available teams and environments.
    You should get results if your key and permissions are set up correctly.
  </Step>
</Steps>

## Next steps

Continue your MCP journey:

* [Example Use Cases](/integrations/mcp/use-cases): Explore real-world use cases and tips for working with Honeycomb via MCP.
* [Tools Reference](/integrations/mcp/tools): Learn about the tools Honeycomb MCP exposes to AI agents.
* [Troubleshooting](/integrations/mcp/troubleshooting): Fix common MCP configuration and connection issues.