Skip to main content
Conecte o PagerDuty para que o Devin comece a trabalhar assim que um incidente for aberto. Incidentes do PagerDuty acionam automações do Devin, e o servidor MCP do PagerDuty dá às sessões do Devin acesso a incidentes, serviços e escalas de plantão. A página do PagerDuty em Conexões tem três seções, e o PagerDuty só fica totalmente configurado quando as três estiverem concluídas:
  • Connection: a chave de API REST que o Devin usa para publicar notas e atualizações nos incidentes.
  • Webhook: envia eventos de incidentes para o Devin acionar automações.
  • App registration: configura o servidor MCP do PagerDuty e permite que os membros conectem suas contas do PagerDuty.

​
Configurando a integração

  1. No PagerDuty, acesse Integrations > API Access Keys e clique em “Create New API Key”. Crie uma chave General Access com acesso total e copie-a. Tokens de API de usuário não são aceitos.
  2. Na sua conta do Devin em app.devin.ai, acesse Configurações > Connections > PagerDuty e clique em “Connect”.
  3. Selecione a sua região de API (US ou EU) e informe:
    • E-mail do ator: o usuário do PagerDuty a quem as notas e atualizações de incidentes do Devin serão atribuídas. Recomendamos um service user dedicado.
    • Chave de API REST General Access: a chave que você criou na etapa 1.
  4. Clique em “Connect”. O Devin cria automaticamente uma assinatura de webhook no PagerDuty para poder receber eventos de incidentes.

​
Configure as assinaturas de webhook

Ao conectar, o Devin cria uma assinatura de webhook no nível da conta no PagerDuty. Ela envia estes eventos para o Devin:
  • incident.triggered
  • incident.acknowledged
  • incident.resolved
  • incident.priority_updated
  • incident.reassigned
  • incident.service_updated
A seção Webhook da página de configurações mostra o status da assinatura. Se a configuração automática falhar, clique em “Retry webhook setup” ou adicione o webhook manualmente:
  1. Na seção Webhook, clique em “Add webhook” e copie a URL do webhook.
  2. No PagerDuty, acesse Integrations > Generic Webhooks (v3) e adicione um webhook que aponte para essa URL com escopo Account.
  3. Selecione os tipos de evento de incidente listados acima.
  4. Copie o signing secret que o PagerDuty exibe uma única vez, cole-o no Devin e clique em “Save”.
Desconectar o PagerDuty interrompe os eventos de incidente e exclui a assinatura de webhook criada pelo Devin. Isso não remove o app registration nem o servidor MCP do PagerDuty.

​
Registre o Devin como um OAuth app

O servidor MCP do PagerDuty autentica cada membro via OAuth. O PagerDuty não oferece suporte ao registro automático de OAuth client, portanto um admin precisa registrar o Devin como um OAuth app no PagerDuty e adicioná-lo em App registration nas Conexões. Ao salvar o registro do app, o servidor MCP do PagerDuty é configurado automaticamente para você.

​
Crie o app no PagerDuty

  1. Em Configurações > Connections > PagerDuty, copie a Redirect URI exibida na seção App registration.
  2. No PagerDuty, acesse Integrations > App Registration e clique em “New App”. Informe um nome, como Devin, e selecione OAuth 2.0.
  3. Selecione Scoped OAuth e adicione a redirect URI do Devin como uma Redirect URL.
  4. Em permission scopes, selecione os escopos que você quer conceder ao Devin. Recomendamos abilities.read, escalation_policies.read, incidents.read, incidents.write, oncalls.read, priorities.read, schedules.read, services.read, teams.read e users.read.
  5. Registre o app e, em seguida, copie o client ID e o client secret.

​
Adicione o registro do app no Devin

  1. Na seção App registration, insira o Client ID e o Client secret do seu app do PagerDuty.
  2. Selecione a região de API da sua conta do PagerDuty (US ou EU).
  3. Deixe Scopes em branco para usar as permissões configuradas no seu app do PagerDuty. Para requisitar apenas algumas delas, insira uma lista de escopos separados por espaço que estejam ativados no app.
  4. Clique em “Save”.
Em seguida, o Devin adiciona o servidor MCP do PagerDuty correspondente à sua região. Em contas enterprise, ele é adicionado uma única vez para toda a enterprise e fica disponível em todas as organizações. Nos demais casos, ele é adicionado à sua organização. Se já houver um servidor MCP do PagerDuty instalado, o Devin não adiciona outro.
Alterar o client ID ou a região desconecta a conta do PagerDuty de todos os membros. Cada membro precisará se conectar novamente.

​
Servidores MCP do PagerDuty existentes

Um servidor MCP do PagerDuty instalado com client ID e segredo próprios continua funcionando, e os membros que já se conectaram por meio dele permanecem conectados. A seção App registration exibe um aviso de que ele não está totalmente conectado. Para fazer a migração, adicione o app registration e clique em “Use app registration” no aviso. Depois disso, os membros conectam novamente suas contas do PagerDuty por meio do app registration.

​
Conectando sua conta de usuário do PagerDuty

Além da integração no nível da organização, cada membro da equipe vincula sua própria conta do PagerDuty à sua conta do Devin. Isso permite que o Devin use o servidor MCP do PagerDuty como aquele membro. Isso também é necessário para criar automações do PagerDuty. Para conectar sua conta de usuário, acesse Personal Connections, clique em “Connect” ao lado de PagerDuty e aprove o acesso no PagerDuty. Use um usuário do PagerDuty pertencente à conta do PagerDuty que sua organização conectou.
Os membros só podem se conectar depois que um admin tiver adicionado o app registration. O acesso ao MCP do PagerDuty é sempre pessoal: o Devin nunca usa um token compartilhado da organização para isso, então cada membro precisa conectar sua própria conta de usuário do PagerDuty antes que o Devin possa usar as ferramentas do PagerDuty em suas sessões.

​
Acionando o Devin a partir do PagerDuty

O Devin começa a trabalhar nos incidentes do PagerDuty por meio de automações. Depois que o PagerDuty estiver conectado, não é necessário configurar um webhook separado para cada automação.
  1. Acesse Automations e crie uma nova automação.
  2. Adicione um trigger, escolha PagerDuty e selecione um evento:
    • Incident triggered: um novo incidente é aberto.
    • Incident acknowledged: alguém reconhece um incidente.
    • Incident resolved: um incidente é resolvido.
    • Incident updated: a prioridade, a atribuição ou o serviço de um incidente muda.
  3. Se quiser, adicione condições para restringir quais incidentes se aplicam:
    • Service, Team e Priority: as opções são carregadas da sua conta do PagerDuty.
    • Urgency (high ou low) e Status.
    • Title, Escalation policy e Assignee.
    • Change (priority, assignment ou service): apenas para Incident updated.
  4. Adicione uma ação Start session com instruções para o Devin e salve.
Por exemplo, para investigar incidentes de alta urgência no seu serviço de checkout, use o evento Incident triggered com as condições Service igual a checkout-api e Urgency igual a high. Depois, adicione um prompt como: “Investigue este incidente. Verifique os deploys recentes e os logs de erro do checkout-api e identifique a provável causa raiz.”
Para criar ou editar uma automação com um trigger do PagerDuty, é preciso primeiro conectar sua conta de usuário do PagerDuty. Seu usuário do PagerDuty deve pertencer à conta do PagerDuty que sua organização conectou.