Cara Menambahkan PagerDuty MCP ke Claude Code

4 menit baca.
Tags: ai

Kalau kamu datang cuma buat command, pakai ini.

Command cepat

claude mcp add --transport stdio --env PAGERDUTY_USER_API_KEY=YOUR_PAGERDUTY_USER_API_KEY pagerduty -- uvx pagerduty-mcp

Ganti YOUR_PAGERDUTY_USER_API_KEY dengan PagerDuty User API Key kamu. Aliasnya pagerduty, jadi nama itu yang nanti muncul di claude mcp list dan /mcp.

Command ini menjalankan PagerDuty MCP server secara lokal lewat uvx. Claude Code memulai server lewat stdio, mengirim token sebagai environment variable, lalu berbicara ke PagerDuty lewat proses lokal itu.

Kalau uvx belum ada:

brew install uv
# or
pip install uv

Buat token PagerDuty

Buat User API Key sebelum menambahkan MCP server:

  1. Login ke PagerDuty.
  2. Buka Profile -> User Settings.
  3. Masuk ke User Token REST API Keys.
  4. Buat API user token baru.
  5. Salin tokennya ke tempat yang aman. PagerDuty hanya menampilkannya sekali.

Perlakukan token ini seperti password. Jangan tempel ke repo, issue, screenshot, atau transcript Claude yang dibagikan.

Apa yang bisa Claude lakukan dengan PagerDuty

Setelah terhubung, Claude Code bisa memakai konteks PagerDuty tanpa kamu harus copy-paste detail incident secara manual. Biasanya dipakai untuk:

  • melihat incident yang masih open
  • membaca detail incident
  • mengecek siapa yang sedang on-call
  • mencari escalation policy
  • melihat services dan teams

Server lokal ini read-only secara default. Itu titik awal yang paling masuk akal untuk banyak setup karena Claude bisa membantu investigasi tanpa bisa mengubah state di PagerDuty.

Verifikasi setup

Setelah server ditambahkan, cek apakah Claude Code sudah mendaftarkannya:

claude mcp list

Di dalam Claude Code, kamu juga bisa menjalankan:

/mcp

Server pagerduty harus muncul di sana. Kalau belum muncul, restart Claude Code dan cek lagi.

Lalu tanya hal kecil dari PagerDuty:

What are the open incidents in PagerDuty?

Kalau Claude mengembalikan data PagerDuty kamu, setup-nya sudah jalan. Kalau terhubung tapi hasilnya kosong, cek user dari tokennya dulu. Command-nya bisa saja benar, tapi user tersebut belum tentu punya akses ke incident, service, team, atau schedule yang kamu tanyakan.

Akun EU

Untuk akun PagerDuty EU, kirim host API EU sebagai environment variable tambahan:

claude mcp add --transport stdio \
  --env PAGERDUTY_USER_API_KEY=YOUR_PAGERDUTY_USER_API_KEY \
  --env PAGERDUTY_API_HOST=https://api.eu.pagerduty.com \
  pagerduty -- uvx pagerduty-mcp

Kalau server terhubung tapi tidak menemukan data yang jelas-jelas ada, host API ini salah satu hal pertama yang perlu dicek.

Opsional: aktifkan write tools

PagerDuty MCP bisa membuka write tools, tapi harus diaktifkan sendiri. Pakai ini hanya kalau kamu memang nyaman memberi Claude Code kemampuan membuat atau mengubah resource PagerDuty dari sesi kamu.

claude mcp add --transport stdio \
  --env PAGERDUTY_USER_API_KEY=YOUR_PAGERDUTY_USER_API_KEY \
  pagerduty -- uvx pagerduty-mcp --enable-write-tools

Untuk incident response, saya akan mulai dari read-only dulu. Tambahkan write tools nanti kalau workflow-nya memang butuh.

Opsional: pakai hosted MCP server dari PagerDuty

PagerDuty juga menyediakan endpoint MCP hosted. Pakai opsi ini kalau kamu tidak mau Claude Code menjalankan package Python lokal lewat uvx.

export PAGERDUTY_API_KEY=YOUR_PAGERDUTY_USER_API_KEY

claude mcp add-json pagerduty \
  '{"type":"http","url":"https://mcp.pagerduty.com/mcp","headers":{"Authorization":"Token token=${PAGERDUTY_API_KEY}"}}'

Untuk akun EU, pakai:

https://mcp.eu.pagerduty.com/mcp

Setup hosted ini butuh PAGERDUTY_API_KEY di environment tempat Claude Code dijalankan. Kalau kamu hanya menjalankan export di satu tab terminal, Claude Code yang dibuka dari tempat lain belum tentu melihat variable itu.

Troubleshooting

Kalau uvx tidak ditemukan, install uv, lalu jalankan ulang command tambah server.

Kalau pagerduty muncul di claude mcp list tapi Claude Code tetap belum bisa memakainya, restart Claude Code.

Kalau tool mengembalikan authorization error, buat User API Key baru dan pastikan user PagerDuty tersebut punya akses ke data yang kamu tanyakan.

Kalau data EU tidak muncul, pastikan kamu memakai PAGERDUTY_API_HOST=https://api.eu.pagerduty.com untuk server lokal atau endpoint hosted EU untuk server remote.

Kalau alur setup-nya berubah, ikuti dokumentasi PagerDuty. MCP masih bergerak cepat, jadi detail command kecil bisa berubah.

Referensi

Cek terakhir

Kebanyakan setup sebaiknya mulai dari command lokal uvx dan User API Key read-only. Tambahkan host EU hanya kalau akun kamu ada di PagerDuty EU, dan aktifkan write tools hanya kalau ada alasan yang jelas.

Related Posts