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, your agent runs Honeycomb’s onboarding prompt (/honeycomb-onboarding), which walks through sending sample data, instrumenting your app for real telemetry, or picking up a pipeline you are already running.
  3. Let your agent do the rest: If you choose real instrumentation, your agent adds OpenTelemetry instrumentation, verifies events are arriving, and can hand off to Canvas for deeper analysis.
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, using sample data, real instrumentation, or data you are already sending. 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.

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.
  • Troubleshooting: Fix common MCP configuration and connection issues.