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

# Set up Honeycomb MCP Server

> Connect Honeycomb's hosted MCP server to TrueFoundry using OAuth or a management API key.

Honeycomb's MCP server lets agents query observability data, inspect environments, and analyze traces and logs. It supports per-user OAuth and shared Management API key authentication.

## Prerequisites

* A TrueFoundry account with permission to add MCP servers.
* A Honeycomb team with Honeycomb Intelligence enabled.

## Choose the Endpoint

| Region | URL                                |
| ------ | ---------------------------------- |
| US     | `https://mcp.honeycomb.io/mcp`     |
| EU     | `https://mcp.eu1.honeycomb.io/mcp` |

## Register with OAuth

In **MCP Gateway**, add a remote MCP server with the regional URL and choose **OAuth2**. Add collaborators and save. Users should open the server's **Tools** section and click **Connect Now**; after OAuth succeeds, Honeycomb tools appear and can be tried from the **Agent Playground**.

## Register with a Management API Key

Team owners can create a Management API key under **Account** > **Team Settings** > **API Keys**. Grant **Model Context Protocol: Read** and **Environments: Read**; add **Model Context Protocol: Write** only for tools such as board creation.

In TrueFoundry, configure shared API key authentication and send the key as a bearer token in the format `KEY_ID:SECRET_KEY`.

## Security Notes

OAuth gives the cleanest user attribution. If you use a Management API key, store both the Key ID and Secret Key securely because the secret is shown only once.
