O que é Grafana MCP Server?
O Grafana MCP Server conecta agentes a uma instância do Grafana e ao seu ecossistema. O README lista 129 ferramentas: buscar, resumir e aplicar patches em dashboards; consultar Prometheus, Loki, Tempo, Pyroscope e várias fontes de dados SQL e de nuvem; gerenciar regras de alerta, silenciamentos e pontos de contato; e trabalhar com Grafana Incident e OnCall. Quarenta delas, incluindo as ferramentas de administração, de consulta de painéis, de SQL e do Grafana Assistant, ficam desligadas até serem habilitadas.
Instale com uvx mcp-grafana e defina GRAFANA_URL e um token de conta de serviço. Ele funciona com Grafana auto-hospedado 9.0 ou posterior e com o Grafana Cloud, roda como binário, em Docker ou via Helm, sobre stdio, SSE ou Streamable HTTP, e chegou à versão 2.1.1 em 20 de outubro de 2026.
Clientes do Grafana Cloud também têm uma opção hospedada em https://mcp.grafana.com/mcp, que usa OAuth 2.1 e age com as permissões do usuário conectado. Cada pessoa que se conecta dessa forma conta como um usuário ativo do Grafana Assistant para fins de cobrança.
Como instalar Grafana MCP Server
uvx mcp-grafanaGrafana MCP Server vale a pena?
Para engenheiros de plantão, este servidor permite que um agente vá de um alerta ao dashboard relevante, à consulta PromQL, às linhas de log e ao trace em uma só conversa, e depois verifique quem está de plantão e adicione uma nota ao incidente. Com 129 ferramentas por toda a stack, a cobertura dos produtos da própria Grafana é quase completa.
O gerenciamento de contexto é o que o faz funcionar na prática. O get_dashboard_summary e o get_dashboard_property com uma expressão JSONPath devolvem só as partes do dashboard de que o agente precisa, e a ferramenta de patch edita sem reenviar o JSON inteiro; o README indica onde alguma ferramenta ainda devolve payloads grandes. Quarenta ferramentas vêm desativadas por padrão, então uma instalação nova oferece cerca de 89, e não tudo.
Os controles de permissão são mais finos do que a média. O --disable-write remove as ferramentas de escrita e também remove query_sql e query_influxdb, porque elas executam o que receberem e poderiam apagar uma tabela se as credenciais da fonte de dados permitirem. O --disable-query mantém só as ferramentas de descoberta, e o --loki-enforced-matchers acrescenta filtros fixos de label a toda consulta ao Loki, um contorno para a falta de controle de labels por usuário no Loki de código aberto. Dois padrões merecem atenção: a imagem Docker inicia em modo SSE em 0.0.0.0:8000 e só registra um erro se nenhum token de chamador estiver definido, e estatísticas de uso anônimas vão para a Grafana Labs a cada quatro horas, a menos que sejam desativadas.
O servidor hospedado do Grafana Cloud muda a questão de compra, não a de engenharia. Ele elimina a configuração de tokens e limita o acesso ao RBAC de cada usuário, mas toda pessoa que se conecta conta como usuário ativo de IA, mesmo que nunca use os recursos de IA do Assistant. Três vêm com a taxa de plataforma de US$ 19 do Pro e cada um a mais começa em US$ 20 por mês, então uma escala de plantão de 20 engenheiros acrescenta cerca de US$ 340 por mês que o servidor executado por você evita.
Onde ele se destaca
Uma SRE de plantão em uma empresa de 50 engenheiros com Grafana auto-hospedado
Descobrir por que a latência do checkout disparou às 02:00
O agente encontra o dashboard do serviço, roda query_prometheus e query_loki_logs no intervalo, puxa o trace correspondente do Tempo e rascunha uma nota de incidente. Uma conta de serviço Viewer com --disable-write o mantém só de leitura, e o servidor não custa nada.
Um gerente de engenharia no Grafana Cloud Pro
Dar a 12 engenheiros acesso de agente aos dados de observabilidade sem distribuir tokens
Aponte o Claude Code ou o Cursor para https://mcp.grafana.com/mcp; cada engenheiro autoriza no navegador e mantém o próprio RBAC. Os nove engenheiros além dos três incluídos custam a partir de US$ 180 por mês como usuários ativos de IA.
Um engenheiro de plataforma organizando uma configuração de alertas barulhenta
Encontrar regras de alerta instáveis e silenciá-las ou reajustá-las em lote
O alerting_rules_read lista as regras e seus estados, o alerting_silences_write cria silenciamentos e o alerting_rules_write atualiza os limites. Habilite as ferramentas de escrita só para essa tarefa, com uma conta de serviço restrita a alertas.
Antes de decidir
- Configuração
- Crie um token de conta de serviço do Grafana e adicione uvx mcp-grafana com GRAFANA_URL e GRAFANA_SERVICE_ACCOUNT_TOKEN ao Claude Desktop, Cursor ou VS Code; em minutos você faz a primeira busca de dashboard. Usuários do Grafana Cloud podem, em vez disso, rodar claude mcp add grafana --transport http https://mcp.grafana.com/mcp e entrar.
- Integrações
- 129 ferramentas, cerca de 89 ativas por padrão: dashboards, pastas, fontes de dados, Prometheus, Loki, Tempo, Pyroscope, alertas, Incident, OnCall, anotações, snapshots, renderização de painéis, busca na documentação e uma ferramenta bruta grafana_api_request. Grupos opcionais acrescentam CloudWatch, Elasticsearch, InfluxDB, SQL e Agent Observability.
- Dados e privacidade
- O acesso equivale ao papel da conta de serviço no Grafana, ou ao RBAC do usuário no servidor hospedado. O grafana_api_request pode chamar qualquer API HTTP do Grafana que o token permita e contorna a imposição de labels do Loki, a menos que --disable-api esteja definido. As linhas de log devolvidas ao modelo são texto não confiável.
- Custo em escala
- O servidor executado por você é gratuito; suas consultas acrescentam carga ao Prometheus e ao Loki e, no Grafana Cloud, às faturas baseadas em uso. Usuários do MCP hospedado contam como usuários ativos de IA: 3 incluídos na taxa de plataforma de US$ 19 do Pro, depois a partir de US$ 20 cada por mês, com 40M de tokens por usuário.
- Limites
- Exige Grafana 9.0 ou posterior. O get_dashboard_by_uid ainda inunda o contexto em dashboards grandes. O servidor hospedado só funciona com o Grafana Cloud, exige aceitar os termos do Assistant e suporta Streamable HTTP, mas não SSE.
O que é bom
- 129 ferramentas para dashboards, métricas, logs, traces, alertas e plantão
- Ferramentas de resumo e JSONPath mantêm os dashboards fora do contexto
- Modos somente leitura e sem consultas, além de imposição de labels no Loki
- Opção hospedada com OAuth para o Grafana Cloud
O que não é
- A imagem Docker escuta em 0.0.0.0 sem token de chamador por padrão
- O servidor hospedado cobra cada usuário conectado a partir de US$ 20 por mês
- As ferramentas de Incident, OnCall e Assistant exigem os respectivos plugins
- Estatísticas de uso ativadas por padrão
Ideal para
Equipes de SRE e de plataforma no Grafana ou no Grafana Cloud que querem a ajuda de um agente durante investigações.
Alternativas ao Grafana MCP Server
Grafana MCP Server: perguntas frequentes
- Grafana MCP Server vale a pena?
- A Grafana pensou mais do que a maioria dos fornecedores em tamanho de contexto e permissões, e o resultado é um servidor que um engenheiro de plantão pode deixar conectado durante um incidente inteiro. Damos nota 4.3 de 5.
- Quanto custa Grafana MCP Server?
- Servidor executado por você gratuito (Apache-2.0). O MCP hospedado do Grafana Cloud conta cada usuário como um usuário ativo de IA do Assistant: 3 incluídos na taxa de plataforma de US$ 19 do Pro, depois a partir de US$ 20 por usuário por mês.
- Quais são as desvantagens de Grafana MCP Server?
- A imagem Docker escuta em 0.0.0.0 sem token de chamador por padrão; o servidor hospedado cobra cada usuário conectado a partir de US$ 20 por mês; as ferramentas de Incident, OnCall e Assistant exigem os respectivos plugins; estatísticas de uso ativadas por padrão.
- Para quem Grafana MCP Server é indicado?
- Equipes de SRE e de plataforma no Grafana ou no Grafana Cloud que querem a ajuda de um agente durante investigações.
- Quanto custa Grafana MCP Server para uma equipe ou em produção?
- O servidor executado por você é gratuito; suas consultas acrescentam carga ao Prometheus e ao Loki e, no Grafana Cloud, às faturas baseadas em uso. Usuários do MCP hospedado contam como usuários ativos de IA: 3 incluídos na taxa de plataforma de US$ 19 do Pro, depois a partir de US$ 20 cada por mês, com 40M de tokens por usuário.
- Grafana MCP Server é seguro para dados da empresa?
- O acesso equivale ao papel da conta de serviço no Grafana, ou ao RBAC do usuário no servidor hospedado. O grafana_api_request pode chamar qualquer API HTTP do Grafana que o token permita e contorna a imposição de labels do Loki, a menos que --disable-api esteja definido. As linhas de log devolvidas ao modelo são texto não confiável.
- Quais são as melhores alternativas ao Grafana MCP Server?
- As alternativas mais próximas que analisamos são Sentry MCP e ClickHouse MCP Server.
Respostas verificadas em 22 de out. de 2026.