> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# PagerDuty-Integration
> Verbinde PagerDuty mit Devin, um Automatisierungen durch Incidents auszulösen und Devin-Sitzungen Zugriff auf Incidents, Services und Bereitschaftspläne zu geben.
Verbinde PagerDuty, damit Devin sofort loslegen kann, sobald ein Incident ausgelöst wird. PagerDuty-Incidents starten Devin-[Automatisierungen](/de/product-guides/automations), und der PagerDuty MCP server gibt Devin-Sitzungen Zugriff auf Incidents, Services und Bereitschaftspläne.
## Integration einrichten
1. Gehen Sie in PagerDuty zu **Integrations > API Access Keys** und klicken Sie auf „Create New API Key“. Erstellen Sie einen **General Access**-Key mit vollem Zugriff und kopieren Sie ihn. User-API-Tokens werden nicht akzeptiert.
2. Gehen Sie in Ihrem Devin account unter app.devin.ai zu [Settings > Connections > PagerDuty](https://app.devin.ai/settings/connections/pagerduty) und klicken Sie auf „Connect“.
3. Wählen Sie Ihre **API region** (US oder EU) und geben Sie anschließend Folgendes ein:
* **Actor email**: der PagerDuty-Nutzer, dem Devins Incident-Notizen und Updates zugeschrieben werden. Wir empfehlen einen dedizierten Service-Benutzer.
* **General Access REST API key**: der Key, den Sie in Schritt 1 erstellt haben.
4. Klicken Sie auf „Connect“. Devin erstellt automatisch ein Webhook-Abonnement in PagerDuty, um Incident-Events empfangen zu können.
## Webhook-Abonnements konfigurieren
Beim Verbinden erstellt Devin ein kontoweites Webhook-Abonnement in PagerDuty. Dieses sendet die folgenden Events an Devin:
* `incident.triggered`
* `incident.acknowledged`
* `incident.resolved`
* `incident.priority_updated`
* `incident.reassigned`
* `incident.service_updated`
Der Abschnitt **Webhook** auf der Settings-Seite zeigt den Status des Abonnements. Schlägt die automatische Einrichtung fehl, klicke auf „Retry webhook setup“ oder füge den Webhook manuell hinzu:
1. Klicke im Abschnitt **Webhook** auf „Add webhook“ und kopiere die Webhook-URL.
2. Gehe in PagerDuty zu **Integrations > Generic Webhooks (v3)** und füge einen Webhook hinzu, der auf diese URL verweist und den Geltungsbereich **Account** hat.
3. Wähle die oben aufgeführten Incident-Event-Typen aus.
4. Kopiere das Signing-Secret, das PagerDuty nur einmal anzeigt, füge es in Devin ein und klicke auf „Save“.
Beim Trennen von PagerDuty werden keine Incident-Events mehr gesendet und das von Devin erstellte Webhook-Abonnement wird gelöscht. Der PagerDuty MCP server wird dabei nicht entfernt.
Der PagerDuty-MCP-Server meldet jedes Member per OAuth an. PagerDuty unterstützt keine automatische Registrierung von OAuth-Clients. Daher registriert ein Admin eine OAuth-App in PagerDuty und hinterlegt deren Client ID und Secret in Devin.
1. Klicken Sie unter [Settings > Connections > PagerDuty](https://app.devin.ai/settings/connections/pagerduty) im Abschnitt **MCP server** auf „Set up with OAuth“. Kopieren Sie die auf der Setup-Seite angezeigte **OAuth callback URL**.
2. Gehen Sie in PagerDuty zu **Integrations > App Registration** und klicken Sie auf „New App“. Geben Sie einen Namen ein, etwa `Devin`, und wählen Sie **OAuth 2.0** aus.
3. Wählen Sie **Scoped OAuth** aus und fügen Sie die OAuth callback URL aus Devin als **Redirect URL** hinzu.
4. Wählen Sie unter den Berechtigungsbereichen alle **Read Access**-Geltungsbereiche aus. Devin benötigt keinen Schreibzugriff.
5. Kopieren Sie den Wert **Selected Permission Scope**. Sie geben ihn bei der Installation des MCP server ein.
6. Registrieren Sie die App und kopieren Sie anschließend die **client ID** und das **client secret**.
### MCP server installieren
1. Wählen Sie auf der Devin-Setup-Seite die **Server URL** für Ihre Region aus: Vereinigte Staaten (`mcp.pagerduty.com`) oder Europäische Union (`mcp.eu.pagerduty.com`).
2. Geben Sie die **OAuth Client ID** und das **OAuth Client Secret** aus Ihrer PagerDuty-App ein.
3. Fügen Sie den Wert **Selected Permission Scope** aus Ihrer PagerDuty-App unter **OAuth scope** ein.
4. Speichern Sie die Installation.
Der PagerDuty-MCP-Zugriff erfolgt immer persönlich. Devin verwendet dafür niemals ein gemeinsames Organisations-Token. Jedes Member muss zunächst sein eigenes PagerDuty-Nutzerkonto verbinden, damit Devin PagerDuty-Tools in seinen Sitzungen nutzen kann.
Zusätzlich zur Integration auf Organisationsebene verknüpft jedes Teammitglied sein eigenes PagerDuty-Konto mit seinem Devin-Konto. Dadurch kann Devin den PagerDuty-MCP-Server im Namen dieses Members verwenden. Außerdem ist dies Voraussetzung, um PagerDuty-Automatisierungen zu erstellen.
Um Ihr Nutzerkonto zu verbinden, öffnen Sie [Personal Connections](https://app.devin.ai/account/connections), klicken Sie neben PagerDuty auf „Connect“ und genehmigen Sie den Zugriff in PagerDuty. Verwenden Sie dabei einen PagerDuty-Nutzer aus dem PagerDuty-Konto, das Ihre Organisation verbunden hat.
Devin beginnt über [Automatisierungen](/de/product-guides/automations) mit der Arbeit an PagerDuty-Incidents. Sobald PagerDuty verbunden ist, müssen Sie nicht für jede Automatisierung einen eigenen Webhook einrichten.
1. Gehen Sie zu **Automations** und erstellen Sie eine neue Automatisierung.
2. Fügen Sie einen Trigger hinzu, wählen Sie **PagerDuty** und anschließend ein Ereignis aus:
* **Incident triggered**: Ein neuer Incident wird eröffnet.
* **Incident acknowledged**: Jemand bestätigt einen Incident.
* **Incident resolved**: Ein Incident wird behoben.
* **Incident updated**: Priorität, Zuweisung oder Service eines Incidents ändern sich.
3. Fügen Sie optional Bedingungen hinzu, um einzugrenzen, welche Incidents zutreffen:
* **Service**, **Team** und **Priority**: Die Optionen werden aus Ihrem PagerDuty-Konto geladen.
* **Urgency** (`high` oder `low`) und **Status**.
* **Title**, **Escalation policy** und **Assignee**.
* **Change** (`priority`, `assignment` oder `service`): nur für **Incident updated**.
4. Fügen Sie eine **Start session**-Aktion mit Anweisungen für Devin hinzu und speichern Sie.
Um zum Beispiel Incidents mit hoher Dringlichkeit in Ihrem Checkout-Service zu untersuchen, verwenden Sie das Ereignis **Incident triggered** mit den Bedingungen **Service** gleich `checkout-api` und **Urgency** gleich `high`. Fügen Sie dann einen Prompt hinzu, etwa: „Untersuche diesen Incident. Prüfe die letzten Deploys und Fehlerlogs für checkout-api und finde die wahrscheinliche Ursache.“
Um eine Automatisierung mit einem PagerDuty-Trigger zu erstellen oder zu bearbeiten, müssen Sie zuerst [Ihr PagerDuty-Nutzerkonto verbinden](#connecting-your-pagerduty-user-account). Ihr PagerDuty-Nutzer muss zu dem PagerDuty-Konto gehören, das Ihre Organisation verbunden hat.