PagerDuty

Oversigt

Forbind PagerDuty, så AI-klienter kan gennemse services, se hvem der har vagt, liste åbne incidents og inspicere log entries og alerts via REST API v2.

Integrationen er read-first: kun list- og get-værktøjer. Acknowledge, resolve og snooze er ikke inkluderet.

Foretræk OAuth (Connect PagerDuty). En REST API-nøgle er stadig tilgængelig som fallback.

Forudsætninger

• En PagerDuty-konto med adgang til de services, du vil forespørge
• Rettighed til at godkende en PagerDuty OAuth-app, eller til at oprette en REST API-nøgle
• En stackgate.ai-konto

Forbind med OAuth

1. Log ind på stackgate.ai og åbn My Integrations → PagerDuty.
2. Vælg Connect PagerDuty.
3. Log ind på PagerDuty og godkend læseadgang til services, schedules, on-calls, incidents og log entries.
4. stackgate.ai gemmer tokenet krypteret og registrerer US- vs EU-residency ud fra tokenet.
5. Brug evt. Edit tool access for kun at tillade udvalgte læseværktøjer.

Din PagerDuty OAuth-app (Integrations → App Registration, Scoped OAuth) skal tillade hubbens redirect URI og disse læse-scopes: openid, users.read, services.read, schedules.read, oncalls.read, incidents.read og log_entries.read.

Se PagerDuty OAuth.

Forbind med en REST API-nøgle

Brug dette, når OAuth ikke er tilgængelig for din konto.

1. Log ind på PagerDuty for den konto, du vil forbinde.
2. Åbn Integrations → API Access Keys (eller User Settings → API Access for et bruger-token).
3. Opret en REST API-nøgle. Kopiér den med det samme.
4. Notér din service region:
   • US-konti bruger https://api.pagerduty.com
   • EU data residency-konti bruger https://api.eu.pagerduty.com
5. I stackgate.ai: My Integrations → PagerDuty.
6. Under Add with REST API key indsætter du nøglen, vælger US eller EU og gemmer. stackgate.ai verificerer nøglen mod /users/me og gemmer den krypteret.

Se PagerDuty REST API authentication.

Brug med AI-klienter

• Dedikeret endpoint: POST /mcp/pagerduty med Sanctum bearer token
• Private gateway: én config til alle integrationer - brug pagerduty__*-navngivne værktøjer

Eksempel-prompter:

• "Hvem har vagt på payments-servicen?"
• "List åbne PagerDuty-incidents."
• "Vis log entries for incident Q0U5BQO4V7E7X5."

Fejlfinding

• 422 integration not configured - gennemfør OAuth eller API-nøgleformularen under My Integrations.
• 401 Unauthorized - reconnect OAuth, eller generér en ny REST API-nøgle i PagerDuty og opdater My Integrations.
• 403 Forbidden - forbindelsen kan ikke læse services, schedules eller incidents. Godkend OAuth igen med læse-scopes, eller brug en konto-nøgle.
• Forkert region - EU-residency-konti skal bruge EU-API-hosten. OAuth registrerer det som regel; API-nøgler kræver EU-valget.
• 429 Too many requests - PagerDuty begrænser REST-kald. Prøv igen efter kort pause, og brug limit/offset i stedet for polling.
• Tilbagekald adgang - disconnect integrationen i My Integrations, og tilbagekald appen eller slet nøglen i PagerDuty.

Begrænsninger

• Read-only MVP. Muterende incident-handlinger er reserveret til en senere, permission-gated udgivelse.
• Rate limits afhænger af planen. Foretræk paginerede list-værktøjer frem for tætte loops.
• Incident-payloads kan indeholde responder-emails og telefonnumre. Behandl resultater som driftsdata.