Hosted Graphite MCP Server

Hosted Graphite MCP Server とは？

Hosted Graphite MCP Server は、MetricFire が提供する公式のホスト型エンドポイント（https://mcp.hostedgraphite.com/）です。AI アシスタントが Hosted Graphite のメトリクスを検索・描画し、アラート、ミュート、通知チャネル、Grafana ダッシュボードを管理できます。認証には MCP トークンを使います。

Hosted Graphite は、メトリクスに Graphite、ダッシュボードに Grafana を使う MetricFire のマネージド監視サービスです。MetricFire のドキュメントでは、このサーバーを MetricFire MCP Server と呼んでいます。すでに Hosted Graphite にメトリクスを送っている SRE、DevOps エンジニア、開発者が、Claude、Cursor、GitHub Copilot などのアシスタントに自然な言葉でメトリクスの調査、アラートの調整、ダッシュボードの作成を任せるためのものです。

Hosted Graphite MCP Server の使い方

メトリクスがすでに Hosted Graphite に転送されている必要があります。MCP サーバーは既存の収集の仕組みを置き換えるものではありません。次にトークンを作成します。

1. Hosted Graphite のアカウントで Add-Ons ⇒ MetricFire MCP Server を開きます。
2. トークンに必要な権限として Read、Write、Delete から選びます。MetricFire はワークフローに必要な最小限の権限を推奨しています。
3. トークンはすぐにコピーしてください。完全な値は一度しか表示されません。

多くのクライアントは、トークンをヘッダーで送ります。

X-HostedGraphite-MCP-Token: <MF-MCP-TOKEN>

Claude Code

claude mcp add --transport http hosted-graphite https://mcp.hostedgraphite.com/ \
  --header "X-HostedGraphite-MCP-Token: $HOSTEDGRAPHITE_MCP_TOKEN"

Claude Desktop と claude.ai

Claude のブラウザ版やアプリの UI 向けに、MetricFire はトークンを埋め込んだ https://<MF-MCP-TOKEN>@mcp.hostedgraphite.com 形式の URL を案内しており、これをカスタムコネクタの URL として入力します（Settings → Connectors → Add custom connector）。この方法では、書き込みや削除が必要な場合を除き、読み取り専用のトークンを使うよう推奨されています。

Cursor

{
  "mcpServers": {
    "hosted-graphite": {
      "url": "https://mcp.hostedgraphite.com/",
      "headers": {
        "X-HostedGraphite-MCP-Token": "<MF-MCP-TOKEN>"
      }
    }
  }
}

VS Code（GitHub Copilot）

コマンドパレットから MCP: Open User Configuration を実行し、MetricFire のドキュメントのとおり追加します。

{
  "servers": {
    "mf-mcp-server": {
      "url": "https://mcp.hostedgraphite.com/",
      "headers": {
        "X-HostedGraphite-MCP-Token": "YOUR-MCP-TOKEN"
      }
    }
  }
}

保存したら VS Code からサーバーを起動し、Copilot Chat を使います。

Hosted Graphite MCP Server の主な機能

• Hosted Graphite のアカウント向けに MetricFire が提供する公式サーバー。
• Graphite 形式のパターンやタグ式によるメトリクスの検索と、ビジーなメトリクス・無効なメトリクスのレポート。
• 指定した期間のデータやグラフ画像を返す Graphite の render クエリ。
• 複合アラート、ミュート、定期ミュート、アラート履歴を含むアラートの総合管理。
• メール、Slack、PagerDuty、Webhook、VictorOps、Opsgenie の通知チャネル。
• 自然言語のプロンプトからの作成を含む、Grafana ダッシュボードの作成と編集。
• トークンの権限が Read、Write、Delete に分かれており、エージェントが変更できる範囲を制限できる。

Hosted Graphite MCP Server のツール

サーバーは 35 のツールを 6 つのグループで提供しています。

• メトリクス：metric_search はパターン（例：foo.bar.*）でメトリクスを検索し、busy_metrics は最もビジーなメトリクスとそのレート制限の割合を返し、invalid_metrics はパーサーに拒否されたメトリクスを一覧にし、delete_metrics は一致するメトリクスを削除します。
• タグ：list_tags、search_tag_values、find_tagged_series、delete_tagged_series でタグ付きシリーズを扱います。
• 描画：render_graphite は Graphite の render API を照会し、メトリクスのデータやグラフ画像を取得します。
• アラート：create_alert、search_alerts、get_alert、update_alert、delete_alert、mute_alert、unmute_alert、一括操作の mute_alerts と unmute_alerts、get_alert_mute_status、get_alert_history。
• 通知チャネルと定期ミュート：それぞれに作成・検索・取得・更新・削除のツールがあり、create_notification_channel や create_scheduled_mute などがあります。
• ダッシュボード：Grafana 用の create_dashboard、list_dashboards、get_dashboard、update_dashboard、delete_dashboard。

Hosted Graphite MCP Server のユースケース

• インシデントの切り分け：「checkout サービスの過去 6 時間のエラー率メトリクスを見せて」
• アラートの調整：「api.latency.p95 が 5 分間 500 ms を超え続けたらアラートを出して、Slack チャンネルに送るよう設定して」
• メンテナンス時間帯：「データベース関連のアラートを毎週日曜 02:00〜04:00 にミュートするよう予約して」
• ダッシュボードの作成：「prod ホストの CPU、メモリ、ディスクのパネルを含む Grafana ダッシュボードを作って」
• 整理：「無効なメトリクスと最もビジーなメトリクスを一覧にして、ノイズの多い送信元を直せるようにして」

Hosted Graphite MCP Server のトラブルシューティング

• メトリクスが見つからない：検索、描画、アラートに使うには、メトリクスが先に Hosted Graphite に保存されている必要があります。
• 作成や削除で権限エラーになる：トークンが Write や Delete の権限なしで作成されています。必要な権限を付けた新しいトークンを作成してください。
• トークンを紛失した：完全なトークンは一度しか表示されません。Add-Ons ⇒ MetricFire MCP Server で新しいトークンを発行してください。
• Heroku ユーザーが有効にできない：Heroku Marketplace のアドオン経由で作成したアカウントでは MCP サーバーを使えません。専用アカウントへの移行について MetricFire に問い合わせるよう案内されています。