Servidor MCP Grafana

Consultar dashboards, fontes de dados, alertas e incidentes de um Grafana.

Oficial do fornecedorLocal · uvxmantido por Grafana Labs

O que é

Servidor da Grafana Labs para uma instância local ou do Grafana Cloud. Usa um token de conta de serviço, e as ferramentas disponíveis dependem das permissões desse token.

Exemplos de pedidos

“Quais alertas dispararam nas últimas 24 horas?”
“Mostre a consulta do painel de latência do dashboard API.”

Antes de instalar

Requer uv (uvx).

Sinais de confiança

Quem mantém: Oficial do fornecedor Grafana LabsMantido pela empresa dona do serviço ao qual o servidor se conecta.
Repositório: grafana/mcp-grafana
Licença: Apache-2.0
Último commit: 06/10/2026 (no dia da coleta)
Estrelas: 3,5 mil
Registro oficial: Entrada não conferida por nós no registro oficial
Transporte: Local (stdio), iniciado com uvx
O que você preenche: GRAFANA_URL — Endereço da instância do Grafana
GRAFANA_SERVICE_ACCOUNT_TOKEN — Token de conta de serviço do Grafanacredencial
Configuração conferida: 03/10/2026, no README do repositório

Estrelas, licença e último commit: API do GitHub, retrato incluído nesta versão do site, coletado em 07/10/2026. Situação no registro: registry.modelcontextprotocol.io, na mesma data.

Configurar o Grafana em cada cliente

Sem token nesta página. O que está destacado você preenche na sua máquina. Para combinar com outros servidores ou gerar a versão para Windows, use o gerador com o Grafana já marcado.

claude_desktop_config.json~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "grafana": {
      "command": "uvx",
      "args": [
        "mcp-grafana"
      ],
      "env": {
        "GRAFANA_URL": "<GRAFANA_URL>",
        "GRAFANA_SERVICE_ACCOUNT_TOKEN": "<GRAFANA_SERVICE_ACCOUNT_TOKEN>"
      }
    }
  }
}

GRAFANA_URL: Substitua <GRAFANA_URL> pelo valor, direto no arquivo, na sua máquina.
GRAFANA_SERVICE_ACCOUNT_TOKEN: Substitua <GRAFANA_SERVICE_ACCOUNT_TOKEN> pelo valor, direto no arquivo, na sua máquina. É uma credencial: não versione nem compartilhe o arquivo depois de preenchido.

Onde fica o arquivo e como conferir no Claude Desktop

ComandosTerminal, na pasta do projeto

claude mcp add --transport stdio --env "GRAFANA_URL=<GRAFANA_URL>" --env "GRAFANA_SERVICE_ACCOUNT_TOKEN=<GRAFANA_SERVICE_ACCOUNT_TOKEN>" grafana -- uvx mcp-grafana

GRAFANA_URL: Substitua <GRAFANA_URL> pelo valor, direto no comando, na sua máquina.
GRAFANA_SERVICE_ACCOUNT_TOKEN: Substitua <GRAFANA_SERVICE_ACCOUNT_TOKEN> pelo valor, direto no comando, na sua máquina. É uma credencial: não versione nem compartilhe o arquivo depois de preenchido.

Onde fica o arquivo e como conferir no Claude Code

mcp.json.cursor/mcp.json

{
  "mcpServers": {
    "grafana": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-grafana"
      ],
      "env": {
        "GRAFANA_URL": "<GRAFANA_URL>",
        "GRAFANA_SERVICE_ACCOUNT_TOKEN": "${env:GRAFANA_SERVICE_ACCOUNT_TOKEN}"
      }
    }
  }
}

GRAFANA_URL: Substitua <GRAFANA_URL> pelo valor, direto no arquivo, na sua máquina.
GRAFANA_SERVICE_ACCOUNT_TOKEN: Defina a variável de ambiente GRAFANA_SERVICE_ACCOUNT_TOKEN no sistema. O arquivo guarda só a referência ${env:GRAFANA_SERVICE_ACCOUNT_TOKEN}.

Onde fica o arquivo e como conferir no Cursor

mcp.json.vscode/mcp.json

{
  "inputs": [
    {
      "type": "promptString",
      "id": "grafana-service-account-token",
      "description": "Token de conta de serviço do Grafana",
      "password": true
    }
  ],
  "servers": {
    "grafana": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-grafana"
      ],
      "env": {
        "GRAFANA_URL": "<GRAFANA_URL>",
        "GRAFANA_SERVICE_ACCOUNT_TOKEN": "${input:grafana-service-account-token}"
      }
    }
  }
}

GRAFANA_URL: Substitua <GRAFANA_URL> pelo valor, direto no arquivo, na sua máquina.
GRAFANA_SERVICE_ACCOUNT_TOKEN: O VS Code pede este valor em uma caixa de senha na primeira vez que o servidor inicia.

Onde fica o arquivo e como conferir no VS Code

mcp_config.json~/.config/devin/mcp_config.json

{
  "mcpServers": {
    "grafana": {
      "command": "uvx",
      "args": [
        "mcp-grafana"
      ],
      "env": {
        "GRAFANA_URL": "<GRAFANA_URL>",
        "GRAFANA_SERVICE_ACCOUNT_TOKEN": "${env:GRAFANA_SERVICE_ACCOUNT_TOKEN}"
      }
    }
  }
}

GRAFANA_URL: Substitua <GRAFANA_URL> pelo valor, direto no arquivo, na sua máquina.
GRAFANA_SERVICE_ACCOUNT_TOKEN: Defina a variável de ambiente GRAFANA_SERVICE_ACCOUNT_TOKEN no sistema. O arquivo guarda só a referência ${env:GRAFANA_SERVICE_ACCOUNT_TOKEN}.

Onde fica o arquivo e como conferir no Windsurf

O que ele alcança

O que a conta de serviço puder ver e alterar: dashboards, consultas às fontes de dados, alertas, incidentes.

Riscos e como reduzir

Com papel Editor, o assistente altera dashboards e incidentes. Comece com Viewer; o servidor também aceita --disable-write.

Contexto geral em Segurança no MCP. Código-fonte: github.com/grafana/mcp-grafana.

Outros servidores de nuvem e operações

Perguntas frequentes

O servidor Grafana é oficial?

Oficial do fornecedor: é mantido por Grafana Labs, no repositório grafana/mcp-grafana. Mantido pela empresa dona do serviço ao qual o servidor se conecta.

Que credenciais o Grafana pede?

GRAFANA_SERVICE_ACCOUNT_TOKEN (token de conta de serviço do grafana). O gerador deste site não recebe esse valor: ele entra na sua máquina, no lugar do marcador.

Como o Grafana é executado?

É um servidor local, iniciado com uvx (exige uv). O cliente inicia o processo sozinho quando abre.

O Grafana funciona no Cursor, no VS Code e no Claude Code?

Sim. Esta página traz o bloco de configuração para Claude Desktop, Claude Code, Cursor, VS Code e Windsurf, cada um no formato do cliente.

Quando esta configuração foi conferida?

Em 03/10/2026, no README do repositório grafana/mcp-grafana. Se o comando mudar depois disso, vale o que o repositório publicar.