Cómo conectar incident.io a Cursor vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → incident.io, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

incident.io + Cursor

Respuesta a incidentes con incident.io en cualquier agente de IA: lista y lee incidentes con sus actualizaciones y su línea de tiempo, consulta severidades, estados, roles, tipos y campos personalizados, gestiona acciones y follow-ups, lee y resuelve alertas, mira quién está de guardia, avisa a personas con escalados y consulta usuarios, equipos y el catálogo. También puede declarar y editar incidentes y publicar actualizaciones.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

INCIDENT_IO_API_KEY

Paso 1 — Obtener credenciales

La configuración lleva unos 2 minutos. Necesitas una cuenta de incident.io y una clave API.

1. En incident.io abre Settings, API keys (https://app.incident.io/settings/api-keys) y haz clic en Add new. Solo puede hacerlo un administrador o un rol con permiso para gestionar claves API.
2. Ponle un nombre a la clave y marca lo que puede hacer. Para leer necesita al menos view data (viewer), además de ver el catálogo, los schedules y las guardias; los incidentes privados requieren un permiso aparte. Para escribir añade crear incidentes, editar incidentes, gestionar acciones y follow-ups, crear escalados, etc. Una herramienta para la que falta el permiso responde 403.
3. Copia la clave (solo se muestra una vez) en INCIDENT_IO_API_KEY, sin Bearer delante. El conector la envía como token Bearer a https://api.incident.io.
4. Instala el conector y ejecuta incident_io_get_identity: muestra el nombre de la clave, la URL del panel de tu organización y los roles de la clave, como viewer, incident_creator, incident_editor, on_call_viewer o escalation_creator.

Qué está pasando ahora: incident_io_list_incidents con status_category: ["live"] (Active en la app) o ["triage"], de más reciente a más antiguo, con referencia, nombre, resumen, estado, severidad, tipo, modo, visibilidad, roles, campos personalizados, marcas de tiempo, canal de Slack y enlace permanente. Los filtros cubren categoría de estado, estado, severidad (también "al menos así de grave" con severity_gte), tipo, modo y fecha de creación o actualización, combinados con filter_mode all o any; los filtros por campos personalizados y roles van en extra_filters. Después incident_io_get_incident da el incidente completo con métricas de duración y enlace al postmortem, incident_io_list_incident_updates las actualizaciones e incident_io_list_incident_timeline_items las notas, los mensajes fijados y las actualizaciones en orden. Los incidentes de prueba y de tutorial quedan ocultos salvo que pidas esos modos.

Configuración para buscar ids: incident_io_list_severities, incident_io_list_incident_statuses, incident_io_list_incident_roles, incident_io_list_incident_types, incident_io_list_custom_fields, incident_io_get_custom_field, incident_io_list_custom_field_options e incident_io_list_incident_timestamps. La IA los lee primero y luego usa los ids para filtrar, crear o editar.

Gestionar un incidente:

• incident_io_create_incident declara un incidente con nombre, resumen, severidad, estado, tipo, visibilidad (public o private), modo, roles, valores de campos personalizados y marcas de tiempo. Necesita un idempotency_key y visibility. El modo test sirve para probar sin un incidente real; retrospective registra uno pasado.
• incident_io_create_incident_update publica una actualización para responders y stakeholders y puede cambiar a la vez el estado y la severidad.
• incident_io_edit_incident cambia nombre, resumen, severidad, estado (se resuelve pasando a un estado closed), roles, campos personalizados, marcas de tiempo, enlace de la llamada o nombre del canal de Slack. Solo cambia lo que envías; notify_incident_channel avisa al canal.
• Acciones durante el incidente: incident_io_list_actions, incident_io_get_action, incident_io_create_action, incident_io_update_action (outstanding, completed, not_doing).
• Follow-ups después del incidente: incident_io_list_follow_ups, incident_io_get_follow_up, incident_io_create_follow_up, incident_io_update_follow_up, con prioridad, categoría, etiquetas, persona o equipo asignado y una incidencia externa vinculada (Jira, Linear y otras). Actualizar una acción o un follow-up lo reemplaza entero, así que la IA siempre envía el texto y el estado actuales.

Alertas: incident_io_list_alerts (filtra por estado como firing, origen, clave de deduplicación o fecha), incident_io_get_alert, incident_io_list_incident_alerts para ver qué alertas pertenecen a qué incidente, e incident_io_resolve_alert para resolver a mano una alerta activa cuando el origen no envía un evento de resolución; según la alert route, también pueden resolverse los incidentes y escalados que inició. Los orígenes de alertas (Datadog, Grafana, Prometheus, CloudWatch, HTTP, email, heartbeat y otros) se leen con incident_io_list_alert_sources e incident_io_get_alert_source; sus tokens secretos se omiten.

Guardias: incident_io_list_schedules e incident_io_get_schedule muestran rotaciones, capas y turnos actuales; incident_io_list_schedule_entries devuelve para una ventana de tiempo las entradas finales tras los overrides, es decir, la respuesta a "quién está de guardia ahora". incident_io_list_escalation_paths e incident_io_list_escalations muestran a quién se avisa y qué pasó; incident_io_create_escalation avisa a personas siguiendo una ruta de escalado o directamente por id de usuario.

Organización y catálogo: incident_io_list_users (encuentra a alguien por email o id de Slack), incident_io_get_user, incident_io_list_teams, incident_io_list_catalog_types, incident_io_get_catalog_type, incident_io_list_catalog_entries (busca una entrada con identifier) e incident_io_get_catalog_entry.

Antes de escribir: un incidente estándar nuevo abre un canal de Slack o Teams y avisa a la gente, una actualización se comparte con responders y suscriptores, y un escalado despierta a quien está de guardia. La IA te muestra lo que va a hacer y espera tu sí. Si repite una creación, reutiliza el mismo idempotency_key, para que el reintento no cree un segundo incidente, actualización o aviso.

Desactivadas en la instalación: ninguna. Las 43 herramientas están activas, también las de escritura; lo que puede hacer la clave lo decides con los permisos que le marcas en incident.io.

Formatos de datos: los ids son ULID (26 caracteres, por ejemplo 01FCNDV6P870EA6S7TK1DSYDG0); la referencia legible es reference (INC-123). Las horas son ISO 8601 en UTC y los filtros de fecha usan YYYY-MM-DD. Categorías de estado en la API: triage, live (Active), learning (Post-incident), paused, closed, declined, canceled, merged. Un rank de severidad más alto significa más grave. Las respuestas sobre campos personalizados no incluyen las listas de opciones; esas las devuelve incident_io_list_custom_field_options.

Paginación: las listas devuelven pagination_meta con after; la IA vuelve a llamar con ese valor en after hasta que deja de aparecer. page_size es 25 por defecto y llega a 250 en la mayoría de las listas. incident_io_list_schedule_entries pagina poniendo pagination_meta.after en entry_window_start.

Límites: 1.200 peticiones por minuto por clave.

Errores comunes: 401 significa una clave incorrecta o eliminada. 403 significa que a la clave le falta el permiso para esa llamada; incident_io_get_identity muestra sus roles y en Settings, API keys marcas el que falta. 404 es un id desconocido. 422 es un error de validación cuyo errors nombra el campo, por ejemplo un cambio de estado no permitido. 429 es el límite de peticiones; espera un minuto.

El conector no elimina incidentes, acciones, follow-ups ni entradas del catálogo, no crea ni modifica orígenes de alertas, schedules ni rutas de escalado, y no devuelve los tokens secretos de los orígenes de alertas.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Cursor

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de incident.io.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué incidentes están activos ahora mismo? Dame la severidad, el estado, el incident lead y la última actualización de cada uno."
• "¿Quién está de guardia ahora en el schedule de Platform y quién entra después?"
• "Resume la línea de tiempo de INC-123 y lista sus follow-ups abiertos con las personas asignadas."
• "Declara un incidente de prueba privado llamado Latencia en el checkout con severidad Minor. Enséñame los datos antes de crearlo."
• "¿Qué alertas de Datadog siguen activas y alguna está vinculada a un incidente?"

FAQ

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Gemini
• Conectar a Meta Muse
• Conectar a Microsoft Copilot