Skip to main content
Connect any AI agent that supports the Model Context Protocol (MCP) to Honeycomb, then let it instrument your app, generate sample data, or pick up a pipeline you are already sending. This guide walks through how the process works, then gives exact steps for your client.
Just need to connect your agent to Honeycomb for querying, not sending data? Visit Connect to Honeycomb MCP instead.

How it works

Most AI agents follow the same pattern to start sending data to Honeycomb:
  1. Connect to Honeycomb MCP: Some agents connect with a single prompt or one-click link; others need a short setup step first, depending on whether the client supports the Honeycomb plugin or agent skills.
  2. Run guided onboarding: Once connected, you run Honeycomb’s onboarding prompt (/honeycomb-onboarding), which offers three paths: get real data into Honeycomb, send sample data based on your codebase, or analyze data you already send.
  3. Let your agent do the rest: On the real data path, your agent instruments your app if needed, or sets up Honeycomb to receive a copy of the data you already send to Datadog or New Relic. Once your events arrive, your agent helps you start a Canvas investigation.
Auto-instrumentation depends on the Honeycomb plugin or agent skills being installed. Clients that connect through MCP only still complete onboarding, but guide you through instrumentation manually rather than doing it for you.

Before you begin

Make sure that:

Send data by client

For exact setup steps and prompts, select your client:
Send data with Amazon Q Developer using the qchat CLI:
1

Install the Honeycomb MCP

Select your region and run the associated command in your terminal:
2

Onboard with Honeycomb

Run this prompt to start onboarding:

Begin Honeycomb onboarding

Honeycomb opens a browser window to authenticate the first time your agent uses an MCP tool. Grant the requested permissions to finish connecting.Your agent starts guided onboarding against your live Honeycomb account. Amazon Q connects through MCP only, so your agent guides you through manual OpenTelemetry instrumentation rather than auto-instrumentation, which is available on AI tools that support the Honeycomb plugin. To learn what each onboarding path does, visit the honeycomb-onboarding prompt reference.

Next steps

  • Example Use Cases: Explore real-world use cases and tips for working with Honeycomb via MCP.
  • Tools Reference: Learn about the tools Honeycomb MCP exposes to AI agents.
  • Prompts Reference: Learn about the prompts Honeycomb MCP provides, including /honeycomb-onboarding.
  • Troubleshooting: Fix common MCP configuration and connection issues.