Healthchecks.io MCP

@digitalronin/healthchecks-io-mcp

Não oficial, sem afiliação com Healthchecks.io. Este é um servidor MCP de terceiros, não um produto oficial da Healthchecks.io.

O que é isto

Healthchecks.io é um serviço de monitoramento estilo "interruptor de homem morto": seus jobs agendados (cron jobs, backups, scripts em lote, qualquer coisa que deva rodar em um cronograma) enviam um ping quando executam, e Healthchecks.io alerta você se um ping não chegar na hora — significando que o job falhou silenciosamente ou nunca rodou.

Este pacote é um servidor MCP — um pequeno programa local que permite que um assistente de IA como Claude converse com a Management API do Healthchecks.io em seu nome. Uma vez configurado, você pode pedir ao seu assistente de IA coisas como "liste meus checks do Healthchecks.io", "mostre-me o histórico de pings do meu job de backup", ou "pause o monitoramento do meu ambiente de staging" em inglês simples, e ele chamará o endpoint correto da API do Healthchecks.io para você.

Configuração

1. Obtenha uma chave de API do Healthchecks.io

1. Faça login em healthchecks.io (ou sua instância auto-hospedada, veja abaixo).
2. Vá para a página Configurações do seu projeto e depois para a aba Acesso à API.
3. Você verá duas chaves: uma chave somente leitura e uma chave leitura-escrita.
   • A chave somente leitura pode consultar seus checks, mas não pode criar, alterar, pausar ou excluir nada.
   • A chave leitura-escrita pode fazer tudo que a chave somente leitura pode, além de criar, atualizar, pausar, retomar e excluir permanentemente checks.

2. Adicione este servidor à configuração do seu cliente MCP

Você não precisa instalar nada manualmente — npx baixará e executará automaticamente na primeira vez que for usado. Adicione este bloco à configuração do seu cliente MCP (para Claude Code, isto é um arquivo .mcp.json; outros clientes têm seu próprio arquivo de configuração ou interface para isso):

{
  "mcpServers": {
    "healthchecks-io": {
      "command": "npx",
      "args": ["@digitalronin/healthchecks-io-mcp"],
      "env": {
        "HEALTHCHECKS_API_KEY": "your-key-here"
      }
    }
  }
}

Substitua "your-key-here" pela chave de API do passo 1. Reinicie seu cliente MCP (ou recarregue suas conexões MCP) após salvar isto — a maioria dos clientes só detecta servidores novos/alterados na reinicialização.

3. Experimente

Uma vez conectado, basta perguntar ao seu assistente de IA algo como:

• "Liste todos os meus checks do Healthchecks.io"
• "Mostre-me o histórico de pings do meu check de backup noturno"
• "Meu check de cron de staging está falhando atualmente?"

Se ele responder com dados reais da sua conta, você está configurado corretamente.

Opcional: múltiplos projetos

As chaves de API do Healthchecks.io são limitadas por projeto, então uma única entrada de servidor só fala com um projeto. Para trabalhar com mais de um, registre o servidor várias vezes sob nomes diferentes, cada um com sua própria chave:

{
  "mcpServers": {
    "healthchecks-io-personal": {
      "command": "npx",
      "args": ["@digitalronin/healthchecks-io-mcp"],
      "env": {
        "HEALTHCHECKS_API_KEY": "personal-project-key-here"
      }
    },
    "healthchecks-io-work": {
      "command": "npx",
      "args": ["@digitalronin/healthchecks-io-mcp"],
      "env": {
        "HEALTHCHECKS_API_KEY": "work-project-key-here"
      }
    }
  }
}

Cada entrada executa seu próprio processo com uma única chave, e os clientes MCP organizam as ferramentas por nome de servidor, então você pode saber em qual projeto uma chamada de ferramenta está sendo feita.

Opcional: Healthchecks.io auto-hospedado

Healthchecks.io é open source, e algumas pessoas executam sua própria instância em vez de usar o serviço SaaS hospedado em healthchecks.io. Se este é o seu caso, adicione uma segunda variável de ambiente apontando para a raiz da API da sua instância:

"env": {
  "HEALTHCHECKS_API_KEY": "your-key-here",
  "HEALTHCHECKS_BASE_URL": "https://monitoring.example.com/api/v3"
}

A URL deve ser a raiz completa da API, incluindo o segmento de caminho /api/v3, sem barra final — por exemplo, https://monitoring.example.com/api/v3, não https://monitoring.example.com ou https://monitoring.example.com/api/v3/. Errar isso fará com que toda chamada de ferramenta falhe com um erro "não encontrado", já que o servidor anexa caminhos como /checks/ diretamente ao que você definir aqui. Se você deixar HEALTHCHECKS_BASE_URL não definido, ele usará por padrão o https://healthchecks.io/api/v3 real.

Se sua instância auto-hospedada não estiver atrás de HTTPS, o servidor imprimirá um aviso (mas ainda executará) — sua chave de API é enviada como um cabeçalho de requisição em toda chamada, então uma URL http:// significa que essa chave viaja em texto puro pela rede até sua instância.

O que ele pode fazer

Este servidor expõe 11 "ferramentas" que seu assistente de IA pode chamar. Elas se dividem em dois grupos:

Ferramentas de leitura — seguras, apenas consulta, nunca alteram nada:

Ferramenta	O que faz
list_checks	Lista todos os checks na sua conta.
get_check	Obtém detalhes completos de um check específico.
list_check_pings	Mostra o histórico recente de pings de um check (quando pingou, sucesso/falha/etc). Requer uma chave leitura-escrita — veja nota abaixo.
list_check_flips	Mostra quando o status de um check mudou (por exemplo, de saudável para falhando, ou de volta).
list_integrations	Lista suas integrações de notificação configuradas (Slack, e-mail, etc). Requer uma chave leitura-escrita — veja nota abaixo.
list_badges	Obtém as URLs de imagem de badge que o Healthchecks.io gera para cada uma de suas tags (útil para páginas de status/dashboards).

Ferramentas de mutação — estas alteram coisas na sua conta, e todas exigem uma chave de API leitura-escrita:

Ferramenta	O que faz
create_check	Cria um novo check (por exemplo, "crie um check chamado backup-noturno que espera um ping a cada 24 horas"). Opcionalmente, pode ser instruída a corresponder campos existentes (como o nome do check) e atualizar esse check em vez de criar uma duplicata — útil se um job puder se registrar mais de uma vez.
update_check	Altera as configurações de um check existente. Apenas os campos que você especificar são alterados — qualquer coisa que você não mencionar permanece como estava.
pause_check	Pausa temporariamente o monitoramento de um check, sem excluí-lo. Requer confirmação explícita — veja abaixo.
resume_check	Retoma o monitoramento de um check pausado.
delete_check	Exclui permanentemente um check — isto não pode ser desfeito. Requer confirmação explícita — veja abaixo.

Referência técnica

Para cada ferramenta, esta tabela fornece o endpoint subjacente da API do Healthchecks.io:

Ferramenta	Requer chave leitura-escrita?	Endpoint da API do Healthchecks.io
list_checks	Não	GET /api/v3/checks/
get_check	Não	GET /api/v3/checks/{uuid}
list_check_pings	Sim	GET /api/v3/checks/{uuid}/pings/
list_check_flips	Não	GET /api/v3/checks/{uuid}/flips/
list_integrations	Sim	GET /api/v3/channels/
list_badges	Não	GET /api/v3/badges/
create_check	Sim	POST /api/v3/checks/
update_check	Sim	POST /api/v3/checks/{uuid}
pause_check	Sim	POST /api/v3/checks/{uuid}/pause
resume_check	Sim	POST /api/v3/checks/{uuid}/resume
delete_check	Sim	DELETE /api/v3/checks/{uuid}