Grafana
Connect Grafana Cloud so agents can query your dashboards, metrics, logs, alerts, and incidents.
The Grafana Cloud MCP server lets agents read and work with your Grafana stack while they debug.
For use cases and example prompts, see Grafana for AI coding agents.
What is Grafana?
Grafana is an observability platform for dashboards, metrics, logs, traces, and alerts.
What agents can do
Once you connect Grafana, agents can:
- Search dashboards and read their panels and queries
- List data sources and query metrics and logs with PromQL and LogQL
- Check alert rules, on-call schedules, and incidents
- Change dashboards, annotations, alerts, incidents, and data sources, if you allow it when you sign in
Setup
Grafana connects by signing in with your Grafana account. There's no API key to create, and its MCP server doesn't accept Grafana service account tokens. It only works with Grafana Cloud.
Grafana counts each connected user as a Grafana Assistant active user for billing.
Go to Workspace Settings → Connectors (or a project's Connectors page) and click Connect on the Grafana card (or Connect another to add another account).
Step 1: who the connection is for
Choose Me or Workspace as the owner, then choose which agents can use the connection. The default is Me, with My personal assistants selected. Enable Agents in projects separately and choose In all projects, including future ones or In some projects. Anyone with access to those projects can use the connection, including in sessions they launch themselves. See connection options for what each choice means.
Click Continue.
Step 2: sign in with Grafana
- Click Continue to Grafana.
- Enter your Grafana URL, such as
myorg.grafana.net, and click Continue. Sign in if Grafana asks. - On Authorize MCP access, choose what agents can do, then click Allow access.
You land back on the Connectors page with Grafana connected.
Agents then act in Grafana as whoever signed in, so they see exactly what that person can. If you enable In projects, anyone with access to those projects can use that account — so sign in with an account whose permissions you're happy to share.
Reconnecting and disconnecting
If an account connection stops working, the Connectors page shows a Reconnect needed badge on it, and agents run without Grafana.
To fix it, click Manage next to the connection, then Reconnect Grafana, and sign in again. You can only reconnect a personal connection you own; for someone else's, Superconductor tells you who to ask.
Grafana has no way for Superconductor to revoke access, so Disconnect only removes the connection from Superconductor. To end the access, in Grafana, go to AI → Settings → MCP clients and click Revoke next to Superconductor under Your connections. If your stack doesn't show AI, see Grafana's revoke access steps.
When to use it
Ask agents to use Grafana when a ticket involves production metrics, logs, dashboards, or alerts. For example:
Find the Grafana dashboard for the checkout service and tell me which panels look at error rate.Query the last hour of logs in Grafana for this error message and link what you find to the code that logs it.