assistant-mcp

Grafana Cloud MCP サーバーのセットアップ

Grafana MCP サーバーは、AI エージェントが Model Context Protocol 経由で呼び出せるツールとして、Grafana Cloud の機能を提供します。エージェントはコーディング環境を離れることなく、メトリクスのクエリ、ダッシュボードの検索、アラートの管理、インシデントの調査、Fleet Management とのやり取りを行えます。

トランスポート：stdio（エージェントがサーバーをサブプロセスとして起動する、最も簡単な方法）、または SSE（サーバーが独立して実行され、エージェントが HTTP 経由で接続します。詳しくはreferences/sse-transport.mdを参照してください）。

よくあるワークフロー

Claude Code を Grafana に接続する（stdio）

# 1. Install the server
go install github.com/grafana/mcp-grafana/cmd/mcp-grafana@latest

# 2. Verify the binary
mcp-grafana --version
# If "command not found": ensure $GOPATH/bin (or $HOME/go/bin) is on PATH.

3. サービスアカウントトークンを取得する：Grafana Cloud → Administration → Service Accounts の順に移動し、Viewer ロールで作成します（書き込みが必要な場合に限り、Editor を追加します）→ トークンを生成します。Grafana の URL（例：https://myorg.grafana.net）を控えてください。

4. ~/.claude/settings.json（またはプロジェクトローカルの .claude/settings.json）を設定する：

   {
     "mcpServers": {
       "grafana": {
         "command": "mcp-grafana",
         "args": ["--disable-write"],
         "env": {
           "GRAFANA_URL": "https://myorg.grafana.net",
           "GRAFANA_API_KEY": "glsa_xxxx"
         }
       }
     }
   }
   

   --disable-write を指定するのがより安全なデフォルトです。読み取りが正常に動作することを確認したら、指定を外してください。

5. Claude Code を再起動して、動作を確認する：

   /mcp
   

   grafana サーバーとそのツール一覧が表示されます。次に、以下のように尋ねてください。

   What data sources are configured in my Grafana instance?
   

   正常な応答があれば動作しています。ツール呼び出しに失敗した場合：

   • GRAFANA_URL の末尾にスラッシュがないことを確認します
   • API キーの有効期限が切れていないことを確認します
   • mcp-grafana --debug を指定して再実行し、リクエストとレスポンスの生データを確認します

Cursor を接続する

同じ Grafana トークンを使用します。Settings → Features → MCP Servers の順に移動するか、~/.cursor/mcp.json を編集します。

{
  "mcpServers": {
    "grafana": {
      "command": "mcp-grafana",
      "args": ["--disable-write"],
      "env": {
        "GRAFANA_URL": "https://myorg.grafana.net",
        "GRAFANA_API_KEY": "glsa_xxxx"
      }
    }
  }
}

同じ方法で動作を確認します。Cursor ではエージェントパネルに MCP サーバーが表示されます。「kubernetes タグが付いたダッシュボードを一覧表示して」のようなクエリを実行してください。

チームでサーバーを共有する（SSE）

stdio から SSE に切り替えると、サーバーを一度起動するだけで、多数のエージェントが接続できます。VS Code の設定を含むセットアップ全体については、references/sse-transport.mdを参照してください。

セキュリティに関する考慮事項

• API キーは環境変数またはシークレットマネージャーに保存してください。コミット対象のファイルに記載しないでください。
• 共有環境と CI では --disable-write を使用してください。Grafana の変更をエージェントに許可する特定のマシンでのみ、この設定を解除してください。
• サービスアカウントの権限は必要最小限にしてください。クエリとダッシュボードの読み取りには Viewer で十分です。エージェントにダッシュボードやアノテーションを作成させる場合に限り、Editor を付与してください。
• Administration → Service Accounts から、定期的にトークンをローテーションしてください。

参考資料

• references/tools.md — 公開されている MCP ツールの全一覧（クエリ／ダッシュボード／アラート管理／Fleet Management／アノテーション）と、実際に利用可能なツールの確認方法
• references/sse-transport.md — チーム共有と VS Code 向けの SSE セットアップ。stdio と SSE の選択基準、およびよくある障害の原因を含みます
• references/a2a.md — Grafana Assistant に推論を委任するための Agent-to-Agent（A2A）プロトコル（MCP による直接のツール呼び出しとの比較）

外部リソース

• Grafana MCP サーバー（github.com/grafana/mcp-grafana）
• Model Context Protocol の仕様
• Grafana Cloud API ドキュメント
• Grafana Assistant のドキュメント