Grafana MCP: primeiro liste fontes de dados; não puxe de cara um dashboard grande inteiro

Para quem

Para quem já tem uma instância Grafana 9.0 ou mais nova e quer que um modelo veja a instância e o ecossistema em volta (dashboards, fontes). A evidência afirma: este MCP dá acesso a uma instância Grafana e ao ecossistema ao redor.

Você precisa fornecer GRAFANA_URL e um token de conta de serviço GRAFANA_SERVICE_ACCOUNT_TOKEN. Abaixo de 9.0, algumas funções (sobretudo de fontes) podem faltar por ausência de APIs.

A evidência não lista clientes e não escreve a maioria dos nomes de função das ferramentas. Na primeira vez, só leitura: não ative panel query (desligado por padrão) e não use o exemplo localhost:3000 tal qual em produção.

Primeira tentativa em 3 minutos

Siga o caminho principal uvx. No cliente configure:

"command": "uvx",
"args": ["mcp-grafana"],
"env": {
  "GRAFANA_URL": "http://localhost:3000",
  "GRAFANA_SERVICE_ACCOUNT_TOKEN": "<your service account token>"
}

Troque a URL pela sua instância e o token por um token de conta de serviço. Não os escreva na conversa.

Pré-requisitos: Grafana ≥ 9.0 alcançável; a conta de serviço tem permissão para listar fontes ou ler dashboards. Esta chamada vai ao seu Grafana com o token; não é um sandbox sem rede.

Onde configurar: command / args / env do MCP do cliente.

Primeira chamada de baixo risco: primeiro «listar e obter informações de fontes» (capacidade da evidência). Não puxe primeiro um dashboard grande inteiro por UID. As ferramentas Run panel query vêm desligadas; não acrescente runpanelquery a --enabled-tools só para a primeira tentativa.

Sinal de sucesso: após conectar, você vê a lista de fontes configuradas. Em 401 ou sem conexão, confira primeiro URL e token, e se a instância é ≥ 9.0.

Casos de uso

Caso 1: ver quais fontes a instância tem. Use «List and fetch datasource information». A evidência afirma tipos suportados incluindo Prometheus, Loki, ClickHouse, CloudWatch, Elasticsearch, OpenSearch, Snowflake, Athena. Não dá nomes de função nem filtros. O que se confirma: fontes configuradas e seus detalhes.

Caso 2: obter o detalhe completo de um dashboard por UID. A evidência avisa: dashboards grandes consomem muita janela de contexto. Escolha um cujo UID você conheça e que não seja enorme; se o retorno for longo demais, pare em «a evidência já avisou do consumo de contexto» — não puxe o volume completo de novo. A evidência não traz o locator de uma ferramenta de corte JSONPath; não invente nome substituto.

Limites de uso

É preciso Grafana 9.0+, GRAFANA_URL e token de conta de serviço. runpanelquery vem desativado e só executa panel query depois de ativado. Trazer um dashboard inteiro por UID pode estourar o contexto. Tipos de fonte: só os acima. Sem undo, sem tabela completa de nomes, sem menor privilégio do token. Acessar Grafana e fontes não é risco zero: o que a conta de serviço vê, o modelo vê. «Listar fontes em somente leitura» não significa «sem rede» nem «sem nomes de métricas sensíveis».