# Grafana

<div style={{maxWidth: '720px'}}>
![The Grafana connector in Workspace Settings, for dashboards, metrics, logs, alerts, and incidents, with a Connect button](</docs/_next/static/media/grafana-connector.29mnho8bo3zg4.jpg>)
</div>

The [Grafana Cloud MCP server](https://grafana.com/docs/grafana-cloud/ai-tools/mcp-servers/cloud-mcp/) lets agents read and work with your Grafana stack while they debug.

For use cases and example prompts, see [Grafana for AI coding agents](/integrations/grafana).

## What is Grafana? [#what-is-grafana]

[Grafana](https://grafana.com) is an observability platform for dashboards, metrics, logs, traces, and alerts.

## What agents can do [#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 [#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](https://grafana.com/docs/grafana-cloud/ai-tools/mcp-servers/cloud-mcp/#billing-and-usage) 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 [#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](/docs/integrations/connectors#fill-in-the-connection-details) for what each choice means.

Click **Continue**.

### Step 2: sign in with Grafana [#step-2-sign-in-with-grafana]

1. Click **Continue to Grafana**.
2. Enter your **Grafana URL**, such as `myorg.grafana.net`, and click **Continue**. Sign in if Grafana asks.
3. 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 [#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](https://grafana.com/docs/grafana-cloud/ai-tools/mcp-servers/cloud-mcp/#revoke-access).

## When to use it [#when-to-use-it]

Ask agents to use Grafana when a ticket involves production metrics, logs, dashboards, or alerts. For example:

```text
Find the Grafana dashboard for the checkout service and tell me which panels look at error rate.
```

```text
Query the last hour of logs in Grafana for this error message and link what you find to the code that logs it.
```