Pulsetic MCP Server

Servidor MCP de Pulsetic

Conecta asistentes de IA a tu plataforma de monitoreo Pulsetic usando el Protocolo de Contexto de Modelo (MCP).

---

¿Qué es MCP?

El Protocolo de Contexto de Modelo es un estándar abierto que permite a los asistentes de IA interactuar con herramientas y servicios externos. Con el servidor MCP de Pulsetic, puedes pedirle a tu asistente de IA que verifique el estado de monitores, cree incidentes, programe mantenimiento y más, todo mediante conversación natural.

Clientes compatibles:

• Claude Desktop — Aplicación de escritorio de Anthropic
• Claude Code — CLI de Anthropic para desarrolladores
• ChatGPT — Asistente de IA de OpenAI (vía OAuth)
• Cursor — Editor de código potenciado por IA
• Windsurf — IDE potenciado por IA
• Cualquier cliente que implemente la especificación MCP

---

Requisitos previos

• Una cuenta de Pulsetic en un plan con acceso API (Business o Enterprise).
• Una clave API de Pulsetic — genera una desde Configuración → API en tu panel.
• Un cliente de IA compatible con MCP.

---

Configuración

Claude Desktop

Claude Desktop usa servidores MCP basados en stdio. Usa mcp-remote para conectar el endpoint HTTP remoto. Abre Configuración → Desarrollador → Editar configuración y añade:

{
  "mcpServers": {
    "pulsetic": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://api.pulsetic.com/mcp",
        "--header", "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

Reemplaza YOUR_API_KEY con tu clave API real. Reinicia Claude Desktop para aplicar.

Claude Code

Añade el servidor al archivo .mcp.json de tu proyecto:

{
  "mcpServers": {
    "pulsetic": {
      "type": "streamableHttp",
      "url": "https://api.pulsetic.com/mcp",
      "headers": {
        "Authorization": "YOUR_API_KEY"
      }
    }
  }
}

Cursor

Abre Configuración → Servidores MCP → Añadir servidor y configura:

• Tipo: streamableHttp
• URL: https://api.pulsetic.com/mcp
• Encabezados: Authorization: YOUR_API_KEY

ChatGPT

ChatGPT tiene soporte nativo para MCP a través del Modo Desarrollador. Usa OAuth para autenticarse con Pulsetic.

Paso 1. Habilita el Modo Desarrollador en ChatGPT: ve a Aplicaciones habilitadas → Configuración avanzada → Modo desarrollador y actívalo. Está disponible para usuarios de ChatGPT Pro, Plus, Team, Business, Enterprise y Edu.

Paso 2. Crea una nueva aplicación: ve a Aplicaciones habilitadas → Crear aplicación.

Paso 3. Completa los detalles de la aplicación:

Campo	Valor
Nombre	Pulsetic MCP (o cualquier nombre que prefieras)
Descripción	Uptime monitoring (opcional)
URL del servidor MCP	https://api.pulsetic.com/mcp
Autenticación	OAuth

Paso 4. Los endpoints OAuth se descubrirán automáticamente desde el servidor. Puedes verificarlos en Configuración avanzada:

Campo	Valor
URL de autenticación	https://api.pulsetic.com/mcp/oauth/authorize
URL de token	https://api.pulsetic.com/mcp/oauth/token
URL de registro	https://api.pulsetic.com/mcp/oauth/register

Paso 5. Marca "Entiendo y quiero continuar" y haz clic en Crear.

Paso 6. Completa el flujo de inicio de sesión OAuth. Serás redirigido a una página de autorización de Pulsetic donde ingresarás el correo de tu cuenta y tu token API.

El correo debe coincidir con tu token API. En la página de autorización, el correo que ingreses debe coincidir con el propietario del token API que proporciones.

Mantén tu clave API privada. Tu clave API tiene acceso completo a tu cuenta de Pulsetic. Nunca la subas a un control de versiones ni la compartas públicamente.

---

Herramientas disponibles

El servidor MCP expone 17 herramientas organizadas en cuatro categorías.

Monitores

Herramienta	Descripción
list_monitors	Lista todos los monitores con estado, tiempo de actividad y tiempo de respuesta.
get_monitor	Obtiene información detallada sobre un monitor específico.
get_monitor_stats	Porcentaje de actividad, inactividad y tiempos de respuesta en períodos de 1d/7d/30d/90d.
get_monitor_events	Eventos de conexión/desconexión dentro de un rango de fechas.
get_monitor_downtime	Tiempo total de inactividad en segundos para un período dado.
create_monitor	Crea un nuevo monitor HTTP, TCP o ICMP.
update_monitor	Actualiza el nombre, URL, frecuencia o configuración de un monitor.
delete_monitor	Elimina permanentemente un monitor.
pause_monitor	Pausa el monitoreo (detiene las verificaciones).
resume_monitor	Reanuda un monitor pausado.

Páginas de estado

Herramienta	Descripción
list_status_pages	Lista todas las páginas de estado con título, slug y dominio.

Incidentes

Herramienta	Descripción
list_incidents	Lista incidentes de una página de estado.
create_incident	Crea un nuevo incidente con una actualización de estado inicial.
update_incident	Publica una actualización de estado en un incidente existente.
resolve_incident	Marca un incidente como resuelto.

Mantenimiento

Herramienta	Descripción
create_maintenance	Programa una ventana de mantenimiento en una página de estado.
delete_maintenance	Elimina una ventana de mantenimiento programada.

---

Ejemplos de uso

Una vez configurado, puedes interactuar con Pulsetic mediante lenguaje natural.

Revisa tus monitores

"Show me all my monitors and their current status."

"What's the uptime for my production API monitor over the last 30 days?"

"Are any of my monitors currently down?"

"Show me the downtime events for monitor 42 in the past week."

Gestiona monitores

"Create a new monitor for https://api.example.com that checks every 30 seconds."

"Pause the staging monitor while we do the migration."

"Resume all paused monitors."

"Change the check frequency of monitor 15 to 60 seconds."

"Delete the old marketing-site monitor."

Maneja incidentes

"Create an incident on our main status page: 'Elevated API latency'
 with status investigating and message 'We're looking into slow response times.'"

"Update the API latency incident to identified: 'Root cause is a database
 connection pool issue. Working on a fix.'"

"Resolve incident 8 with message 'Connection pool limits increased.
 Response times back to normal.'"

Programa mantenimiento

"Schedule a maintenance window on status page 1 called 'Database upgrade'
 starting 2025-03-20 at 2am UTC and ending at 4am UTC."

"Delete the maintenance window we scheduled for next week."

---

Pruebas con cURL

Puedes probar el endpoint MCP directamente con cURL para verificar que tu clave API funciona.

Inicializar

curl -X POST https://api.pulsetic.com/mcp \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-03-26",
      "capabilities": {},
      "clientInfo": {"name": "curl", "version": "1.0"}
    }
  }'

Listar herramientas

curl -X POST https://api.pulsetic.com/mcp \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

Llamar a una herramienta

curl -X POST https://api.pulsetic.com/mcp \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "list_monitors",
      "arguments": {}
    }
  }'

---

Referencia de herramientas

list_monitors

Devuelve todos los monitores de tu cuenta.

Sin parámetros.

---

get_monitor

Devuelve todos los detalles de un solo monitor, incluyendo información del certificado SSL.

Parámetro	Tipo	Requerido	Descripción
monitor_id	integer	Sí	El ID del monitor.

---

get_monitor_stats

Devuelve el % de actividad, inactividad, conteo de incidentes y tiempo de respuesta promedio en períodos de 1 día, 7 días, 30 días y 90 días.

Parámetro	Tipo	Requerido	Descripción
monitor_id	integer	Sí	El ID del monitor.

---

get_monitor_events

Devuelve eventos de conexión/desconexión en un rango de fechas (máx. 100, los más recientes primero).

Parámetro	Tipo	Requerido	Descripción
monitor_id	integer	Sí	El ID del monitor.
from	string	No	Fecha de inicio (AAAA-MM-DD). Predeterminado: hace 7 días.
to	string	No	Fecha de fin (AAAA-MM-DD). Predeterminado: hoy.

---

get_monitor_downtime

Devuelve el tiempo total de inactividad en segundos y el conteo de incidentes para un período.

Parámetro	Tipo	Requerido	Descripción
monitor_id	integer	Sí	El ID del monitor.
days	integer	No	Días hacia atrás a revisar. Predeterminado: 30.

---

create_monitor

Crea un nuevo monitor de tiempo de actividad.

Parámetro	Tipo	Requerido	Descripción
url	string	Sí	URL o nombre de host a monitorear.
name	string	No	Nombre para mostrar.
request_type	string	No	http, tcp, o icmp. Predeterminado: http.
uptime_check_frequency	integer	No	Intervalo de verificación en segundos. Predeterminado: 60.
request_method	string	No	Método HTTP. Predeterminado: GET.
request_timeout	integer	No	Tiempo de espera en segundos. Predeterminado: 30.
ssl_check	boolean	No	Habilitar monitoreo SSL.

---

update_monitor

Actualiza la configuración de un monitor existente. Solo incluye los campos que deseas cambiar.

Parámetro	Tipo	Requerido	Descripción
monitor_id	integer	Sí	El ID del monitor.
name	string	No	Nuevo nombre para mostrar.
url	string	No	Nueva URL o nombre de host.
uptime_check_frequency	integer	No	Nuevo intervalo de verificación en segundos.
request_method	string	No	Método HTTP.
request_timeout	integer	No	Tiempo de espera en segundos.
ssl_check	boolean	No	Habilitar/deshabilitar monitoreo SSL.

---

delete_monitor

Elimina permanentemente un monitor y todos los datos asociados.

Parámetro	Tipo	Requerido	Descripción
monitor_id	integer	Sí	El ID del monitor.

---

pause_monitor

Pausa un monitor. Dejará de ser verificado hasta que se reanude.

Parámetro	Tipo	Requerido	Descripción
monitor_id	integer	Sí	El ID del monitor.

---

resume_monitor

Reanuda un monitor pausado.

Parámetro	Tipo	Requerido	Descripción
monitor_id	integer	Sí	El ID del monitor.

---

list_status_pages

Devuelve todas las páginas de estado de tu cuenta.

Sin parámetros.

---

list_incidents

Devuelve los incidentes de una página de estado, incluyendo la última actualización de cada uno.

Parámetro	Tipo	Requerido	Descripción
status_page_id	integer	Sí	El ID de la página de estado.

---

create_incident

Crea un nuevo incidente con una actualización de estado inicial que aparece en la página de estado.

Parámetro	Tipo	Requerido	Descripción
status_page_id	integer	Sí	El ID de la página de estado.
title	string	Sí	Título del incidente.
status	string	Sí	investigating, identified, monitoring, o resolved.
message	string	Sí	Mensaje de actualización inicial.

---

update_incident

Publica una nueva actualización de estado en un incidente existente.

Parámetro	Tipo	Requerido	Descripción
incident_id	integer	Sí	El ID del incidente.
status	string	Sí	investigating, identified, monitoring, o resolved.
message	string	Sí	Mensaje de actualización.
title	string	No	Actualizar el título del incidente.

---

resolve_incident

Marca un incidente como resuelto con un mensaje de resolución.

Parámetro	Tipo	Requerido	Descripción
incident_id	integer	Sí	El ID del incidente.
message	string	Sí	Mensaje de resolución.

---

create_maintenance

Programa una ventana de mantenimiento en una página de estado.

Parámetro	Tipo	Requerido	Descripción
status_page_id	integer	Sí	El ID de la página de estado.
name	string	Sí	Título del mantenimiento.
description	string	No	Descripción del mantenimiento.
start	string	Sí	Hora de inicio en formato ISO 8601.
end	string	Sí	Hora de fin en formato ISO 8601.
timezone	string	No	Zona horaria (ej., UTC, America/New_York). Predeterminado: UTC.

---

delete_maintenance

Elimina una ventana de mantenimiento programada.

Parámetro	Tipo	Requerido	Descripción
maintenance_id	integer	Sí	El ID de la ventana de mantenimiento.

---

Solución de problemas

401 No autorizado

• Verifica que tu clave API sea correcta y no haya expirado.
• Asegúrate de pasar la clave en el encabezado Authorization (ya sea como token sin procesar o con el prefijo Bearer).
• Confirma que tu cuenta esté en un plan con acceso API habilitado.

Fallo en la autorización OAuth (ChatGPT)

• En la página de autorización, el correo electrónico que ingreses debe coincidir con el propietario del token API.
• Asegúrate de que el Modo Desarrollador esté habilitado en tu configuración de ChatGPT.
• Asegúrate de tener un plan de ChatGPT que soporte el Modo Desarrollador (Pro, Plus, Team, Business, Enterprise o Edu).

"Monitor no encontrado o acceso denegado"

• El ID del monitor no existe o pertenece a una cuenta diferente.
• Usa list_monitors para ver los IDs de tus monitores disponibles.

Las herramientas no aparecen en tu cliente de IA

• Reinicia el cliente de IA después de editar la configuración MCP.
• Verifica que la URL sea exactamente https://api.pulsetic.com/mcp.
• Prueba el endpoint con cURL para verificar la conectividad.

Errores de protocolo

• Asegúrate de que las solicitudes usen Content-Type: application/json.
• El campo jsonrpc debe ser exactamente "2.0".
• Incluye un campo id (entero o cadena) para todas las solicitudes excepto notificaciones.

---

Referencia de la API

El servidor MCP implementa la especificación MCP (2025-03-26) utilizando transporte HTTP transmitible a través de un único endpoint POST /mcp con JSON-RPC 2.0.