Claude Media
Honeycomb MCPは移行が必須に — 自己ホスト版はアーカイブ済み
Claude CodeMCPClaude連携チュートリアル

Honeycomb MCPは移行が必須に — 自己ホスト版はアーカイブ済み

自己ホスト版Honeycomb MCP(honeycomb-mcp)がアーカイブされ、ホスト型mcp.honeycomb.ioへの移行が必須になりました。Claude Codeの接続手順と、認証方式・ツール数の変化をまとめます。

読了目安 約16分

観測データ基盤Honeycombが提供していた自己ホスト版のMCPサーバーhoneycomb-mcpは、GitHub上でアーカイブ済みになりました。ローカルでNodeプロセスを起動する運用は終わり、Honeycombが管理するホスト型サーバーhttps://mcp.honeycomb.io/mcpへの接続が移行先です。コマンドは1行で済みますが、認証方式とツールの数が変わるため、単純な置き換えでは済みません。

自己ホスト版のHoneycomb MCPに何が起きたか

honeycombio/honeycomb-mcpリポジトリは2024年12月に公開され、2025年8月21日の更新を最後にアーカイブされています。READMEの冒頭には「この自己ホスト版MCPサーバーは非推奨です」という警告が残り、ホスト型ドキュメントへの移行を案内する形になりました。

READMEによれば、自己ホスト版はサーバー自体が認証されず、広い権限のAPIキーを渡して使う設計でした。ローカルで動く分、外部からの侵入経路は限られます。一方で、キーが漏れれば全操作が可能という設計でもありました。

移行で変わるのは接続方法だけではない

実行場所・認証・使える機能のいずれも別物になります。

くらべる

自己ホスト版とホスト型の違い

honeycomb-mcp

自己ホスト版

  • 自分のマシンで動くローカルプロセス
  • 認証なし。APIキーを環境変数で渡す
  • Honeycomb Enterpriseの顧客向け
  • 読み取り中心(クエリ・SLO・Trigger閲覧)
mcp.honeycomb.io

ホスト型

  • Honeycombが運用するリモートサーバー
  • OAuthまたはAPIキー(Bearer)
  • Honeycomb Intelligenceを有効にしたチームが対象
  • ツール一覧表に34個。書き込み系はmcp:writeスコープが必要
  • MCPセッションは24時間で切れることがある

ホスト型でも、get_service_map(サービス間の呼び出し依存関係のスナップショット)にはEnterpriseのバッジが付いています。Enterprise限定だった縛りが全面的に外れたわけではなく、機能ごとに条件が分かれる形です。

ホスト型Honeycomb MCPへ接続する

接続前に、HoneycombチームでHoneycomb Intelligenceが有効になっている必要があります。無効だと、認証できてもツールが見えない症状になりがちです。この設定はTeam Ownerに依頼します。

手順

Claude Codeで接続するまで

  1. 1

    Honeycomb Intelligenceの有効化を確認する

    Team Ownerが有効化したチームでないと、以降の手順を踏んでもツールが並びません。

  2. 2

    MCPサーバーを追加する

    自然文で頼むか、claude mcp addで登録します。EUリージョンはmcp.eu1.honeycomb.ioを使います。

  3. 3

    ブラウザで認証する

    Honeycombへのサインインと権限の許可を済ませれば、接続完了です。

自然文で頼む場合、Claude CodeがMCPサーバーを追加してOAuth認証を開始します。

Add the Honeycomb MCP server at https://mcp.honeycomb.io/mcp and authenticate with OAuth.

手動なら次のコマンドです。

claude mcp add honeycomb --transport http https://mcp.honeycomb.io/mcp

--transport httpを付け忘れるとどうなるか

v2.1.289のclaude mcp add --helpは、ホスト型の接続に関わる部分を次のように表示します。

claude mcp add --help
Usage: claude mcp add [options] <name> <commandOrUrl> [args...]
  -H, --header <header...>     Set headers for HTTP/SSE servers (e.g. -H
                               "X-Api-Key: abc123" -H "X-Custom: value")
  -s, --scope <scope>          Configuration scope (local, user, or project)
                               (default: "local")
  -t, --transport <transport>  Transport type (stdio, sse, http). Defaults to
                               stdio if not specified.

トランスポートの既定はstdioで、--transport httpを省くと第2引数のURLがローカルで起動するコマンドとして扱われます。リモートのHoneycombを指すURLなのに接続できないときは、まずこのフラグを確かめます。登録先のスコープは既定でlocal(現在のプロジェクトだけ)です。チームで共有する場合は--scope projectを使います。

Claude Desktopとプラグイン経由の接続

Claude Desktopでは、Customize、Connectors、Browse Connectorsの順に進み、Honeycombコネクタを追加してサインインします。ブラウザが開かないときは、Claude Desktopを完全に終了してから開き直します。

Honeycombはエージェント向けのスキル集も別リポジトリ(honeycombio/agent-skill)で配布しています。Claude Codeのプラグインとして入れると、READMEによれば/honeycomb-setupコマンドでMCPサーバーの設定を対話的に進められます。

claude plugin marketplace add honeycombio/agent-skill
claude plugin install honeycomb

ツールを絞ってコンテキストを節約する

既定では、34個のツールとプロンプトがすべて読み込まれます。Honeycombの接続設定では、リクエストにX-MCP-Toolsetヘッダーを付けると読み込む範囲を絞れます。queryはBoard・Trigger・SLOを含むクエリ系のツールとプロンプト、canvasはCanvas用のツールだけです。allが既定です。Claude Codeでは--headerで付けられます。

claude mcp add honeycomb --transport http https://mcp.honeycomb.io/mcp \
  --header "X-MCP-Toolset: query"

このヘッダーは読み込みを絞るだけで、権限は与えません。値が空だったり未知の値だったりすると、Honeycomb MCPはそのヘッダーを含むリクエストをすべて拒否します。書き間違えたときは、ヘッダーを直すか外すまで接続が使えない点に注意します。

OAuthが使えないときはAPIキーで接続する

CIやスケジュール実行のように対話的なOAuthが使えない場合は、APIキー認証に切り替えます。Honeycombの公式手順では、Team Ownerだけがキーを発行できます。Account、Team Settings、API Keysの順に開き、「Create Management API Key」を選びます。スコープはModel Context ProtocolとEnvironmentsに付けます。Readは両方に必須で、Writeは書き込み系ツールを使うときだけ付けます。

mcp-remote経由でBearerトークンとして渡す設定例です。

{
  "mcpServers": {
    "honeycomb": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.honeycomb.io/mcp",
        "--header",
        "Authorization: Bearer $HONEYCOMB_API_KEY"
      ],
      "env": {
        "HONEYCOMB_API_KEY": "<KeyID>:<SecretKey>"
      }
    }
  }
}

キーは<Key ID>:<Secret Key>の形式で、コロンが必須です。ヘッダー側のBearerでうまく解釈されないクライアントでは、環境変数の値をBearer <Key ID>:<Secret Key>にする方法が公式に挙がっています。キーにはMCP以外のスコープを付けず、ソース管理に入れないことも手順に明記されています。

増えたツールで何ができるようになったか

新設されたget_workspace_contextは、チーム名・現在時刻・環境ごとのデータセット数を返すツールです。リファレンスには「エージェントが最初に呼んで状況を把握する」と書かれており、環境名を知らないままrun_queryを撃つ失敗を減らします。

自己ホスト版は、クエリとSLO・Triggerの監視という「数値を見る」用途が中心でした。ホスト型は、そこにトレース単位の調査を足しています。get_traceは特定のトレースIDのスパンを組み立てます。list_spansとget_span_detailsは、どのスパン名がよく現れ、どの属性を持つかを探索するためのツールです。集計では見えない、1件のリクエストが詰まった場所まで追えるのが実質的な差です。

調査の保存先も増えました。create_boardとupdate_boardでBoardを作成・編集でき、クエリ・SLO・テキストのパネルの追加や並べ替えも対象です。canvas_agent_invokeはCanvas調査を始め、canvas_agent_poll_responseが結果を取りに行きます。チャットが終わると消えていた調査過程を、チームで見返せる形に残せます。

Trigger・SLO・通知先も、作成・更新までMCPで扱えます。自己ホスト版はSLOとTriggerの閲覧が中心でした。書き込み系はすべてmcp:writeスコープが必要で、OAuthでは同意画面で許可し、APIキーではWriteを付けて発行します。

セキュリティ面では、Activity Log EnvironmentをMCP経由で参照できるのはTeam Ownerだけです。他のロールのメンバーは、UIでは見られてもエージェント経由では見られません。

利用シーン別にどのツールが効くか

すべてのツールを覚える必要はありません。役割ごとに、触る一群が決まります。

早見

シーン別のツール

  • 障害調査(SRE・オンコール)

    get_trace、list_spans、run_bubbleup。トレース単位まで潜る調査系です。

  • 日常のクエリ・ダッシュボード運用

    run_query、find_queries、list_boards。クエリの実行と検索、Boardの一覧です。

  • アラート設計

    get_triggers、create_trigger、list_recipients。Triggerの取得と作成、通知先の一覧です。

  • 計装(instrumentation)

    search_semconv、get_semconv_attribute。OpenTelemetryのセマンティック規約を、チーム固有のWeaverレジストリ込みで引けます。

自動化に組み込むなら、レート制限の粒度も設計に効きます。リファレンスの表では、既定が毎分50回で、ツールごとに次のように分かれます。

ツール毎分の上限
search_semconvなど意味規約の検索、canvas_agent_poll_response毎分の上限300
get_workspace_context、list_boards、find_columnsなど毎分の上限200
get_triggers、find_queries、get_query_results毎分の上限150
run_query、get_trace、get_slos毎分の上限100
update_trigger、update_slo毎分の上限30
create_trigger、create_slo、canvas_agent_invoke毎分の上限20
get_service_map毎分の上限10

OAuthの上限はユーザー単位で、そのユーザーの全セッションで共有されます。APIキーの上限は、そのキーのリクエスト全体にかかります。超過時のエラーには再試行できる時刻が含まれます。

Claude Code自身をHoneycombで観測する

ホスト型に移ると、Claude Codeの実行そのものをHoneycombに送り、同じMCPで調べる構成も取れます。トレースは既定で無効で、CLAUDE_CODE_ENABLE_TELEMETRY=1とCLAUDE_CODE_ENHANCED_TELEMETRY_BETA=1の両方を設定し、OTEL_TRACES_EXPORTERで送り先を選びます。エンドポイントはHoneycombのOTLPエンドポイント、APIキーはx-honeycomb-teamヘッダーとしてOTEL_EXPORTER_OTLP_HEADERSに入れます。

Claude Codeのトレースは、ユーザーのプロンプトごとにclaude_code.interactionをルートにし、その下にclaude_code.llm_requestとclaude_code.toolが並びます。claude_code.toolの下には、権限の待ち時間を測るclaude_code.tool.blocked_on_userと、実行時間を測るclaude_code.tool.executionがあります。run_queryで次のような質問を立てられます。

  • 「どのツールの実行が失敗しているか」: claude_code.tool.executionのsuccessと、親スパンのtool_nameを使います
  • 「権限プロンプトでどれだけ待たされたか」: claude_code.tool.blocked_on_userのduration_msとdecision(acceptかreject)を集計します
  • 「トークンを使ったリクエストはどれか」: claude_code.llm_requestのinput_tokensとoutput_tokensを見ます

注意したいのはlist_aiconversationsとget_aiconversationです。Honeycombのリファレンスでは、これらはgen_ai.conversation.idの値ごとに会話を一覧するツールです。Claude Codeの公式ドキュメントには、Claude Codeがgen_ai.usage.*属性を設定しないとあります。トークン量はgen_ai.usage.input_tokensではなく、input_tokensで記録されます。Claude Codeの自己観測では、会話単位のツールは属性名が合わない可能性が高いです。run_queryでclaude_code.*のスパンを直接集計するほうが向いています。

よくあるつまずき

  • ツールが1つも表示されない: 認証は成功しているのに何も呼べないなら、多くはHoneycomb Intelligenceが無効です。Team Ownerに有効化を頼みます。個人の認証設定では直りません
  • APIキー認証が拒否される: <Key ID>:<Secret Key>のコロンの抜け、Bearerの位置、キーの期限切れや無効化を疑います。ヘッダーにBearerを含める形と、環境変数に含める形のどちらかに揃えます
  • OAuthの認証が不安定: クライアントによって挙動が異なるとされ、改善中として、サポートチケットかPollinators Slackコミュニティへの報告が案内されています
  • Unauthorizedが出る: OAuthなら、Honeycombアカウントの「Integrations」タブでセッションにmcp:readスコープがあるか見ます。APIキーなら、キーIDとシークレットの両方を確かめます
  • 急にツールが失敗し始める: MCPのセッションは24時間で切れることがあります。新しいチャットで再接続します
  • Rate limit exceeded: 上の表のツール別上限を超えています。エラー文の再試行時刻まで待ちます。頻発するならプランの見直しが案内されています
  • mcp:writeの操作だけ失敗する: OAuthは同意画面で書き込みを許可していないと、APIキーはWriteを付けていないと、書き込み系ツールが使えません。キーの環境アクセスに、書き込む環境も含めます
  • 無認証だった頃の感覚でOAuth画面に戸惑う: ホスト型でブラウザの認証画面が挟まるのは、仕様どおりです。APIキーだけで済ませたい場面では、APIキー認証を選びます

移行の判断

アーカイブされたリポジトリは更新されないため、手元のプロセスが動いている間も、API側の変更で壊れたときに直されません。Honeycomb Intelligenceを有効にしたうえで、まずclaude mcp add1行とOAuthで試し、CIなど対話できない場面だけAPIキーに切り替える進め方になります。

MCP接続の--transportオプションやスコープ管理の詳細はClaude Code MCP設定ガイドにあります。Claude Code自体のOpenTelemetry出力を設定していないなら、Claude CodeのOpenTelemetryで利用量とコストを可視化が前提の設定手順です。MCPのHost/Client/Server構造はMCPアーキテクチャの三層構造で整理されています。

この記事を共有:XはてブLinkedIn

関連する記事

Claude Code をもっと見る →