Skip to main content
Connectez PagerDuty pour que Devin puisse se mettre au travail dès qu’un incident survient. Les incidents PagerDuty déclenchent les automatisations de Devin, et le serveur MCP PagerDuty donne aux sessions Devin l’accès aux incidents, aux services et aux planifications d’astreinte. La page PagerDuty dans Connections comporte trois sections, et PagerDuty est entièrement configuré une fois les trois terminées :
  • Connection : la clé d’API REST que Devin utilise pour publier des notes et des mises à jour d’incident.
  • Webhook : envoie les événements d’incident à Devin pour déclencher des automatisations.
  • App registration : configure le serveur MCP PagerDuty et permet aux members de connecter leurs comptes PagerDuty.

Configuration de l’intégration

  1. Dans PagerDuty, rendez-vous dans Integrations > API Access Keys et cliquez sur « Create New API Key ». Créez une clé General Access avec un accès complet, puis copiez-la. Les tokens d’API utilisateur ne sont pas acceptés.
  2. Dans votre compte Devin sur app.devin.ai, rendez-vous dans Settings > Connections > PagerDuty, puis cliquez sur « Connect ».
  3. Sélectionnez votre région d’API (US ou EU), puis saisissez :
    • Actor email : l’utilisateur PagerDuty auquel sont attribuées les notes et mises à jour d’incident de Devin. Nous vous recommandons d’utiliser un utilisateur de service dédié.
    • General Access REST API key : la clé que vous avez créée à l’étape 1.
  4. Cliquez sur « Connect ». Devin crée automatiquement un abonnement webhook dans PagerDuty afin de pouvoir recevoir les événements d’incident.

Configurer les abonnements aux webhooks

Lors de la connexion, Devin crée un abonnement webhook à l’échelle du compte dans PagerDuty. Celui-ci envoie les événements suivants à Devin :
  • incident.triggered
  • incident.acknowledged
  • incident.resolved
  • incident.priority_updated
  • incident.reassigned
  • incident.service_updated
La section Webhook de la page Settings affiche le statut de l’abonnement. Si la configuration automatique échoue, cliquez sur « Retry webhook setup » ou ajoutez le webhook manuellement :
  1. Dans la section Webhook, cliquez sur « Add webhook » et copiez l’URL du webhook.
  2. Dans PagerDuty, allez dans Integrations > Generic Webhooks (v3) et ajoutez un webhook pointant vers cette URL avec le périmètre Account.
  3. Sélectionnez les types d’événements d’incident énumérés ci-dessus.
  4. Copiez le secret de signature que PagerDuty n’affiche qu’une seule fois, collez-le dans Devin, puis cliquez sur « Save ».
La déconnexion de PagerDuty interrompt les événements d’incident et supprime l’abonnement webhook créé par Devin. Elle ne supprime pas pour autant l’App Registration ni le serveur MCP PagerDuty.

Enregistrer Devin en tant qu’application OAuth

Le serveur MCP PagerDuty connecte chaque Member via OAuth. PagerDuty ne prend pas en charge l’enregistrement automatique des clients OAuth : un admin doit donc enregistrer Devin en tant qu’application OAuth dans PagerDuty, puis l’ajouter sous App Registration dans Connections. L’App Registration configure automatiquement le serveur MCP PagerDuty pour vous.

Créer l’application dans PagerDuty

  1. Dans Settings > Connections > PagerDuty, copiez la Redirect URI affichée dans la section App registration.
  2. Dans PagerDuty, rendez-vous dans Integrations > App Registration et cliquez sur « New App ». Saisissez un nom, par exemple Devin, puis sélectionnez OAuth 2.0.
  3. Sélectionnez Scoped OAuth, puis ajoutez la redirect URI fournie par Devin comme Redirect URL.
  4. Dans les périmètres d’autorisation, sélectionnez les périmètres que vous souhaitez accorder à Devin. Nous vous recommandons d’utiliser abilities.read, escalation_policies.read, incidents.read, incidents.write, oncalls.read, priorities.read, schedules.read, services.read, teams.read et users.read.
  5. Enregistrez l’application, puis copiez le client ID et le client secret.

Ajouter l’App Registration dans Devin

  1. Dans la section App registration, saisissez le Client ID et le Client secret de votre application PagerDuty.
  2. Sélectionnez l’API region de votre compte PagerDuty (US ou EU).
  3. Laissez le champ Scopes vide pour utiliser les autorisations configurées sur votre application PagerDuty. Pour n’en demander qu’une partie, saisissez une liste de périmètres séparés par des espaces parmi ceux activés sur l’application.
  4. Cliquez sur « Save ».
Devin ajoute ensuite le serveur MCP PagerDuty correspondant à votre région. Sur les comptes enterprise, il n’est ajouté qu’une seule fois pour l’ensemble de l’enterprise et reste disponible dans chaque organisation. Sinon, il est ajouté à votre organisation. Si un serveur MCP PagerDuty est déjà installé, Devin n’en ajoute pas de second.
Modifier le client ID ou la région déconnecte le compte PagerDuty de chaque member. Chaque member doit alors se reconnecter.

Serveurs MCP PagerDuty existants

Un serveur MCP PagerDuty installé avec ses propres client ID et secret OAuth continue de fonctionner, et les Members qui s’y sont déjà connectés le restent. La section App registration affiche un avertissement signalant qu’il n’est pas entièrement connecté. Pour effectuer la bascule, ajoutez l’App Registration, puis cliquez sur « Use app registration » dans l’avertissement. Les Members reconnectent ensuite leurs comptes PagerDuty via l’App Registration.

Accès partagé avec des credentials client

Les Enterprise Admin peuvent aussi ajouter PagerDuty comme serveur MCP Enterprise avec le type de grant Client credentials : les sessions utilisent alors un seul token d’application partagé, et les membres n’ont pas besoin de se connecter. Pour ce grant, PagerDuty exige que le champ OAuth scope soit renseigné, et sa valeur doit commencer par le sélecteur de votre compte :
<region> vaut us ou eu, et <subdomain> correspond à la partie de votre URL PagerDuty qui précède .pagerduty.com. Cette valeur est suivie de la liste des périmètres activés sur l’application, séparés par des espaces. Le serveur MCP PagerDuty exige users.read pour accepter le token : l’application doit donc disposer de ce périmètre, et celui-ci doit figurer dans la liste. Par exemple : as_account-us.acme users.read incidents.read oncalls.read schedules.read services.read. Si le périmètre est absent ou mal formé, le token ne peut pas être généré et le serveur affiche Connect dans Customize.
Les client credentials ne donnent qu’un accès en lecture seule. PagerDuty rejette les opérations d’écriture (par exemple manage_incidents) effectuées avec un token d’application, même si des périmètres *.write ont été accordés, car les écritures nécessitent une identité utilisateur. Ne demandez que des périmètres *.read. Pour un accès en écriture, utilisez des connexions personnelles ou un serveur Authorization code au niveau de l’organisation, connecté avec un utilisateur bot PagerDuty dédié.

Connexion de votre compte utilisateur PagerDuty

En plus de l’intégration au niveau de l’organisation, chaque membre de l’équipe relie son propre compte PagerDuty à son compte Devin. Devin peut ainsi utiliser le serveur MCP PagerDuty en tant que ce membre. C’est également requis pour créer des automatisations PagerDuty. Pour connecter votre compte utilisateur, rendez-vous dans Personal Connections, cliquez sur « Connect » en regard de PagerDuty, puis approuvez l’accès dans PagerDuty. Utilisez un utilisateur PagerDuty appartenant au compte PagerDuty connecté par votre organisation.
Les membres ne peuvent se connecter qu’une fois qu’un administrateur a ajouté l’app registration. L’accès MCP à PagerDuty via l’app registration est toujours personnel : Devin n’utilise jamais de token d’organisation partagé pour cela, donc chaque membre doit connecter son propre compte utilisateur PagerDuty avant que Devin puisse utiliser les outils PagerDuty dans ses sessions. Seule exception : un serveur MCP Enterprise utilisant des credentials client.

Activer Devin depuis PagerDuty

Devin commence à travailler sur les incidents PagerDuty via les automatisations. Une fois PagerDuty connecté, vous n’avez pas besoin de configurer un webhook distinct pour chaque automatisation.
  1. Accédez à automatisation et créez une nouvelle automatisation.
  2. Ajoutez un trigger, choisissez PagerDuty, puis sélectionnez un événement :
    • Incident triggered : un nouvel incident est ouvert.
    • Incident acknowledged : quelqu’un prend en charge un incident.
    • Incident resolved : un incident est résolu.
    • Incident updated : la priorité, l’attribution ou le service d’un incident change.
  3. Vous pouvez aussi ajouter des conditions pour cibler certains incidents :
    • Service, Team et Priority : les options sont chargées depuis votre compte PagerDuty.
    • Urgency (high ou low) et Status.
    • Title, Escalation policy et Assignee.
    • Change (priority, assignment ou service) : pour Incident updated uniquement.
  4. Ajoutez une action Start session avec des instructions pour Devin, puis enregistrez.
Par exemple, pour enquêter sur les incidents de forte urgence concernant votre service de paiement, utilisez l’événement Incident triggered avec les conditions Service égal à checkout-api et Urgency égal à high. Ajoutez ensuite un prompt du type : « Enquête sur cet incident. Vérifie les déploiements récents et les log d’erreurs de checkout-api, puis identifie la cause racine probable. »
Pour créer ou modifier une automatisation avec un trigger PagerDuty, vous devez d’abord connecter votre compte utilisateur PagerDuty. Votre utilisateur PagerDuty doit appartenir au compte PagerDuty connecté par votre organisation.