> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PagerDuty 統合

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

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

<div id="setting-up-the-integration">
  ## 統合のセットアップ
</div>

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サブスクリプションを自動的に作成します。

<div id="configure-webhook-subscriptions">
  ## Webhook サブスクリプションを設定する
</div>

接続すると、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 サーバーは削除されません。
</Note>

<div id="setting-up-the-pagerduty-mcp-server">
  ## PagerDuty MCP サーバーのセットアップ
</div>

PagerDuty MCP サーバーでは、各メンバーが OAuth でサインインします。PagerDuty は OAuth クライアントの自動登録に対応していないため、管理者が PagerDuty で OAuth アプリを登録し、そのクライアント ID とシークレットを Devin に登録してください。

<div id="register-an-oauth-app-in-pagerduty">
  ### PagerDuty で OAuth アプリ を登録する
</div>

1. [Settings > Connections > PagerDuty](https://app.devin.ai/settings/connections/pagerduty) で、**MCP サーバー** セクションの「Set up with OAuth」をクリックします。セットアップページに表示される **OAuth callback URL** をコピーします。
2. PagerDuty で **Integrations > App Registration** に移動し、「New App」をクリックします。`Devin` などの名前を入力し、**OAuth 2.0** を選択します。
3. **Scoped OAuth** を選択し、Devin でコピーした OAuth callback URL を **Redirect URL** として追加します。
4. 権限スコープでは、**Read Access** のスコープをすべて選択します。Devin に書き込みアクセスは不要です。
5. **Selected Permission Scope** の値をコピーします。この値は MCP サーバーのインストール時に入力します。
6. アプリを登録し、**client ID** と **client secret** をコピーします。

<div id="install-the-mcp-server">
  ### MCP サーバーをインストールする
</div>

1. Devin のセットアップページで、利用するリージョンの **server URL** を選択します。米国の場合は `mcp.pagerduty.com`、EU の場合は `mcp.eu.pagerduty.com` です。
2. PagerDuty アプリの **OAuth client ID** と **OAuth client secret** を入力します。
3. PagerDuty アプリの **Selected Permission Scope** の値を **OAuth scope** に貼り付けます。
4. インストール内容を保存します。

<Note>
  PagerDuty の MCP access は常に個人単位です。Devin が組織で共有されたトークンを利用することはありません。各メンバーが自分の PagerDuty ユーザーアカウントを接続するまで、Devin はそのセッションで PagerDuty のツールを利用できません。
</Note>

<div id="connecting-your-pagerduty-user-account">
  ## PagerDuty のユーザーアカウントを接続する
</div>

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

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

<div id="triggering-devin-from-pagerduty">
  ## PagerDuty から Devin をトリガーする
</div>

Devin は [自動化](/ja/product-guides/automations) を通じて 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 アカウントに所属している必要があります。
</Note>