MetricFire MCP Server

oficial

Monitore sua infraestrutura usando linguagem natural com o novo servidor MetricFire Model Context Protocol (MCP). Conecte o MetricFire MCP Server a assistentes de IA como o GitHub Copilot e use prompts simples para pesquisar métricas, visualizar dados, criar alertas e gerenciar seu ambiente de monitoramento, sem escrever chamadas de API.

Ver em hostedgraphite.comExperimente este MCPPatrocinado

O que você pode fazer com MetricFire MCP?

  • Métricas de busca — Peça ao seu assistente para encontrar métricas por padrão ou tags, incluindo métricas ocupadas ou inválidas.
  • Renderizar dados do Graphite — Solicite dados de métricas como JSON, CSV, bruto, PNG ou SVG para um intervalo de tempo especificado.
  • Gerenciar alertas — Crie, atualize, busque, silencie ou exclua alertas, incluindo alertas compostos com lógica AND/OR.
  • Criar dashboards do Grafana — Faça seu assistente criar ou atualizar dashboards e painéis a partir de prompts em linguagem natural.
  • Gerenciar canais de notificação — Recupere, crie, atualize ou exclua canais como Email, Slack, PagerDuty e webhooks.
  • Agendar silêncios — Configure janelas de silêncio recorrentes (ex.: fins de semana) e associe-as a alertas.

Documentação

Para o índice completo da documentação, consulte llms.txt. Versões em Markdown das páginas de documentação estão disponíveis adicionando .md às URLs das páginas; esta página está disponível como Markdown.

MF MCP Server

Conecte assistentes de IA para interagir com a API do Hosted Graphite usando prompts em linguagem natural.

Conteúdo

{% embed url="https://www.youtube.com/watch?t=15s&v=7dIbd2rxARs" %}

O MetricFire MCP Server permite que clientes de IA compatíveis interajam diretamente com sua conta Hosted Graphite usando o Model Context Protocol (MCP).

Uma vez conectados, clientes como GitHub Copilot, Cursor, Claude/Claude Code, etc. podem usar as APIs do Hosted Graphite para descoberta de métricas, renderização Graphite, gerenciamento de alertas, canais de notificação, mutes agendados e outros fluxos de monitoramento.

O servidor MCP opera sobre dados e recursos na sua conta Hosted Graphite. As métricas devem já estar encaminhadas e armazenadas no Hosted Graphite antes de poderem ser pesquisadas, renderizadas ou usadas para alertas.

Criar um Token MCP

Na sua conta Hosted Graphite, navegue até Add-Ons ⇒ MetricFire MCP Server

Crie um token e selecione as permissões necessárias para o seu cliente MCP:

  • Leitura – acessa métricas, renders, alertas, canais de notificação, mutes agendados e outros recursos suportados.
  • Escrita – cria ou modifica recursos suportados.
  • Exclusão – exclui recursos suportados.

Recomendamos usar as permissões mínimas necessárias para o seu fluxo de trabalho.


O token MCP completo é exibido apenas uma vez quando é criado. Armazene-o com segurança antes de sair da página.

Conectar um Cliente MCP

O endpoint MCP do Hosted Graphite é:

https://mcp.hostedgraphite.com/

A configuração varia ligeiramente dependendo do cliente MCP.

GitHub Copilot (VS Code)

Abra a Paleta de Comandos do VS Code e selecione: MCP: Open User Configuration

Adicione o objeto MetricFire MCP Server:

{
  "servers": {
    "mf-mcp-server": {
      "url": "https://mcp.hostedgraphite.com/",
      "headers": {
        "X-HostedGraphite-MCP-Token": "YOUR-MCP-TOKEN"
      }
    }
  }
}

Salve a configuração, inicie o servidor MCP a partir do VS Code e interaja com o agente usando o Copilot Chat.

Cursor, Claude Code, Cline, Windsurf

Esses clientes suportam cabeçalhos HTTP personalizados. Configure o endpoint:

https://mcp.hostedgraphite.com/

e passe seu token:

X-HostedGraphite-MCP-Token: <MF-MCP-TOKEN>

Consulte a documentação MCP do seu cliente para a localização e o formato da configuração do servidor.

Claude

A configuração do navegador/interface do Claude pode se conectar usando o token MCP na URL do servidor:

https://<MF-MCP-TOKEN>@mcp.hostedgraphite.com

NOTA: Ao usar autenticação baseada em URL, recomendamos fortemente um token somente leitura, a menos que acesso de escrita ou exclusão seja especificamente necessário.

Ferramentas Disponíveis

Após conectar, seu cliente MCP pode descobrir as ferramentas atualmente expostas pelo Hosted Graphite.

Métricas

Ferramentas estão disponíveis para:

  • Pesquisa padrão de métricas (por padrão*)
  • Pesquisa de métricas com tags
  • Métricas ocupadas
  • Métricas inválidas
  • Exclusão de métricas

Graphite Render

A API Graphite Render pode ser consultada através do MCP, com suporte para:

  • JSON
  • CSV
  • Dados brutos
  • PNG
  • SVG

Isso permite que clientes MCP localizem métricas e recuperem ou visualizem seus dados em um intervalo de tempo especificado.

Alertas

Assistentes de IA podem trabalhar com suas métricas do Hosted Graphite para criar alertas compostos significativos usando lógica AND/OR, facilitando o alerta sobre problemas no nível de serviço em vez de limites de métricas individuais.

Por exemplo: “Encontre as métricas relevantes de CPU, memória, disco e rede para meus servidores de produção e crie um alerta composto que me envie um e-mail quando múltiplos sinais indicarem um problema no nível de serviço.”

As ferramentas de alerta suportam:

  • Criar e atualizar alertas
  • Pesquisar e recuperar alertas
  • Excluir alertas
  • Silenciar e reativar alertas
  • Status e histórico de alertas
  • Critérios de alertas compostos usando lógica AND/OR

Dashboards

Clientes de IA podem referenciar métricas armazenadas na sua conta Hosted Graphite e usá-las para construir, atualizar e gerenciar dashboards do Grafana usando prompts em linguagem natural. Em vez de pesquisar métricas manualmente, criar painéis e configurar visualizações um por um, você pode pedir ao seu assistente de IA para construir um dashboard em torno de um serviço, host, aplicação ou componente de infraestrutura que deseja monitorar.

Por exemplo: “Encontre as métricas relevantes de CPU, memória, disco e rede para meus servidores de produção e construa um dashboard abrangente de visão geral da infraestrutura.”

As ferramentas de dashboard suportam:

  • Criar dashboards do Grafana
  • Atualizar dashboards existentes
  • Pesquisar e recuperar dashboards
  • Excluir dashboards
  • Criar e configurar painéis de dashboard
  • Usar métricas do Hosted Graphite para construir dashboards a partir de prompts em linguagem natural

{% embed url="https://www.youtube.com/watch?v=jzkK_87fi0Q" %}

Canais de Notificação

Clientes MCP podem trabalhar com canais de notificação do Hosted Graphite (Email, Slack, PagerDuty, MS Teams, webhooks, etc.), incluindo recuperar canais e associá-los a alertas. Dependendo das permissões do token, canais suportados também podem ser criados, atualizados ou excluídos.

Mutes Agendados

As ferramentas de mute agendado permitem que clientes MCP criem e gerenciem janelas de silenciamento recorrentes (por exemplo, fins de semana). Mutes agendados são recursos separados que podem ser associados a alertas através da API de Alertas.

Como Funciona

O MetricFire MCP Server fornece uma interface MCP para APIs suportadas do Hosted Graphite. O cliente de IA conectado seleciona a ferramenta MCP apropriada com base na solicitação e a executa usando as permissões associadas ao seu token MCP.

A integração MCP não substitui sua coleta de métricas existente. Continue enviando dados para o Hosted Graphite usando seus agentes, integrações ou protocolos suportados existentes.

Para mais detalhes sobre as APIs subjacentes, consulte a documentação da API do Hosted Graphite e se precisar de ajuda para conectar um cliente MCP, entre em contato conosco em: support@metricfire.com

O MCP não está disponível atualmente para usuários que habilitaram o Add-on do Hosted Graphite no Heroku Marketplace. Entre em contato conosco para saber como migrar suas contas HG do Heroku para uma conta HG dedicada e aproveitar todos os recursos disponíveis, como MCP e Logging.

Instruções do Agente

Esta documentação é publicada com GitBook. GitBook é a plataforma de documentação projetada para que tanto humanos quanto agentes de IA possam ler, navegar e raciocinar sobre conteúdo técnico de forma eficaz. Saiba mais em gitbook.com.

Consultando Esta Documentação

Se você precisar de informações adicionais que não estão diretamente disponíveis nesta página, você pode consultar a documentação fazendo uma pergunta.

Execute uma solicitação HTTP GET na seguinte URL com os parâmetros de consulta ask e goal:

GET https://docs.hostedgraphite.com/add-ons-and-integrations-guide/mf-mcp-server.md?ask=<question>&goal=<user_goal>

ask é a pergunta imediata: deve ser específica, autocontida e escrita em linguagem natural. goal é o que o usuário está tentando alcançar em última instância, o motivo pelo qual precisa da resposta. Compartilhá-lo ajuda o GitBook a fornecer uma resposta melhor e mais relevante. Uma meta é mais útil quando descreve o resultado que o usuário deseja, em vez de reformular a pergunta. Por exemplo, com ask=how do I create an API token, uma meta como automate deployments from our CI pipeline permite que o GitBook adapte a resposta a esse caso de uso.

A resposta conterá uma resposta direta à pergunta e trechos e fontes relevantes da documentação.

Use este mecanismo quando a resposta não estiver explicitamente presente na página atual, você precisar de esclarecimentos ou contexto adicional, ou quiser recuperar seções relacionadas da documentação.