Cara menambahkan Sentry MCP ke Claude Code

5 menit baca.
Tags: AIClaude Code

Sentry MCP server membuat Claude Code bisa membaca issue, stack trace, dan event di Sentry, jadi kamu bisa bilang "perbaiki error teratas dari kemarin" tanpa copy apa pun dari UI Sentry. Untuk sentry.io, menambahkan Sentry MCP ke Claude Code cukup satu command plus login lewat browser.

Command cepat

claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

Aliasnya sentry. MCP server ini di-host oleh Sentry, jadi tidak ada yang berjalan di mesin kamu. Command-nya perlu --transport http karena tanpa itu Claude Code menganggap URL tersebut sebagai command lokal yang dijalankan lewat stdio.

Command yang persis sama juga jadi contoh di claude mcp add --help.

Login dengan OAuth

Server butuh login Sentry kamu sebelum tool apa pun bisa dipakai. Di dalam Claude Code, jalankan:

/mcp

Pilih sentry lalu pilih authenticate. Claude Code membuka Sentry di browser. Login, setujui aksesnya, dan pilih grup tool mana yang diizinkan saat Sentry menanyakannya.

Claude Code menyimpan token OAuth-nya sendiri. Tidak ada API token yang masuk ke config kamu.

Verifikasi setup

claude mcp list

Setelah login, sentry harus muncul sebagai connected. Lalu tanya sesuatu yang kamu tahu memang ada:

What are the top unresolved issues in Sentry from the last 24 hours?

Kalau judul issue yang asli muncul, setup-nya selesai. Jawaban kosong biasanya berarti user Sentry kamu tidak bisa melihat organisasi atau project itu, bukan berarti setup-nya gagal.

Batasi ke satu organisasi atau project

Tambahkan slug di URL untuk membatasi apa yang bisa dilihat Claude:

# satu organisasi
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp/my-org

# satu project
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp/my-org/my-project

Dengan URL yang dibatasi, Sentry menyembunyikan tool untuk melihat daftar organisasi dan project, karena memang tidak ada lagi yang perlu dicari. Kalau kamu menjalankan claude mcp add per repository, URL per project ini pas: sesi Claude Code di tiap repo hanya melihat project Sentry untuk kode itu.

Pakai token, bukan OAuth

Beberapa setup tidak bisa login lewat browser, misalnya mesin remote atau config yang dipakai bersama. Server hosted Sentry juga menerima Sentry auth token lewat header:

export SENTRY_ACCESS_TOKEN=your_sentry_token

claude mcp add-json sentry '{"type":"http","url":"https://mcp.sentry.dev/mcp","headers":{"Authorization":"Sentry-Bearer ${SENTRY_ACCESS_TOKEN}"}}'

Prefix-nya Sentry-Bearer. Sentry memakai Bearer biasa untuk token MCP OAuth miliknya sendiri, jadi Sentry auth token butuh prefix terpisah.

Kutip tunggal menjaga ${SENTRY_ACCESS_TOKEN} tetap sebagai placeholder di config, dan Claude Code mengisinya dari environment kamu saat server dijalankan.

Dengan token, Sentry mengaktifkan semua grup tool secara default. Tambahkan ?skills=inspect,triage di URL untuk mengizinkan sebagian saja, atau ?disable-skills=seer untuk membuang satu grup.

Sentry self-hosted

Endpoint hosted hanya jalan untuk sentry.io. Untuk Sentry self-hosted, jalankan MCP server secara lokal lewat stdio dan arahkan ke host kamu:

claude mcp add --transport stdio \
  --env SENTRY_ACCESS_TOKEN=your_sentry_token \
  --env SENTRY_HOST=sentry.example.com \
  sentry -- npx @sentry/mcp-server@latest

SENTRY_HOST diisi hostname saja, tanpa https://. Buat user auth token di Sentry dengan scope berikut, sesuai daftar di README Sentry MCP:

org:read
project:read
project:write
team:read
team:write
event:write

Ada dua perbedaan dibanding server hosted.

Seer, AI debugger milik Sentry, tidak ada di Sentry self-hosted, jadi server lokal tidak memuat grup tool itu kalau SENTRY_HOST mengarah ke selain sentry.io.

Tool pencarian berbasis AI, seperti search_issues dan search_errors, butuh LLM key sendiri karena tool ini mengubah kalimat biasa jadi query syntax Sentry. Tanpa key, tool tersebut tidak muncul dan tool lain tetap jalan. Untuk mengaktifkannya, tambahkan --env EMBEDDED_AGENT_PROVIDER=anthropic --env ANTHROPIC_API_KEY=... (OpenAI dan OpenRouter juga bisa).

Atau install plugin Claude Code

Sentry juga menyediakan MCP server ini sebagai plugin Claude Code:

claude plugin marketplace add getsentry/sentry-mcp
claude plugin install sentry-mcp@sentry-mcp

Plugin ini menambahkan subagent sentry-mcp, dan Claude menyerahkan pertanyaan soal Sentry ke subagent itu. Subagent menjalankan pencarian Sentry di context-nya sendiri, jadi stack trace yang panjang tidak memenuhi percakapan utama kamu. Kalau kamu install plugin-nya, hapus server yang sebelumnya ditambahkan lewat claude mcp add supaya Claude tidak memuat tool Sentry yang sama dua kali.

Troubleshooting

Kalau sentry menampilkan "needs authentication" di /mcp, berarti langkah OAuth belum selesai. Jalankan /mcp, pilih server-nya, lalu login lagi.

Kalau tool call gagal dengan error auth saat memakai token, cek prefix Sentry-Bearer dulu, lalu pastikan SENTRY_ACCESS_TOKEN sudah di-set di shell yang menjalankan Claude Code.

Kalau server self-hosted terhubung tapi semua call gagal, cek SENTRY_HOST. Nilai yang berisi https:// atau path tidak akan jalan. Untuk deployment internal yang hanya melayani HTTP biasa, README mendokumentasikan flag --insecure-http.

Referensi

Setup MCP on-call lain di blog ini: Datadog dan PagerDuty. Dengan ketiganya, Claude bisa mengecek page, metrics, dan stack trace dalam satu sesi.

Cek terakhir

Untuk sentry.io, jalankan claude mcp add --transport http sentry https://mcp.sentry.dev/mcp, lalu login lewat /mcp. Tambahkan /my-org/my-project di URL supaya Claude hanya melihat satu project. Sentry self-hosted butuh npx @sentry/mcp-server lokal dengan token dan SENTRY_HOST.

Related Posts