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 estilo "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 "lista mis checks de Healthchecks.io", "muéstrame el historial de pings de mi trabajo de copia de seguridad", 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 Configuración de tu proyecto, luego a la pestaña Acceso API.
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 clave 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 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 pregúntale a tu asistente de IA algo como:

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

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

Opcional: múltiples proyectos

Las claves de API de Healthchecks.io están limitadas por proyecto, por lo que una sola entrada de servidor solo se comunica con un proyecto. Para trabajar con más de uno, registra el servidor varias veces con diferentes nombres, cada uno con su propia clave:

{
  "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 ejecuta su propio proceso con una sola clave, y los clientes MCP organizan las herramientas por nombre de servidor, por lo que puedes saber a qué proyecto está llamando una herramienta.

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 diagonal final — por ejemplo, https://monitoring.example.com/api/v3, no https://monitoring.example.com ni https://monitoring.example.com/api/v3/. Si esto se configura incorrectamente, todas las llamadas a herramientas fallarán con un error de "no encontrado", ya que el servidor añade rutas como /checks/ directamente a lo que establezcas aquí. Si dejas HEALTHCHECKS_BASE_URL sin configurar, se usará 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 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 detalles completos de un check específico.
list_check_pings	Muestra el historial reciente de pings 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 (por ejemplo, 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 URLs de imágenes de insignia que Healthchecks.io genera para cada una de tus etiquetas (útil para páginas de estado/paneles).

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 (por ejemplo, "crea un check llamado copia-nocturna 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 como estaba.
pause_check	Detiene temporalmente el monitoreo de un check, sin eliminarlo. Requiere confirmación explícita — ver abajo.
resume_check	Reanuda el monitoreo en un check pausado.
delete_check	Elimina permanentemente un check — esto no se puede deshacer. Requiere confirmación explícita — ver abajo.

Referencia técnica

Para cada herramienta, esta tabla muestra 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}