> ## 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 統合

> PagerDuty を Devin に接続して、インシデントから自動化をトリガーし、Devin のセッションにインシデント、サービス、オンコールスケジュールへのアクセスを付与します。

PagerDuty を接続すれば、インシデントが発生した時点で Devin がすぐに作業を開始できます。PagerDuty のインシデントは Devin の[自動化](https://docs.devin.ai/ja/product-guides/automations.md)と [Devin Oncall](https://docs.devin.ai/ja/product-guides/devin-oncall.md) のレスポンダーをトリガーし、PagerDuty MCP サーバーを介して Devin のセッションがインシデント、サービス、オンコールスケジュールにアクセスできるようになります。

Connections の PagerDuty ページには 3 つのセクションがあり、3 つすべてを完了すると PagerDuty のセットアップが完了します。

* **Connection**: Devin がインシデントノートや更新を投稿するために利用する REST APIキー。
* **Webhook**: インシデントイベントを Devin に送信し、自動化をトリガーします。
* **アプリの登録**: PagerDuty MCP サーバーを設定し、メンバーが自分の PagerDuty アカウントを接続できるようにします。

## 統合のセットアップ

1. PagerDutyで **Integrations > API Access Keys** に移動し、「Create New API Key」をクリックします。フルアクセス権限を持つ **General Access** キーを作成し、コピーします。ユーザーAPIトークンは利用できません。
2. app.devin.ai のDevinアカウントで [Settings > Connections > PagerDuty](https://app.devin.ai/settings/connections/pagerduty) に移動し、「Connect」をクリックします。
3. **API region** (USまたはEU) を選択し、次の項目を入力します。
   * **Actor email**: Devinのインシデントノートや更新の実行者として記録されるPagerDutyユーザーです。専用のサービスユーザーの利用を推奨します。
   * **General Access REST API key**: ステップ1で作成したキーです。
4. 「Connect」をクリックします。Devinはインシデントイベントを受信できるよう、PagerDutyにWebhookサブスクリプションを自動的に作成します。

## Webhook サブスクリプションを設定する

接続すると、Devin は PagerDuty にアカウント全体の Webhook サブスクリプションを 1 つ作成し、以下のイベントを Devin に送信します。

* `incident.triggered`
* `incident.acknowledged`
* `incident.resolved`
* `incident.priority_updated`
* `incident.reassigned`
* `incident.service_updated`

設定ページの **Webhook** セクションでは、サブスクリプションのステータスを確認できます。自動セットアップに失敗した場合は、「Retry webhook setup」をクリックするか、以下の手順で Webhook を手動で追加してください。

1. **Webhook** セクションで「Add webhook」をクリックし、Webhook URL をコピーします。
2. PagerDuty で **Integrations > Generic Webhooks (v3)** に移動し、その URL を宛先とする Webhook を **Account** スコープで追加します。
3. 上記のインシデントイベントタイプを選択します。
4. PagerDuty に一度だけ表示される署名シークレットをコピーして Devin に貼り付け、「Save」をクリックします。

> [!NOTE]
>
> PagerDuty の接続を解除すると、インシデントイベントの送信が停止し、Devin が作成した Webhook サブスクリプションが削除されます。ただし、アプリ登録や PagerDuty MCP サーバーは削除されません。

## Devin を OAuth アプリとして登録する

PagerDuty MCP サーバーでは、各メンバーが OAuth でサインインします。PagerDuty は OAuth クライアントの自動登録に対応していないため、管理者が PagerDuty で Devin を OAuth アプリとして登録し、Connections の **App registration** に追加してください。アプリ登録を保存すると、PagerDuty MCP サーバーのセットアップが完了します。

### PagerDuty でアプリを作成する

1. [Settings > Connections > PagerDuty](https://app.devin.ai/settings/connections/pagerduty) で、**App registration** セクションに表示される **Redirect URI** をコピーします。
2. PagerDuty で **Integrations > App Registration** に移動し、「New App」をクリックします。`Devin` などの名前を入力し、**OAuth 2.0** を選択します。
3. **Scoped OAuth** を選択し、Devin でコピーした redirect URI を **Redirect URL** として追加します。
4. 権限スコープでは、Devin に付与するスコープを選択します。`abilities.read`、`escalation_policies.read`、`incidents.read`、`incidents.write`、`oncalls.read`、`priorities.read`、`schedules.read`、`services.read`、`teams.read`、`users.read` を推奨します。
5. アプリを登録し、**client ID** と **client secret** をコピーします。

### Devin にアプリ登録を追加する

1. **App registration** セクションで、PagerDuty アプリの **Client ID** と **Client secret** を入力します。
2. PagerDuty アカウントの **API region**(US または EU)を選択します。
3. PagerDuty アプリで設定済みの権限をそのまま利用する場合は、**Scopes** を空のままにします。一部の権限のみを要求する場合は、アプリで有効になっているスコープをスペース区切りで入力します。
4. 「Save」をクリックします。

これにより、Devin が該当リージョンの PagerDuty MCP サーバーを追加します。Enterprise アカウントの場合は enterprise 全体に対して一度だけ追加され、すべての組織で利用できます。それ以外の場合は、お使いの組織に追加されます。PagerDuty MCP サーバーがすでにインストールされている場合、Devin が重複して追加することはありません。

> [!NOTE]
>
> client ID またはリージョンを変更すると、すべてのメンバーの PagerDuty アカウントの接続が解除されます。各メンバーは改めて接続し直す必要があります。

### 既存の PagerDuty MCP サーバー

独自の OAuth クライアント ID とシークレットでインストールした PagerDuty MCP サーバーはそのまま動作し、すでにそのサーバー経由で接続済みのメンバーも接続は維持されます。ただし、**App registration** セクションには、完全には接続されていない旨の警告が表示されます。

切り替えるには、アプリ登録を追加したうえで、警告内の「Use app registration」をクリックします。その後、メンバーはアプリ登録経由で PagerDuty アカウントを接続し直します。

### クライアント認証情報による共有アクセス

Enterprise 管理者は、代わりに **クライアント認証情報** グラントタイプを使用して、PagerDuty を Enterprise MCP サーバーとして追加することもできます。この場合、すべてのセッションで共有のアプリトークン 1 つを利用するため、メンバーはサインインする必要がありません。PagerDuty でこのグラントタイプを使用する場合は **OAuth scope** フィールドの指定が必須で、その値はアカウントのセレクターで始まっている必要があります。

```text theme={null}
as_account-<region>.<subdomain> <scopes>
```

`<region>` は `us` または `eu`、`<subdomain>` は PagerDuty の URL のうち `.pagerduty.com` より前の部分です。その後に、アプリで有効化されているスコープをスペース区切りで列挙します。PagerDuty MCP サーバーがトークンを受け付けるには `users.read` が必要です。そのため、アプリにこのスコープを付与したうえで、リストにも含めてください。例: `as_account-us.acme users.read incidents.read oncalls.read schedules.read services.read`。スコープが欠落しているか形式が正しくない場合はトークンを発行できず、Customize でそのサーバーに **Connect** と表示されます。

> [!NOTE]
>
> クライアント認証情報は読み取り専用です。書き込みにはユーザー ID が必要なため、`*.write` スコープが付与されていても、PagerDuty はアプリトークンからの書き込み操作(例: `manage_incidents`)を拒否します。`*.read` スコープのみをリクエストしてください。書き込みアクセスが必要な場合は、個人接続を利用するか、専用の PagerDuty ボットユーザーとして接続した組織レベルの Authorization code サーバーを利用してください。

## PagerDuty のユーザーアカウントを接続する

組織レベルの統合に加えて、各チームメンバーは自分の PagerDuty アカウントを Devin アカウントに連携します。これにより、Devin はそのメンバーとして PagerDuty MCP サーバーを利用できるようになります。また、PagerDuty の自動化を作成するにはこの連携が必須です。

ユーザーアカウントを接続するには、[Personal Connections](https://app.devin.ai/account/connections) を開き、PagerDuty の横にある「Connect」をクリックして、PagerDuty 側でアクセスを承認してください。その際は、組織が接続した PagerDuty アカウント内のユーザーを利用してください。

> [!NOTE]
>
> メンバーが接続できるのは、管理者が [アプリ登録](#register-devin-as-an-oauth-app) を追加した後のみです。アプリ登録を介した PagerDuty MCP のアクセスは常に個人単位です。Devin は共有の組織トークンを利用しないため、各メンバーが自分の PagerDuty ユーザーアカウントを接続しない限り、Devin はそのメンバーのセッションで PagerDuty のツールを利用できません。ただし、[クライアント認証情報](#shared-access-with-client-credentials) を利用する Enterprise の MCP サーバーは例外です。

## PagerDuty から Devin をトリガーする

Devin は [自動化](https://docs.devin.ai/ja/product-guides/automations.md) を通じて PagerDuty のインシデントへの対応を開始します。PagerDuty を連携すれば、自動化ごとに個別の Webhook を設定する必要はありません。

1. **Automations** に移動し、新しい自動化を作成します。
2. トリガーを追加し、**PagerDuty** を選択して、イベントを選びます。
   * **Incident triggered**: 新しいインシデントが発生したとき。
   * **Incident acknowledged**: 誰かがインシデントを確認したとき。
   * **Incident resolved**: インシデントが解決されたとき。
   * **Incident updated**: インシデントの優先度、担当者、またはサービスが変更されたとき。
3. 必要に応じて条件を追加し、対象となるインシデントを絞り込みます。
   * **Service**、**Team**、**Priority**: PagerDuty アカウントから選択肢が読み込まれます。
   * **Urgency** (`high` または `low`) と **Status**。
   * **Title**、**Escalation policy**、**Assignee**。
   * **Change** (`priority`、`assignment`、`service`) : **Incident updated** の場合のみ。
4. Devin への指示を記述した **Start session** アクションを追加し、保存します。

たとえば、チェックアウトサービスで緊急度の高いインシデントを調査するには、**Incident triggered** イベントを使用し、条件として **Service** が `checkout-api`、**Urgency** が `high` を指定します。そのうえで、次のようなプロンプトを追加します。「このインシデントを調査してください。checkout-api の直近のデプロイとエラーログを確認し、考えられる根本原因を特定してください。」

> [!NOTE]
>
> PagerDuty トリガーを含む自動化を作成または編集するには、まず [PagerDuty ユーザーアカウントを連携](#connecting-your-pagerduty-user-account) する必要があります。ご利用の PagerDuty ユーザーは、組織が連携した PagerDuty アカウントに所属している必要があります。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.