Grafana / Grafana Cloud
Claude Codeに渡せる権限の範囲と、つなぎ方を、公式の資料から読み取れる範囲でまとめました。
← ラボ / Claude Code ガイド / 連携台帳
Grafana Labs・監視・運用・海外 公式サイト
ダッシュボード、メトリクス・ログ・トレース、アラート、インシデント管理(IRM)などを扱うオープンソースのGrafanaと、そのクラウド版Grafana Cloud。公式がMCPサーバー(OSS版 mcp-grafana と Grafana Cloud のホスト型MCP)とCLI(gcx)を公開している。
Claude Codeに、どこまで権限を渡せるか
- 読み取り専用で渡せるか あり
- ①Grafana Cloudのホスト型MCP(https://mcp.grafana.com/mcp、OAuth 2.1): 同意画面でアクセスレベルを選ぶ。Read(ダッシュボード・アラート・インシデント・メトリクス・ログ・トレースの閲覧)/Query(生SQLの実行。'execute as written and can modify data')/Write(ダッシュボード・アラート・インシデント・Assistant調査の作成/変更。Query・Readを含む)。読み取り専用にするには WriteとQueryの両方のチェックを外してReadだけにする(Writeだけ外してもQueryが残ると生SQLは可能)。公式 https://grafana.com/docs/grafana-cloud/ai-tools/mcp-servers/cloud-mcp/ ②OSS版 mcp-grafana: --disable-write で『preventing any write operations』。README上、delete_snapshot、alerting_manage_rules の削除、Agent Observability ツールの削除も無効になる対象に含まれる。https://github.com/grafana/mcp-grafana ③gcx: 専用の読み取り専用モードなし。ViewerロールのサービスアカウントトークンやRBACカスタムロールを使う。
- 権限(スコープ)を選べるか あり
- ホスト型MCP: Read / Query / Write の3段階(OAuth同意画面)、書き込みツールは grafana:write スコープが必要。利用には Assistant Cloud MCP User ロール(または grafana-assistant-app.cloud-mcp:access 権限。Editor以上は既定で保有)が必要。OSS版: カテゴリ単位の --disable-<category>、サービスアカウントにRBACスコープを付けて最小権限にすることをREADMEが推奨。公式ドキュメントはEditorロールを『broad read/write』の簡易案として挙げる。
- 危険な操作の既定
- ホスト型MCP: Writeは同意画面で選ぶ項目。Organization Adminは既定で書き込みを付与できる、それ以外はAssistant Adminロールが必要な場合あり。確認プロンプトの記載は読めた範囲になし。OSS版: 書き込み・削除は既定で有効(--disable-write で無効化)。CLI(gcx): resources delete に確認プロンプトなし、種類のみ指定の削除は --force が必要で一致するもの全てを削除しうる。--dry-run で事前確認できる。
- 削除ができるか できる
- OSS MCP: alerting_manage_rules の削除、delete_snapshot、Agent Observability(evaluators / eval rules / collections)の削除。ホスト型MCPのドキュメントは『No tools are marked as delete』相当で、Write表示は update_dashboard / create_folder / alerting_manage_rules(作成・更新) / annotation / incident / investigation / ask_assistant。CLI: gcx resources delete、gcx api -X DELETE。ダッシュボード削除後の復元の有無は記載なし。
- 取り消し方(キー・接続)
- ホスト型MCP: スタックの Settings → Connectors → MCP clients → Your connections で接続を取り消す。OAuthトークンは1時間有効で30日間自動更新、30日後は再認可。サービスアカウントトークン・Cloud Access Policyトークンの取り消し手順は未確認。
つなぎ方(公式の資料にある範囲)
公式MCP あり
【Grafana Cloud ホスト型MCP】公式ドキュメント https://grafana.com/docs/grafana-cloud/ai-tools/mcp-servers/cloud-mcp/ に記載。エンドポイントは https://mcp.grafana.com/mcp(スタック別は /mcp/<stack>.grafana.net)、Streamable HTTPのみ、OAuth 2.1。同意画面でアクセスレベルを Read/Query(生SQL。「can modify data」と記載)/Write から選ぶ。利用には Assistant Cloud MCP User ロール(Editor以上は既定で保有)が必要で、MCP接続者は Grafana Assistant の課金上アクティブユーザーとして数えられる。GA/プレビューの記載はなし。【OSS版】grafana/mcp-grafana(Apache-2.0)。Grafanaインスタンス(Grafana Cloud含む)に接続するMCPサーバー。ダッシュボード検索・取得・更新、データソース問い合わせ(Prometheus, Loki, ClickHouse ほか多数)、インシデント、Sift調査、アラートルール、OnCall、アノテーション、スナップショット、管理(チーム・ユーザー・ロール)、Assistant などのカテゴリ。書き込み例: update_dashboard(作成/更新)、alerting_manage_rules(作成/更新/削除)、create_incident、add_activity_to_incident、create_annotation / update_annotation、create_snapshot / delete_snapshot。--disable-write で書き込みツールを無効化。カテゴリは --disable-<category> で個別に無効化でき、--enabled-tools の既定は admin など一部を除く全カテゴリ。Grafana 9.0以降が必要。 README後半に、--disable-write の対象に delete_snapshot、alerting_manage_rules の delete、Agent Observability ツールの delete が含まれると記載。Sift の find_error_pattern_logs / find_slow_requests(調査を作成)、agento11y_manage_evaluators / _eval_rules / _eval_collections も書き込み対象。OnCall・silences についての言及はなし。
つなぎ方(公式の記載)
ホスト型: エンドポイント https://mcp.grafana.com/mcp にOAuthで接続(公式ドキュメントの記載。ホスト型用のClaude Codeコマンドは読めていない)。OSS版: Quick Start は uvx mcp-grafana(Claude Desktop/Cursor向け)。環境変数 GRAFANA_URL と GRAFANA_SERVICE_ACCOUNT_TOKEN を設定。READMEにClaude Code向けの手順はないが、公式ドキュメントにClaude Code用ページ https://grafana.com/docs/grafana-cloud/ai-tools/mcp-servers/oss-mcp/clients/claude-code/ があり、`claude mcp add-json "grafana" '{"command":"mcp-grafana",…,"env":{"GRAFANA_URL":…}}'` の形で登録し、読み取り専用にするには args に "--disable-write" を入れる。
公式CLI あり
gcx(grafana/gcx、Apache-2.0、READMEバッジは Generally Available)。Grafana/Grafana Cloudのリソースを扱うCLIで「Optimized for agentic usage」。gcx resources でダッシュボード・フォルダ等の pull/push/validate/edit/delete、gcx api で生API(-X DELETE 含む)、gcx irm incidents create のようなCloud製品コマンド。旧CLI grafanactl は「being deprecated」で gcx に置き換え、リポジトリは2026-06-01にアーカイブ予定と記載(READMEの記載。現在の状態は未確認)。
公式API あり
Grafana HTTP API(Admin, Alerting Provisioning, Annotations, Dashboard Versions, Data source, Folder/Dashboard Search, RBAC, Service account, Snapshot, Team, User など。ページのタグは Enterprise / Open source / Grafana Cloud)。Grafana 13から /api は /apis ルートへ移行(非推奨化)すると記載。
第三者製MCP(公式ではない) 2件
- DrDroidLab/grafana-mcp-server(作者: DrDroidLab(GitHub組織)・最終更新: 未確認)
書き込み・削除: 書き込みツールなし: 10ツールすべて取得・クエリ系(grafana_promql_query ほか)。読み取り専用モードの記載なし(READMEは Viewer 権限のサービスアカウントを案内)。
MIT。最終コミット日はページに表示されず(未確認)。
https://github.com/DrDroidLab/grafana-mcp-server - christian-schlichtherle/grafana-mcp(作者: christian-schlichtherle(個人アカウント)・最終更新: 未確認)
書き込み・削除: 書き込み・削除あり: create/update/copy/delete_dashboard、create/update/delete_folder(README)。読み取り専用フラグの記載なし。GRAFANA_LABELS / GRAFANA_FOLDER で変更対象を制限できる。
MIT。最終コミット日はページに表示されず(未確認)。
https://github.com/christian-schlichtherle/grafana-mcp
第三者製のMCPは、サービスの運営元が作ったものではありません。作者と中身を確かめてから使うかどうかを決めてください。ここに載せているのは、公式のレジストリやGitHubで見つかったものを、書かれている範囲でまとめたもので、おすすめではありません。
探した場所(4件)
- GitHub検索(WebSearch、github.com限定)
- 公式MCPレジストリ(registry.modelcontextprotocol.io)と modelcontextprotocol/servers は開いていない
- https://github.com/DrDroidLab/grafana-mcp-server
- https://github.com/christian-schlichtherle/grafana-mcp
できる操作
読み取りでできる操作
- 【MCP】ダッシュボード検索・取得・要約、データソースへのクエリ(Prometheus, Loki, InfluxDB, ClickHouse, CloudWatch ほか)、アラートルール・OnCallスケジュール・アラートグループの参照、スナップショット、PNGレンダリング
- 【CLI】gcx resources の pull、ダッシュボード/フォルダの読み取り(Viewer権限のサービスアカウントトークンで足りると記載)
- 【API】HTTP APIの参照系(個別エンドポイントは未読)
- 【ホスト型MCP】Read: ダッシュボード・アラート・インシデント・メトリクス・ログ・トレースの閲覧
書き込みでできる操作
- 【MCP】update_dashboard(ダッシュボードの作成/更新)、alerting_manage_rules(アラートルールの作成/更新)、create_incident / add_activity_to_incident、create_annotation / update_annotation、create_snapshot
- 【MCP】Agent Observability・Assistant の一部ツールにも書き込みあり(--disable-write 時はAssistantツールがスキップされると記載)
- 【CLI】gcx resources push / edit、gcx irm incidents create など
- 【API】作成・更新系エンドポイント(未読)
- 【ホスト型MCP】Write: ダッシュボード・アラート・インシデント・Assistant調査の作成/変更(Query・Readを含む)。Query: 生SQLの実行(「can modify data」と記載)
- 【MCP(OSS)】Sift の find_error_pattern_logs / find_slow_requests(調査を作成)、agento11y_manage_evaluators / _eval_rules / _eval_collections は --disable-write の対象(README)
管理者操作(削除・課金・設定変更など)
- 【MCP(OSS)】削除: alerting_manage_rules(アラートルールの削除)、delete_snapshot、Agent Observability の削除。いずれも --disable-write の対象とREADMEに記載。チーム・ユーザー・ロール管理のadminカテゴリは既定の有効カテゴリから外れている(--enabled-tools の既定の説明)
- 【CLI】gcx resources delete(ダッシュボード、フォルダなど)。確認プロンプトなし。名前指定の削除は --force 不要、種類だけ指定(例: dashboards)は --force が必要で一致するもの全てを削除しうる。--dry-run で事前確認できる。gcx api -X DELETE も可
- 【API】HTTP APIにAdmin / RBAC / Service account などのAPIがある(個別の削除操作は未読)
- 【ホスト型MCP】削除ツールとして示されたものはない(再確認時の読み取り。ドキュメントの原文の逐語は未確認)。Write表示は update_dashboard / create_folder / alerting_manage_rules(作成・更新) / annotation / incident / investigation / ask_assistant
制限
- Grafana 9.0以降で全機能(mcp-grafana README)
- Agent Observabilityのツールは Grafana Cloudでのみ動作
- gcx: Grafana 13以降(OSS/Enterprise)とGrafana Cloudが完全サポート、12.xは積極サポート外、12未満は非対応
- Grafana 13 から /api は /apis へ移行中(非推奨化)。現行のAPIは引き続き使えると記載
- 旧CLI grafanactl は非推奨・公開プレビュー・サポートSLAなしと記載
- ホスト型MCP: Streamable HTTPのみ。MCP接続者は Grafana Assistant の課金上アクティブユーザーとして数えられる。トークンは1時間有効・30日で自動更新、30日後は再認可(公式ドキュメント)
- gcx resources delete は確認プロンプトなし。種類だけを指定すると一致するものを全て削除しうる(--force が必要)。--dry-run で先に確認できる
- MCPの update_dashboard は既存ダッシュボードを更新できる。バージョン履歴(Dashboard Versions API)の存在は一覧にあるが、MCP経由の更新を元に戻せるかは未確認
- READMEは削除系(delete_snapshot、alerting_manage_rules の delete、Agent Observabilityの delete)も --disable-write の対象と記載。ただしインシデント作成・アノテーション作成が --disable-write で止まるかは断定できていない
- ホスト型MCPの Query は生SQLを実行でき、「can modify data」と記載。読み取り専用にするには Write と Query の両方を外して Read だけにする(Writeだけ外しても Query が残ると生SQLは実行できる)
認証・料金・日本語・実機検証
- 認証方式
- 【MCP】Grafanaのサービスアカウントトークン(GRAFANA_SERVICE_ACCOUNT_TOKEN)。READMEは最小権限のためRBACスコープの利用を推奨。【CLI】gcx login(Grafana CloudのブラウザOAuth、またはサービスアカウントトークン)。Cloud製品コマンド(SLO、Synthetic Monitoring、IRMなど)はCloud Access Policyトークンも必要。環境変数 GRAFANA_SERVER / GRAFANA_TOKEN / GRAFANA_CLOUD_TOKEN。【API】サービスアカウントトークン等(詳細は未読) 【ホスト型MCP】OAuth 2.1(トークンは1時間有効・30日自動更新)。Assistant Cloud MCP User ロールが必要。
- 公表されている料金(2026年10月16日確認)
- Grafana Cloud: Free $0/Pro プラットフォーム料金 月額 $19 + 従量課金/Enterprise 年額 $25,000 の最低利用額(公式料金ページ、通貨コードの記載なし、2026-10-16確認)。従量の例: メトリクス 1,000シリーズあたり $6.50、Visualization 有効ユーザー1人 $8、IRM有効ユーザー1人 $20。Freeの枠はメトリクス1万アクティブシリーズ・ログ50GB等。OSS版Grafanaの料金は読んでいない。MCPサーバー自体の個別料金は記載なし(FAQ見出しにgcx/MCPのトークン消費の質問があるが回答は読めず)。 料金ページ
- 日本語対応
- あり。あり(日本語サイトのみ確認。ドキュメントは未確認)。https://grafana.com/ja/ が日本語のマーケティングページとして存在する。日本語のドキュメント・管理画面は未確認。
- Claude Code実機検証
- 未検証(この台帳は、動かして確かめた記録ではありません。Akiraが試したときは、検証日つきで書き換えます)
確認できていない点(7件)
- mcp-grafana README の OnCall・silences の書き込み扱い(README後半に言及なし)、ホスト型MCP用のClaude Codeコマンド、ホスト型MCPのGA/プレビュー区分(記載なし)
- HTTP APIの認証方式・削除エンドポイント・ごみ箱/復元
- サービスアカウントトークン・Cloud Access Policyトークンの取り消し方(ホスト型MCPの接続は Settings → Connectors → MCP clients → Your connections で取り消せると記載)
- 日本語のドキュメント・管理画面の有無
- OSS版・Enterprise版の料金
- 第三者製MCPの最終更新日。公式MCPレジストリ・modelcontextprotocol/servers は未参照
- grafana-cli(サーバー管理用)は未確認
出典(9件)
- mcp-grafana README(GitHub grafana)(確認日 2026-10-16)
- gcx README(GitHub grafana)(確認日 2026-10-16)
- grafanactl README(GitHub grafana)(確認日 2026-10-16)
- HTTP API(Grafana Docs)(確認日 2026-10-16)
- Pricing(Grafana Labs)(確認日 2026-10-16)
- Grafana Cloud MCP(Grafana Docs)(確認日 2026-10-16)
- mcp-grafana を Claude Code で使う(Grafana Docs)(確認日 2026-10-16)
- DrDroidLab/grafana-mcp-server(GitHub)(確認日 2026-10-16)
- christian-schlichtherle/grafana-mcp(GitHub)(確認日 2026-10-16)
この台帳は、公式の資料を読んだ範囲のことで、動かして確かめたものではありません。確認日: 2026年10月16日。
ラボの資料は、公式の文書を読んでまとめたもので、実際に使って確かめた記録ではありません。日付や仕様は変わるので、使う前に各ページの出典で確かめてください。事実と「僕らの見立て」は、分けて書いています。