インストール不要。2分以内に動きます。
cloud.anythingmcp.com で無料トライアルを開始し、Grafana をワンクリックで追加して、AI クライアント(Claude、ChatGPT、Copilot、Cursor)を生成された MCP エンドポイントに向けるだけ。Docker も git clone も、開発経験も不要です。
概要
AI が Grafana を読み取れるようにします。ダッシュボードを検索してパネルとクエリを確認し、Prometheus、Loki、SQL のデータソースにクエリを実行し、発火中のアラートとルールの定義を確認し、アノテーションを読み取って追加し、コンタクトポイント、ユーザー、チームを一覧できます。Grafana Cloud とセルフホストの Grafana の両方で動作します。
こう聞いてみよう
Grafana のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Grafana をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要。
Grafana + ChatGPT
AI が Grafana を読み取れるようにします。ダッシュボードを検索してパネルとクエリを確認し、Prometheus、Loki、SQL のデータソースにクエリを実行し、発火中のアラートとルールの定義を確認し、アノテーションを読み取って追加し、コンタクトポイント、ユーザー、チームを一覧できます。Grafana Cloud とセルフホストの Grafana の両方で動作します。
前提条件
完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:
GRAFANA_URL, GRAFANA_SERVICE_ACCOUNT_TOKEN
ステップ 1 — 認証情報を取得
GRAFANA_URLに、Grafana を開くときのアドレスを末尾のスラッシュなしで設定します。Grafana Cloud ではhttps://your-stack.grafana.net、独自のアドレスならhttps://grafana.example.comのようになります(Grafana がパスの下で動いている場合はhttps://example.com/grafana)。AnythingMCP Cloud では、インスタンスにインターネットからアクセスできる必要があります。- Grafana で Administration → Users and access → Service accounts を開き、Add service account をクリックして、名前(たとえば AnythingMCP)とロール Viewer を設定します。
- サービスアカウントを開いて Add service account token をクリックし、有効期限を選んでトークンをコピーします。トークンは
glsa_で始まり、Grafana は一度しか表示しません。 - Bearer という語を付けずに
GRAFANA_SERVICE_ACCOUNT_TOKENに貼り付け、コネクタをインストールします。トークンが届くのは、サービスアカウントが属する組織だけです。 grafana_get_current_orgで設定を確認します。トークンに対応する組織が表示されます。grafana_get_healthはトークンがなくても応答するため、Grafana のバージョンはわかりますが、トークンが機能していることの証明にはなりません。
どのロールにするか: Viewer で、ダッシュボード、フォルダー、データソース、クエリ、アラートルール、発火中のアラート、アノテーション、コンタクトポイントをカバーできます。ユーザーとチームの一覧には Admin、アノテーションの追加には Editor が必要です。Grafana Cloud と Grafana Enterprise では、サービスアカウントが読み取る各データソースに対するクエリ権限も必要です。
できること: ダッシュボードとフォルダーを検索し、ダッシュボードのパネルを PromQL、LogQL、SQL のクエリとともに読み取ります。Grafana 経由で Prometheus(または Mimir)、Loki、SQL のデータソースにクエリを実行します。今どのアラートが発火しているか、そのルールがどう定義されているか、どのコンタクトポイントに通知が届くかを確認します。グラフ上でデプロイやインシデントを示すアノテーションを読み取ります。組織のユーザーとチームを一覧します。
変更は 1 つだけ、AI は先に確認します: コネクタが変更できるのは、grafana_create_annotation によるアノテーションの追加だけで、これはダッシュボード上で全員に表示されます。追加の前に、AI はテキスト、時刻、タグを示し、あなたの承認を待ちます。ダッシュボード、データソース、アラートルールを変更する機能はなく、何も削除されません。
シークレットは Grafana に残ります: データソースのパスワードやキーは返されず、コンタクトポイントは Webhook URL やキーを含む設定を除いて返されます。
制限: クエリの応答は約 60 KB で切り詰められるため、AI はクエリ内で集計し(sum、topk、rate)、時間範囲を短く保ちます。新しい v2 スキーマで保存されたダッシュボード(タブや自動グリッドレイアウトを使う Grafana 12 のダッシュボード)は、この API では読み取れない場合があります。その場合、Grafana は新しい API の名前を含むエラーを返します。
よくあるエラー: 401 Invalid API key: トークンが間違っている、期限切れ、または削除されたか、GRAFANA_URL が別のスタックを指しています。403: サービスアカウントのロールが足りない(ユーザーとチームには Admin、アノテーションには Editor)、またはそのデータソースに対するクエリ権限がありません。404: この組織にその uid のダッシュボード、データソース、ルールがないか、GRAFANA_URL のパスが間違っています。クエリでの 400: 式がそのデータソースでは無効です。理由はメッセージに示されます。
このコネクタは、ダッシュボード、データソース、アラートルール、コンタクトポイント、サイレンス、ユーザーの作成や変更を行わず、何も削除せず、Grafana OnCall、Grafana Incident、Grafana Cloud のスタック API には対応していません。
ステップ 2 — アダプターをインストール
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
ステップ 3 — ChatGPT にコネクタを追加
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL(
https://cloud.anythingmcp.com/mcp/…)をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
ChatGPT では、Web 版の Plugins ページから MCP サーバーをプラグインとして追加します。有料プランで利用でき、開発者モードはもう必要ありません。Business ワークスペースで追加できるのは管理者とオーナーだけです。Enterprise・Edu では、管理者が Create plugins with MCPs 権限を付与できます。
- chatgpt.com/plugins を開き、+ をクリックして Add custom MCP server を選びます。
- 名前を入力します(例: Name:
Grafana)。 - Connection の Server URL に
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDを入力し、Authentication は OAuth のままにします。 - I understand and want to continue を選び、Create as a plugin をクリックします。ChatGPT に求められたら AnythingMCP にサインインし、アクセスを許可します。
- 個人用プラグインから新しいプラグインをインストールし、チャットで @ を入力して選択します。
利用可能なツール
| Tool | What it does |
|---|---|
grafana_get_health | Check that the Grafana instance is up: database state, Grafana version and commit |
grafana_get_current_org | Read the Grafana organization the service account token belongs to: id and name |
grafana_search | Search dashboards and folders by title, tag or folder: uid, title, type (dash-db for dashboards, dash-folder for folders), tags, folder and… |
grafana_list_folders | List folders: uid and title, top level by default or the subfolders of a parent |
grafana_get_dashboard | Read a dashboard by uid in a compact form: title, tags, folder, time range, variables (name, type, current value) and panels with id… |
grafana_list_datasources | List the data sources: uid, name, type (prometheus, loki, postgres...), URL, access mode and which one is the default |
grafana_get_datasource | Read one data source by uid: name, type, URL, access mode, default flag and its non-secret settings (jsonData) |
grafana_query_datasource | Run a query against a data source through Grafana and return the result frames: a PromQL query for Prometheus or Mimir, a LogQL query for… |
grafana_list_alert_rules | List the Grafana-managed alert rules: uid, title, folder, rule group, paused or not, pending period (for), labels, summary, what happens on… |
grafana_get_alert_rule | Read one alert rule by uid: title, folder, group, condition, the queries and expressions it evaluates (data source uid, expression, time… |
grafana_list_firing_alerts | List the alert instances in Grafana's Alertmanager, by default the active ones (firing): alert name and labels, summary and description… |
grafana_list_annotations | List annotations (event markers on graphs such as deployments or incidents, and alert state changes): id, time and end time (epoch… |
grafana_create_annotation | Add an annotation (an event marker such as a deployment, incident or maintenance window) that shows on graphs for everyone who opens the… |
grafana_list_org_users | List the users of the organization: user id, login, email, name, role (Viewer, Editor, Admin), last seen and disabled flag |
grafana_search_teams | Search the teams of the organization: id, uid, name, email and member count |
grafana_list_contact_points | List the alerting contact points (where notifications go): uid, name, integration type (email, slack, pagerduty, webhook...) and whether… |
プロンプトの例
- 「Grafana で今発火しているアラートはどれですか?それぞれについて、元になっているルールと、通知を受け取るコンタクトポイントを見せてください。」
- 「API レイテンシのダッシュボードを探して、各パネルが何を表示し、どのクエリを実行しているかを説明してください。」
- 「Prometheus で、直近 1 時間のサービスごとの 5xx レスポンスのレートを調べて、最も状態の悪いサービスを教えてください。」
- 「checkout アプリについて Loki が直近 30 分間に記録したエラー行を見せて、メッセージごとにまとめてください。」
- 「今日の 14:05 に、タグ deploy を付けてアノテーション『Deployed v2.4.1』を追加してください。追加する前にテキスト、時刻、タグを見せてください。」
FAQ
ChatGPT の無料プランでカスタム MCP サーバーは使えますか? OpenAI がカスタム MCP サーバーを案内しているのは有料プランだけで、Free プランは対象に含まれていません。
次のステップ
このガイドは役に立ちましたか?