Cara menambahkan Grafana MCP ke Claude Code

5 menit baca.
Tags: AIClaude Code

Grafana MCP server membuat Claude Code bisa mencari dashboard, menjalankan query PromQL dan LogQL, serta membaca alert rule dan incident dari instance Grafana kamu. Untuk memasangnya kamu butuh service account token dan satu command claude mcp add, tanpa login lewat browser.

Command cepat

claude mcp add grafana \
  -e GRAFANA_URL=https://myinstance.grafana.net \
  -e GRAFANA_SERVICE_ACCOUNT_TOKEN=glsa_your_token \
  -- uvx mcp-grafana

Server Datadog, PagerDuty, dan Sentry adalah endpoint hosted yang diakses lewat login di /mcp. Grafana MCP server (mcp-grafana) berbeda. Ia jalan di mesin kamu lewat stdio dan memanggil API Grafana memakai token yang kamu berikan. Karena itu di sini tidak ada --transport http dan tidak ada langkah OAuth.

Untuk Grafana self-hosted, ganti URL dengan milik kamu, misalnya http://localhost:3000. Server ini butuh Grafana 9.0 ke atas. Di versi yang lebih lama, tool datasource gagal karena API /datasources/uid/{uid} belum ada.

Taruh nama server sebelum -e

Kalau urutannya terbalik, command gagal:

# fails
claude mcp add -e GRAFANA_URL=https://myinstance.grafana.net grafana -- uvx mcp-grafana
Invalid environment variable format: grafana, environment variables should be added as: -e KEY1=value1 -e KEY2=value2

-e menerima lebih dari satu nilai, jadi grafana ikut dianggap sebagai environment variable lain. Taruh nama tepat setelah add, lalu flag -e, lalu -- dan command-nya. Semua yang ada setelah -- diteruskan ke mcp-grafana, bukan ke Claude Code.

Buat service account token

Di Grafana, buka Administration → Users and access → Service accounts, buat service account, lalu tambahkan token ke dalamnya. Token Grafana diawali glsa_.

Role menentukan apa yang boleh dilakukan Claude. Viewer mencakup sebagian besar tool baca: mencari dashboard, query datasource, dan membaca alert rule. README mcp-grafana menyarankan Editor kalau kamu tidak mau repot mengatur RBAC yang detail, sambil mengakui bahwa role itu kurang ketat dibanding permission yang di-scope. Kalau kamu cuma mau Claude melihat-lihat, kasih Viewer dan jalankan server dalam mode read-only (lihat di bawah).

Install mcp-grafana

Command cepat di atas memakai uvx, yang mengambil mcp-grafana dari PyPI dan menjalankannya setiap kali Claude Code menyalakan server. Kamu perlu menginstall uv dulu. Kalau tidak mau pakai uv, ada dua pilihan lain.

Pakai binary dari halaman releases, atau build sendiri dengan Go:

go install github.com/grafana/mcp-grafana/v2/cmd/mcp-grafana@latest

Perhatikan /v2 di module path. Setelah itu arahkan Claude Code ke binary-nya:

claude mcp add grafana \
  -e GRAFANA_URL=https://myinstance.grafana.net \
  -e GRAFANA_SERVICE_ACCOUNT_TOKEN=glsa_your_token \
  -- mcp-grafana

Atau pakai Docker:

claude mcp add grafana -- docker run --rm -i \
  -e GRAFANA_URL=https://myinstance.grafana.net \
  -e GRAFANA_SERVICE_ACCOUNT_TOKEN=glsa_your_token \
  grafana/mcp-grafana -t stdio

Image Docker-nya secara default jalan dalam mode SSE, jadi -t stdio wajib ada, dan -i menjaga stdin tetap terbuka supaya Claude Code bisa berkomunikasi dengannya. Karena -e di sini ada setelah --, flag itu milik docker run, bukan Claude Code.

Cek apakah sudah jalan

claude mcp get grafana

Lalu tanyakan sesuatu yang kamu tahu pasti ada:

List my Grafana dashboards in the Production folder.

Kalau nama dashboard yang asli muncul, berarti token dan role-nya benar. Status Connected cuma menandakan Claude Code berhasil menjalankan prosesnya, jadi coba satu pertanyaan sungguhan sebelum kamu percaya.

Mode read-only

Tambahkan --disable-write setelah command untuk membuang semua tool yang membuat atau mengubah data, seperti update dashboard, perubahan alert rule, dan pembuatan incident:

claude mcp add grafana \
  -e GRAFANA_URL=https://myinstance.grafana.net \
  -e GRAFANA_SERVICE_ACCOUNT_TOKEN=glsa_your_token \
  -- uvx mcp-grafana --disable-write

Kamu juga bisa membuang tool yang tidak dipakai, sekaligus menghemat context, dengan --disable-<category>, misalnya --disable-oncall. Beberapa kategori memang mati secara default, di antaranya cloudwatch, elasticsearch, admin, dan runpanelquery. Untuk menyalakannya pakai --enabled-tools. Flag ini menggantikan daftar default, jadi sertakan juga kategori lain yang masih kamu perlukan.

Jangan simpan token di config

claude mcp add menulis token sebagai teks biasa ke ~/.claude.json. Supaya token tetap ada di environment shell saja, pakai add-json dengan placeholder:

export GRAFANA_SERVICE_ACCOUNT_TOKEN=glsa_your_token

claude mcp add-json grafana '{"type":"stdio","command":"uvx","args":["mcp-grafana"],"env":{"GRAFANA_URL":"https://myinstance.grafana.net","GRAFANA_SERVICE_ACCOUNT_TOKEN":"${GRAFANA_SERVICE_ACCOUNT_TOKEN}"}}'

Tanda kutip tunggal membuat ${GRAFANA_SERVICE_ACCOUNT_TOKEN} tetap berupa placeholder, lalu Claude Code mengisinya dari environment kamu saat menjalankan server. Kalau kamu menjalankan claude mcp get grafana, yang tampil adalah placeholder-nya, bukan nilai token.

Versi ini juga yang cocok di-commit kalau satu tim mau memakai server Grafana yang sama. Tambahkan -s project dan config masuk ke .mcp.json tanpa token siapa pun di dalamnya.

Troubleshooting

Kalau claude mcp get grafana menampilkan "Failed to connect" dengan ENOENT: Executable not found in $PATH: "mcp-grafana", Claude Code tidak menemukan binary-nya. Pakai path lengkap, misalnya ~/go/bin/mcp-grafana, atau install uv lalu pakai uvx mcp-grafana.

Kalau server tersambung tapi tool call mengembalikan 401 atau 403, cek token dan role service account. Token yang sudah dihapus atau expired juga menghasilkan error yang sama.

Kalau tool datasource gagal dengan 404, cek versi Grafana. Di bawah 9.0, API yang dipakai tool itu belum ada.

Untuk log yang lebih detail, tambahkan -debug di args server. Flag ini mencatat setiap HTTP request dan response antara mcp-grafana dan API Grafana.

Secara default, server ini juga mengirim statistik pemakaian anonim ke Grafana Labs, misalnya tool apa yang dipanggil dan berapa yang gagal. Menurut README, query, baris log, dan credential tidak pernah dikirim. Untuk mematikannya, tambahkan -e GRAFANA_USAGE_STATS=disabled.

Referensi

Setup MCP on-call lain di blog ini: Datadog, PagerDuty, dan Sentry.

Urutan setup singkat

Buat service account token di Grafana, lalu jalankan claude mcp add grafana -e GRAFANA_URL=... -e GRAFANA_SERVICE_ACCOUNT_TOKEN=... -- uvx mcp-grafana, dengan nama server sebelum flag -e. Tambahkan --disable-write kalau mau akses read-only, dan minta Claude menampilkan dashboard yang asli untuk memastikan token-nya jalan.