Cómo conectar PagerDuty a Gemini vía MCP

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

PagerDuty + Gemini

Deja que tu IA trabaje con PagerDuty: ve los incidentes abiertos con su cronología, alertas y notas, averigua quién está de guardia, consulta servicios, políticas de escalado, calendarios de guardia y equipos, reconoce, resuelve, reasigna o escala incidentes tras confirmarlo contigo y obtén analíticas de incidentes.

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:

PAGERDUTY_API_KEY, PAGERDUTY_API_HOST

Paso 1 — Obtener credenciales

1. Inicia sesión en PagerDuty y elige el tipo de clave. Un user token actúa como tú y ve lo que tú ves: abre tu avatar y luego My Profile → User Settings → Create API User Token. Una general access key actúa para toda la cuenta y la crea un administrador: Integrations → API Access Keys → Create New API Key. Marca ahí Read-only para un conector que solo lee.
2. Pega la clave sola en PAGERDUTY_API_KEY, sin Token token= delante.
3. Pon en PAGERDUTY_API_HOST el valor api.pagerduty.com para la región de servicio de EE. UU. o api.eu.pagerduty.com para la región de servicio de la UE (tu región aparece en Account Settings). Una clave solo funciona en el host de su propia región.
4. Opcional: con una general access key, pon en PAGERDUTY_FROM_EMAIL el email de un usuario de PagerDuty. PagerDuty lo exige en cada cambio y registra el cambio a nombre de ese usuario. Con un user token déjalo vacío.
5. Comprueba la configuración con pagerduty_list_services. pagerduty_get_current_user solo funciona con un user token; con una general access key PagerDuty responde 400, porque esa clave no pertenece a ningún usuario.

Quién ve qué: un user token ve y cambia solo lo que su dueño puede hacer en PagerDuty. Una general access key abarca toda la cuenta; una de solo lectura no puede cambiar nada. Comparte el servidor MCP solo con personas que puedan actuar sobre vuestros incidentes.

Los cambios avisan a personas y cierran incidentes, así que la IA pregunta antes: antes de cada uno, la IA te muestra el incidente (número y título) y el cambio y espera tu sí. pagerduty_acknowledge_incident detiene los avisos, pero el incidente sigue abierto. pagerduty_resolve_incident lo cierra. pagerduty_reassign_incident avisa al nuevo usuario y quita a los asignados actuales. pagerduty_escalate_incident avisa a las personas de guardia del nivel que elijas. pagerduty_update_incident cambia el título, la urgencia o la prioridad (por nombre, como P1); una nueva urgencia puede cambiar a quién se avisa y cómo. pagerduty_add_incident_note añade una nota que ven todos los que siguen el incidente y que después no se puede editar. pagerduty_create_incident abre un incidente en un servicio y avisa al momento a sus personas de guardia. Al instalar no hay nada desactivado y ninguna herramienta borra nada; para una configuración de solo lectura usa una general access key de solo lectura o desactiva estas herramientas.

Cómo trabajar: los incidentes abiertos salen de pagerduty_list_incidents filtrado por los estados triggered y acknowledged; después pagerduty_get_incident, pagerduty_list_incident_log_entries (la cronología), pagerduty_list_incident_alerts (lo que envió la herramienta de monitorización) y pagerduty_list_incident_notes. Quién está de guardia ahora: pagerduty_list_oncalls. Turnos de un calendario: pagerduty_list_schedules y luego pagerduty_get_schedule. Niveles de escalado: pagerduty_list_escalation_policies y pagerduty_get_escalation_policy. Directorio: pagerduty_list_services, pagerduty_get_service, pagerduty_list_users (el id de usuario para reasignar), pagerduty_get_user, pagerduty_list_teams y pagerduty_list_priorities.

Ids y fechas: los ids son cadenas cortas como PT4KHLK; el número del incidente (#1234) no es un id. Las fechas van en ISO 8601. pagerduty_list_incidents abarca los últimos 30 días, salvo que indiques un inicio y un fin (como máximo 6 meses de diferencia) o pidas todos los incidentes.

Analíticas: pagerduty_get_incident_analytics (por incidente: tiempo hasta el reconocimiento y la resolución, escalados, interrupciones) y pagerduty_get_incident_metrics (totales de un periodo o por día, semana o mes) necesitan un plan de PagerDuty que incluya Analytics. Con un user token hay que filtrarlas por service_ids o team_ids. Los datos llevan unas horas de retraso respecto al tiempo real.

Errores comunes: 401: la clave es incorrecta, se borró o pertenece al host de la otra región. 400 sobre la cabecera From: una general access key hizo un cambio sin PAGERDUTY_FROM_EMAIL, o ese email no es de un usuario de la cuenta. 400 en pagerduty_get_current_user: la clave es una general access key. 403: una clave de solo lectura intentó un cambio, el rol del usuario no lo permite o el plan no incluye la función (equipos, analíticas). 404: ese id no existe en esta cuenta. 429: demasiadas peticiones; espera y vuelve a intentarlo.

El conector no cubre la Events API (alertas enviadas con la routing key de una integración), la creación o modificación de servicios, calendarios, políticas de escalado y usuarios, las status pages, los incident workflows, los webhooks ni ningún borrado.

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 Gemini

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.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "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 gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de PagerDuty.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué incidentes de PagerDuty están abiertos ahora mismo? Ordénalos por urgencia y dime a quién está asignado cada uno."
• "¿Quién está de guardia ahora para la API de Checkout y quién va después en su política de escalado?"
• "Reconoce el incidente #4821 y añade una nota de que estoy revisando el failover de la base de datos. Enséñame las dos cosas antes y pregúntame antes de cambiar nada."
• "Reasigna el incidente abierto de la pasarela de pagos a Lucía García. Dime el incidente y la persona antes de hacerlo."
• "¿Cómo han evolucionado por semana en el último mes el tiempo medio de reconocimiento y el de resolución del equipo Platform?"

FAQ

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT