Healthchecks.io MCP

@digitalronin/healthchecks-io-mcp

No oficial, sin afiliación con Healthchecks.io. Este es un servidor MCP de terceros, no un producto oficial de Healthchecks.io.

Qué es esto

Healthchecks.io es un servicio de monitoreo tipo "interruptor de hombre muerto": tus trabajos programados (cron jobs, copias de seguridad, scripts por lotes, cualquier cosa que se supone que se ejecute en un horario) le envían un ping cuando se ejecutan, y Healthchecks.io te alerta si un ping no llega a tiempo — lo que significa que el trabajo falló silenciosamente o nunca se ejecutó.

Este paquete es un servidor MCP — un pequeño programa local que permite que un asistente de IA como Claude hable con la Management API de Healthchecks.io en tu nombre. Una vez configurado, puedes pedirle a tu asistente de IA cosas como "listar mis checks de Healthchecks.io", "muéstrame el historial de pings de mi trabajo de respaldo", o "pausa el monitoreo de mi entorno de staging" en lenguaje natural, y llamará al endpoint correcto de la API de Healthchecks.io por ti.

Configuración

1. Obtén una clave de API de Healthchecks.io

1. Inicia sesión en healthchecks.io (o en tu instancia autoalojada, ver más abajo).
2. Ve a la página de Settings de tu proyecto y luego a la pestaña API Access.
3. Verás dos claves: una clave de solo lectura y una clave de lectura-escritura.
   • La clave de solo lectura puede consultar tus checks, pero no puede crear, cambiar, pausar ni eliminar nada.
   • La clave de lectura-escritura puede hacer todo lo que la de solo lectura puede, además de crear, actualizar, pausar, reanudar y eliminar permanentemente checks.

2. Añade este servidor a la configuración de tu cliente MCP

No necesitas instalar nada manualmente — npx lo descargará y ejecutará automáticamente la primera vez que se use. Añade este bloque a la configuración de tu cliente MCP (para Claude Code, esto es un archivo .mcp.json; otros clientes tienen su propio archivo de configuración o interfaz para esto):

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

Reemplaza "your-key-here" con la clave de API del paso 1. Reinicia tu cliente MCP (o recarga sus conexiones MCP) después de guardar esto — la mayoría de los clientes solo detectan servidores nuevos/cambiados al reiniciar.

3. Pruébalo

Una vez conectado, solo pregunta a tu asistente de IA algo como:

• "Lista todos mis checks de Healthchecks.io"
• "Muéstrame el historial de pings de mi check de respaldo nocturno"
• "¿Mi check de staging-cron está fallando actualmente?"

Si responde con datos reales de tu cuenta, estás configurado correctamente.

Opcional: Healthchecks.io autoalojado

Healthchecks.io es de código abierto, y algunas personas ejecutan su propia instancia en lugar de usar el servicio SaaS alojado en healthchecks.io. Si ese es tu caso, añade una segunda variable de entorno que apunte a la raíz de la API de tu instancia:

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

La URL debe ser la raíz completa de la API, incluyendo el segmento de ruta /api/v3, sin barra final — p. ej. https://monitoring.example.com/api/v3, no https://monitoring.example.com ni https://monitoring.example.com/api/v3/. Si te equivocas en esto, todas las llamadas a herramientas fallarán con un error de "not found", ya que el servidor añade rutas como /checks/ directamente a lo que configures aquí. Si dejas HEALTHCHECKS_BASE_URL sin definir, se usa por defecto el https://healthchecks.io/api/v3 real.

Si tu instancia autoalojada no está detrás de HTTPS, el servidor imprimirá una advertencia (pero seguirá funcionando) — tu clave de API se envía como un encabezado de solicitud en cada llamada, por lo que una URL http:// significa que esa clave viaja en texto plano por la red hasta tu instancia.

Qué puede hacer

Este servidor expone 11 "herramientas" que tu asistente de IA puede llamar. Se dividen en dos grupos:

Herramientas de lectura — seguras, solo consulta, nunca cambian nada:

Herramienta	Qué hace
list_checks	Lista cada check en tu cuenta.
get_check	Obtiene los detalles completos de un check específico.
list_check_pings	Muestra el historial de pings reciente de un check (cuándo recibió pings, éxito/fallo, etc.). Requiere una clave de lectura-escritura — ver nota abajo.
list_check_flips	Muestra cuándo cambió el estado de un check (p. ej. pasó de saludable a fallando, o viceversa).
list_integrations	Lista tus integraciones de notificación configuradas (Slack, correo electrónico, etc.). Requiere una clave de lectura-escritura — ver nota abajo.
list_badges	Obtiene las URL de imágenes de insignia que Healthchecks.io genera para cada una de tus etiquetas (útil para páginas de estado/dashboards).

Herramientas de mutación — estas cambian cosas en tu cuenta, y todas requieren una clave de API de lectura-escritura:

Herramienta	Qué hace
create_check	Crea un nuevo check (p. ej. "crea un check llamado respaldo-nocturno que espere un ping cada 24 horas"). Opcionalmente se le puede indicar que coincida con campos existentes (como el nombre del check) y actualice ese check en lugar de crear un duplicado — útil si un trabajo podría registrarse más de una vez.
update_check	Cambia la configuración de un check existente. Solo se cambian los campos que especifiques — cualquier cosa que no menciones permanece igual.
pause_check	Detener temporalmente el monitoreo de un check, sin eliminarlo. Requiere confirmación explícita — ver abajo.
resume_check	Reanudar el monitoreo de un check pausado.
delete_check	Eliminar permanentemente un check — esto no se puede deshacer. Requiere confirmación explícita — ver abajo.

Referencia técnica

Para cada herramienta, esta tabla indica su endpoint subyacente de la API de Healthchecks.io:

Herramienta	¿Requiere clave de lectura-escritura?	Endpoint de la API de Healthchecks.io
list_checks	No	GET /api/v3/checks/
get_check	No	GET /api/v3/checks/{uuid}
list_check_pings	Sí	GET /api/v3/checks/{uuid}/pings/
list_check_flips	No	GET /api/v3/checks/{uuid}/flips/
list_integrations	Sí	GET /api/v3/channels/
list_badges	No	GET /api/v3/badges/
create_check	Sí	POST /api/v3/checks/
update_check	Sí	POST /api/v3/checks/{uuid}
pause_check	Sí	POST /api/v3/checks/{uuid}/pause
resume_check	Sí	POST /api/v3/checks/{uuid}/resume
delete_check	Sí	DELETE /api/v3/checks/{uuid}