Claude Media
PagerDutyのオンコールスケジュールをClaudeで管理する — On-Call Managerの使い方
ClaudeClaude連携チュートリアル

PagerDutyのオンコールスケジュールをClaudeで管理する — On-Call Managerの使い方

PagerDutyの実験的アプリOn-Call Managerを使い、スケジュールと上書きをダッシュボード形式でClaudeから操作する手順をまとめます。

読了目安 約10分

PagerDutyのOn-Call Managerとは何か

On-Call Managerは、オンコールスケジュールと上書き(override)をチャット画面の中で操作できるダッシュボードです。VS CodeやClaude Desktopを離れずに、誰が今オンコールかを見て、上書きを作って、エスカレーションポリシーを確認できます。

土台はMCP Appsという拡張です。通常のMCPツールは文字で結果を返すだけですが、MCP Appsはチャット欄にサンドボックス化されたiframeを埋め込みます。アプリはMCPサーバーのツールを呼んでデータを読み書きでき、サーバー側から画面を更新することもできます。PagerDuty固有の機能ではなく、MCP全体の拡張です。

配布形態の確認 — 使い始める前の判断材料

On-Call Managerは、PagerDutyの自己ホスト型MCPサーバー(GitHubのpagerduty-mcp-server)に入っているアプリです。このリポジトリは現在アーカイブ済みで読み取り専用です。PagerDutyのサポートページにも、自己ホスト型は非推奨になったと書かれています。

通常の連携先として案内されているのは、PagerDutyがホストするhttps://mcp.pagerduty.com/mcpです。EUアカウントはhttps://mcp.eu.pagerduty.com/mcpを使います。インストール不要で、OAuthとAPIキーの両方に対応します。ただしOn-Call Managerの起動手順が載っているのはexperimentalブランチ用のページだけで、ホスト版の設定ページは接続先と認証の手順を扱っています。

本番のオンコール運用に載せる前に、次の判断が要ります。

  • 検証用のPagerDutyアカウントや、影響の小さいスケジュールで試せるか
  • 不具合が出たとき、PagerDuty本体の画面で同じ操作に戻れるか
  • ホスト版のMCPサーバーで足りる操作(一覧の確認など)ではないか

APIトークンを用意する

必要なものは、PagerDutyのユーザーAPIトークンと、グローバルにインストールしたuvです。READMEの前提条件にはasdf-vmも挙がっています。トークンは次の順に発行します。

手順

ユーザーAPIトークンの発行

  1. 1

    プロフィールからUser Settingsを開く

    右上のユーザーアイコンから「My Profile」を選び、続けて「User Settings」を開きます。

  2. 2

    API Accessでトークンを作る

    「API Access」欄にある「Create API User Token」を選び、案内に従って発行します。

  3. 3

    トークンをその場で保管する

    生成されたトークンはコピーして安全に保管します。後のMCPサーバー設定で使います。

Freemiumアカウントでは、ユーザーAPIトークンを発行できる範囲がユーザーロールに限られると、READMEに書かれています。ボタンが見つからないときは、まずアカウントのプランとロールを確認します。

Claude Desktopに登録する

Claude Desktopの設定ファイルは、macOSでは~/Library/Application Support/Claude/の下にあります。Windowsでは%APPDATA%\Claude\の下です。ファイル名はどちらもclaude_desktop_config.jsonです。

commandにuvx、argsに実験用ブランチの指定を書き、トークンはenvに渡します。

{
  "mcpServers": {
    "pagerduty": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/PagerDuty/pagerduty-mcp-server@experimental",
        "pagerduty-mcp",
        "--enable-write-tools"
      ],
      "env": {
        "PAGERDUTY_USER_API_KEY": "your-token"
      }
    }
  }
}

保存したらClaude Desktopを完全に再起動します。READMEの手順にも「completely」とあり、一度終了して起動し直す形です。設定したコマンドが通るかを手元で試したいときは、同じ内容をターミナルで実行できます。

PAGERDUTY_USER_API_KEY="your-token" \
  uvx --from git+https://github.com/PagerDuty/pagerduty-mcp-server@experimental \
  pagerduty-mcp --enable-write-tools

アカウントがEUリージョンなら、envにPAGERDUTY_API_HOSTとしてhttps://api.eu.pagerduty.comを加えます。READMEの設定例は、既定のhttps://api.pagerduty.comを明示する形です。

READMEには、Claude Desktopの設定ファイルにAPIキーを平文で置く点への注意もあります。ファイルを自分のユーザーだけが読める権限にしておく運用が書かれています。VS Codeの設定例では、キーを入力プロンプトで渡して安全に保持できます。

VS Codeで使う場合は、ChatをAgentモードにして、コマンドパレットのMCP: List Serversでサーバーが起動しているかを確かめます。READMEにある手順です。

登録後、会話で次のように呼びかけるとダッシュボードが開きます。

Show me the on-call manager

画面の4つのタブ

「My On-Calls」は、自分が今オンコールのスケジュールとシフトの開始・終了時刻を並べるタブです。

「Schedules」は組織のスケジュール一覧で、各行に現在の担当者が出ます。クリックすると詳細モーダルが開きます。「Overrides」は有効中と予定中の上書きの一覧です。「Escalation Policies」は、ポリシーごとのサービス割り当てとオンコールの階層(layer)を並べます。

上書きを作る・直す・消す

担当交代の上書きは「Overrides」タブから作ります。

手順

上書きの作成

  1. 1

    Overridesタブで New Override を押す

    OverridesタブのNew Overrideボタンから、作成用のモーダルが開きます。

  2. 2

    スケジュール・代わりの担当者・時刻を選ぶ

    対象のスケジュール、カバーに入るユーザー、開始と終了の時刻を指定します。

  3. 3

    Saveで確定する

    PagerDuty側に上書きがすぐ作られます。

既存の上書きは、行をクリックすると編集モーダルが開きます。説明ページには、時刻の変更と削除ができると書かれています。担当者を変えたいときは、削除して作り直す前提で考えます。

公式ページ同士で食い違う点

On-Call Managerの説明は、複数のページに分かれています。突き合わせると、次の2点で記述が揃っていません。

くらべる

アプリの説明と、ツール一覧の記述

experimental docs

アプリの説明ページ

上書きの編集・削除ができ、エスカレーションポリシーは「view and manage」と書かれています。概要ページでは、On-Call Managerに「coverage wizards」も含まれると紹介されています。

experimentalブランチ

READMEのツール一覧

上書き関連はcreate_schedule_overrideだけで、編集・削除用のツールは載っていません。エスカレーションポリシーはlist_escalation_policiesとget_escalation_policyの2つで、どちらも読み取り専用です。

この食い違いから言えるのは、画面に編集ボタンがあっても、書き込めるかどうかはツール側の対応で決まる、という点です。アプリの説明ページ自体、ポリシーの項で書いている操作は階層・通知ルール・サービス割り当ての確認です。ポリシーの変更はPagerDuty本体の管理画面で行うものと考えておくと安全です。

対応クライアントについては、アプリの説明ページがVS Code(GitHub Copilot)・Claude Desktop・Gooseの3つを表にしています。Claude Desktopの基本はClaude Desktopとは、CLI側の使い方はClaude Codeにあります。

書き込みフラグが開けるものの範囲

READMEは、MCPサーバーが既定では読み取り専用ツールだけを公開すると書いています。変更系ツールは--enable-write-toolsを付けたときにだけ有効になります。

注意したいのは、フラグの効く範囲がスケジュールに限られない点です。READMEのツール表では、create_incident、delete_team、create_service、manage_incidentsの変更系ツールが同じフラグの下にあります。ステータスページへの投稿も同様です。On-Call Managerのために付けたフラグが、同じ会話でインシデントやチームを書き換えられる状態も作ります。

読み取り中心で使うなら、フラグを外して起動する選択肢があります。この場合は変更系ツールが公開されないので、上書きの作成・編集・削除はできません。VS Codeでは、Agentモードのツールアイコンから個別のツールを有効・無効にできると、READMEに書かれています。

スケジュール関連のツール

READMEのツール表で、スケジュールに関わるものは次の6つと、オンコール一覧のlist_oncallsです。

ツール読み取り専用役割
list_oncalls読み取り専用はい役割オンコールのスケジュールを一覧する
list_schedules読み取り専用はい役割スケジュール一覧を取得する
get_schedule読み取り専用はい役割指定したスケジュールを取得する
list_schedule_users読み取り専用はい役割スケジュールのユーザーを一覧する
create_schedule読み取り専用いいえ役割新しいスケジュールを作る
update_schedule読み取り専用いいえ役割既存のスケジュールを更新する
create_schedule_override読み取り専用いいえ役割上書きを作る

アプリの説明ページは「スケジュールと上書きのツールを呼ぶ」という説明にとどまり、画面操作とツール名の対応はこの表から読み取る形になります。会話だけでスケジュールを変える使い方はClaudeとPagerDutyを連携してインシデント対応を自動化するで扱っています。

同じブランチには、On-Call Compensation Reportというアプリもあります。担当者ごとのオンコール時間、対応したインシデント数、時間外の中断、コンプライアンス状況、公平性のスコアを表にするレポートです。上書きで担当を動かす前に偏りを見たい場面では、こちらのほうが材料になります。

実験的な配布が運用に及ぼす影響

障害時の対処は、機能そのものより配布形態で決まります。アーカイブされたGitHubリポジトリは読み取り専用なので、新しいIssueやコミットが入りません。アプリの説明ページはexperimentalタグ付きのIssueで報告するよう案内していますが、この導線では報告できません。

サポートについても、READMEはオープンソースプロジェクトとしてコミュニティベースの支援のみと述べています。experimentalのアプリは、標準のサポートポリシーの対象外とも書かれています。壊れても公式の修正を待つ前提は置けません。

チームの本番オンコール運用をこのアプリだけに任せる構成は、この前提と合いません。PagerDuty本体の管理画面で同じ上書きを作れる状態を残しておくのが現実的です。SLAの監視やエスカレーションを定期実行で自動化したいときは、PagerDuty×CoworkでSLA監視とエスカレーションを自動化するの構成が向いています。

まとめ

スケジュールの確認と上書きの作成だけなら、On-Call Managerで足ります。インシデントやチームまで書き換えられる状態を避けたいなら、フラグなしで一覧の確認に留めるか、ホスト版を使います。

この記事を共有:XはてブLinkedIn

関連する記事

Claude をもっと見る →