Come collegare PagerDuty a Cursor via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → PagerDuty, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

PagerDuty + Cursor

Fai lavorare la tua AI con PagerDuty: vedi gli incidenti aperti con timeline, alert e note, scopri chi è reperibile, consulta servizi, escalation policy, turni e team, prendi in carico, risolvi, riassegna o fai escalation degli incidenti dopo la tua conferma e ottieni le analisi sugli incidenti.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

PAGERDUTY_API_KEY, PAGERDUTY_API_HOST

Step 1 — Ottieni le credenziali

1. Accedi a PagerDuty e scegli il tipo di chiave. Un user token agisce come te e vede ciò che vedi tu: apri il tuo avatar, poi My Profile → User Settings → Create API User Token. Una general access key agisce per l'intero account e richiede un amministratore: Integrations → API Access Keys → Create New API Key. Spunta lì Read-only per un connettore che legge soltanto.
2. Incolla la chiave da sola in PAGERDUTY_API_KEY, senza Token token= davanti.
3. Imposta PAGERDUTY_API_HOST su api.pagerduty.com per la service region USA oppure su api.eu.pagerduty.com per la service region UE (la tua region è indicata in Account Settings). Una chiave funziona solo sull'host della propria region.
4. Facoltativo: con una general access key imposta PAGERDUTY_FROM_EMAIL sull'email di un utente PagerDuty. PagerDuty la richiede per ogni modifica e registra la modifica a nome di quell'utente. Con uno user token lascia il campo vuoto.
5. Verifica la configurazione con pagerduty_list_services. pagerduty_get_current_user funziona solo con uno user token; con una general access key PagerDuty risponde 400, perché quella chiave non appartiene a nessun utente.

Chi vede cosa: uno user token vede e modifica solo ciò che il suo proprietario può fare in PagerDuty. Una general access key copre l'intero account; una chiave read-only non può modificare nulla. Condividi il server MCP solo con persone autorizzate a intervenire sui vostri incidenti.

Le modifiche allertano persone e chiudono incidenti, quindi l'AI chiede prima: prima di ognuna di queste l'AI ti mostra l'incidente (numero e titolo) e la modifica e aspetta il tuo sì. pagerduty_acknowledge_incident ferma le notifiche, ma l'incidente resta aperto. pagerduty_resolve_incident lo chiude. pagerduty_reassign_incident allerta il nuovo utente e rimuove gli assegnatari attuali. pagerduty_escalate_incident allerta i reperibili del livello che scegli. pagerduty_update_incident cambia titolo, urgenza o priorità (per nome, per esempio P1); una nuova urgenza può cambiare chi viene allertato e come. pagerduty_add_incident_note aggiunge una nota che vedono tutti quelli che seguono l'incidente e che non si può modificare in seguito. pagerduty_create_incident apre un incidente su un servizio e allerta subito i suoi reperibili. All'installazione non è disattivato nulla e nessuno strumento elimina qualcosa; per una configurazione in sola lettura usa una general access key read-only o disattiva questi strumenti.

Come lavorare: gli incidenti aperti arrivano da pagerduty_list_incidents filtrato sugli stati triggered e acknowledged; poi pagerduty_get_incident, pagerduty_list_incident_log_entries (la timeline), pagerduty_list_incident_alerts (ciò che ha inviato lo strumento di monitoraggio) e pagerduty_list_incident_notes. Chi è reperibile adesso: pagerduty_list_oncalls. Turni di uno schedule: pagerduty_list_schedules, poi pagerduty_get_schedule. Livelli di escalation: pagerduty_list_escalation_policies e pagerduty_get_escalation_policy. Anagrafiche: pagerduty_list_services, pagerduty_get_service, pagerduty_list_users (l'id utente per una riassegnazione), pagerduty_get_user, pagerduty_list_teams e pagerduty_list_priorities.

Id e date: gli id sono stringhe brevi come PT4KHLK; il numero dell'incidente (#1234) non è un id. Le date sono in ISO 8601. pagerduty_list_incidents copre gli ultimi 30 giorni, a meno che tu non indichi un inizio e una fine (al massimo 6 mesi di distanza) o chieda tutti gli incidenti.

Analisi: pagerduty_get_incident_analytics (per incidente: tempo di presa in carico e di risoluzione, escalation, interruzioni) e pagerduty_get_incident_metrics (totali per un periodo o per giorno, settimana o mese) richiedono un piano PagerDuty che includa Analytics. Con uno user token vanno filtrati per service_ids o team_ids. I dati arrivano con qualche ora di ritardo rispetto al tempo reale.

Errori comuni: 401: la chiave è errata, è stata eliminata o appartiene all'host dell'altra region. 400 sull'header From: una general access key ha fatto una modifica senza PAGERDUTY_FROM_EMAIL, oppure quell'email non è un utente dell'account. 400 su pagerduty_get_current_user: la chiave è una general access key. 403: una chiave read-only ha tentato una modifica, il ruolo dell'utente non lo consente o il piano non include la funzione (team, analytics). 404: l'id non esiste su questo account. 429: troppe richieste; attendi e riprova.

Il connettore non copre la Events API (alert inviati con la routing key di un'integrazione), la creazione o modifica di servizi, schedule, escalation policy e utenti, le status page, gli incident workflow, i webhook né alcuna eliminazione.

Step 2 — Installa l'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

Step 3 — Aggiungi il connettore in Cursor

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Cursor legge i server MCP da ~/.cursor/mcp.json. Aggiungi questa voce:

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

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia Cursor.
3. Apri Cursor → Settings → MCP e verifica che anythingmcp sia elencato e connesso.
4. Inizia a chattare: l'agente ora può usare i tool di PagerDuty.

Tool disponibili

Esempi di prompt

• "Quali incidenti PagerDuty sono aperti in questo momento? Ordinali per urgenza e mostrami a chi è assegnato ciascuno."
• "Chi è reperibile adesso per la Checkout API e chi viene dopo nella sua escalation policy?"
• "Prendi in carico l'incidente #4821 e aggiungi una nota che sto verificando il failover del database. Mostrami prima entrambe le cose e chiedimi conferma prima di modificare qualcosa."
• "Riassegna l'incidente aperto sul payment gateway a Giulia Rossi. Dimmi incidente e persona prima di farlo."
• "Come sono cambiati nell'ultimo mese, settimana per settimana, il tempo medio di presa in carico e quello di risoluzione per il team Platform?"

FAQ

Cursor supporta server MCP personalizzati nel piano gratuito? Sì, MCP è disponibile nei piani Hobby, Pro e Business.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT