Sentry MCP — ユースケース, インストール & ライブデモ

Name: Sentry MCP MCP Server
Author: getsentry

なぜ使うのか

主な機能

Sentry のクエリ構文でイシューを検索
完全なイベントペイロードの取得：スタックトレース・パンくず・リクエスト・タグ
リリースの健全性：回帰検出・採用率・クラッシュフリー率
スパン内訳付きのパフォーマンストレース
クロスプロジェクトクエリ用のプロジェクト・チームメタデータ

ライブデモ

実際の動作

sentry-mcp-getsentry.replay ▶ 準備完了

0/0

インストール

クライアントを選択

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "sentry-mcp-getsentry": {
      "command": "npx",
      "args": [
        "-y",
        "@sentry/mcp-server"
      ]
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config を開く。保存後、アプリを再起動。

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "sentry-mcp-getsentry": {
      "command": "npx",
      "args": [
        "-y",
        "@sentry/mcp-server"
      ]
    }
  }
}

Cursor は Claude Desktop と同じ mcpServers スキーマを使用。プロジェクト設定はグローバルより優先。

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "sentry-mcp-getsentry": {
      "command": "npx",
      "args": [
        "-y",
        "@sentry/mcp-server"
      ]
    }
  }
}

Cline サイドバーの MCP Servers アイコンをクリックし、"Edit Configuration" を選択。

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "sentry-mcp-getsentry": {
      "command": "npx",
      "args": [
        "-y",
        "@sentry/mcp-server"
      ]
    }
  }
}

Claude Desktop と同じ形式。Windsurf を再起動して反映。

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "sentry-mcp-getsentry",
      "command": "npx",
      "args": [
        "-y",
        "@sentry/mcp-server"
      ]
    }
  ]
}

Continue はマップではなくサーバーオブジェクトの配列を使用。

~/.config/zed/settings.json

{
  "context_servers": {
    "sentry-mcp-getsentry": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@sentry/mcp-server"
        ]
      }
    }
  }
}

context_servers に追加。保存時に Zed がホットリロード。

claude mcp add sentry-mcp-getsentry -- npx -y @sentry/mcp-server

ワンライナー。claude mcp list で確認、claude mcp remove で削除。

ユースケース

実用的な使い方： Sentry MCP

Claude から離れずに本番エラーをエンドツーエンドでデバッグする

👤 オンコールアラートに対応している開発者 ⏱ ~20 min intermediate

使うタイミング： Sentry のアラートが発火し、今すぐ根本原因を特定したいとき。

前提条件

Sentry 認証トークン — ユーザー設定 → Auth Tokens → 「project:read」「event:read」「org:read」で作成
環境変数へのトークン設定 — SENTRY_AUTH_TOKEN と SENTRY_HOST（sentry.io またはセルフホスト）を設定する

フロー

イシューを見つける

Use sentry-mcp. Find the most-firing issue in project 'web' from the last 6 hours.✓ コピーしました

→ イシュー ID・発生回数・最初/最後の発生時刻が表示される
完全なコンテキストを取得する

Get the latest event for that issue — stack trace, breadcrumbs, request data.✓ コピーしました

→ フレームとユーザー操作の履歴を含む完全なイベントペイロードが表示される
デプロイと関連付ける

What release was running when this first appeared? List the commits in that release.✓ コピーしました

→ リリースタグとコミット一覧が表示される
修正案を提示する

Looking at the stack and the commits — which commit likely caused this? Draft a fix in the relevant file.✓ コピーしました

→ 具体的なファイルと行番号が示され、具体的なパッチが提案される

結果： 完全な証跡とともに、アラートから修正候補まで数分で到達できる。

注意点

ソースマップがない。スタックフレームが役に立たない — Sentry リリースでのソースマップアップロードを確認する。マップがなければ難読化されたフレームから Claude は何も得られない

組み合わせ： github

リリースを昇格させる前の事前チェック

👤 リリースエンジニア・デプロイ承認者 ⏱ ~15 min intermediate

使うタイミング： カナリアリリースを 100% に昇格させようとしているとき。

フロー

リリースの健全性を比較する

Use sentry-mcp. Compare crash-free rate of release 1.4.0 vs 1.3.9 over their respective canary windows.✓ コピーしました

→ リリースごとのクラッシュフリー率・採用率・回帰件数が表示される
新規エラーを確認する

List any issues unique to 1.4.0 (not seen in 1.3.9 or earlier).✓ コピーしました

→ 件数付きの新規イシュー一覧が表示される
推奨を求める

Given crash-free is X% and N net-new errors, recommend ship/halt with reason.✓ コピーしました

→ 根拠と閾値を明示した明確な推奨が示される

結果： 感覚でなくデータに基づいたリリース継続・停止の判断ができる。

注意点

採用率が低すぎて統計的に意味をなさない — Claude は低採用率のウィンドウを「不確定」としてフラグを立てるべき。知ったかぶりをしない

トランザクショントレースを使ってパフォーマンス回帰を調査する

👤 レイテンシを追うバックエンドエンジニア ⏱ ~25 min advanced

使うタイミング： 最後のデプロイ後に /checkout の p95 レイテンシが急上昇したとき。

フロー

最近の遅いトレースを取得する

Use sentry-mcp. Get a trace for transaction 'POST /checkout' with duration > 2s from the last hour.✓ コピーしました

→ スパン内訳付きのトレースが表示される
新しいスパンを見つける

Compare span list to a similar trace from last week. Which spans are new or longer?✓ コピーしました

→ 差分が表示される：新規 DB クエリ 'SELECT cart_items'、平均 1.4s
コードに紐付ける

What commit added that query? Suggest an index or a query rewrite.✓ コピーしました

→ コミットと具体的な修正提案が示される

結果： パフォーマンス回帰の根本原因とコードレベルの修正案が得られる。

注意点

トレースのサンプリングレートが低く、遅いトレースがキャプチャされない — 一時的にサンプルレートを上げるか、Claude に統計エンドポイントを使うよう指示する

組み合わせ： github

組み合わせ

他のMCPと組み合わせて10倍の力を

sentry-mcp-getsentry + github

Sentry のスタックフレームから直接 PR の下書きを作成する

Pull issue X from Sentry, find the offending commit via GitHub, draft a fix as a new branch + PR.✓ コピーしました

sentry-mcp-getsentry + linear

回帰から自動的にエンジニアリングチケットを作成する

For each new release-blocking issue in Sentry, create a Linear ticket with the stack + suggested owner.✓ コピーしました

ツール

このMCPが提供する機能

ツール	入力	呼び出すタイミング	コスト
search_issues	project, query, statsPeriod?	Sentry クエリでイシューをフィルタリングする	1 Sentry API call
get_issue	issue_id	1 件のイシューをトップレベルで確認する	1 API call
get_event	event_id or 'latest'	完全なコンテキスト付きで特定の発生を取得する	1 API call
list_releases	project, version?	リリース間の比較	1 API call
get_trace	trace_id	パフォーマンス調査	1 API call

コストと制限

運用コスト

APIクォータ: Sentry API の標準レート制限。バースト時に 429 が返る場合がある
呼び出しあたりのトークン: イベントペイロードは 5〜20k トークンになりうる。選択的に取得すること
金額: Sentry Developer プランは無料。有料プランはレート制限が高くなる
ヒント: まず search_issues で絞り込む。候補のみ get_event を呼ぶ。結果リスト全体には使わない

セキュリティ

権限、シークレット、影響範囲

最小スコープ： project:read event:read org:read

認証情報の保管： SENTRY_AUTH_TOKEN 環境変数（スコープを絞ったプロジェクト単位のトークンを使用）

データ送信先： Sentry ホスト（sentry.io またはセルフホスト）への全呼び出し

絶対に付与しない： チャット駆動エージェントに project:write または org:write を付与しない

イベントデータにはリクエストボディやユーザー ID などの PII が含まれる場合がある。Sentry のデータスクラビングルールをアップストリームで適用すること

トラブルシューティング

よくあるエラーと対処法

401 Unauthorized

トークンが期限切れまたはスコープが不足している。記載の読み取りスコープで再生成する

確認： curl -H 'Authorization: Bearer $SENTRY_AUTH_TOKEN' $SENTRY_HOST/api/0/projects/

スタックトレースが難読化されたフレームしか表示されない

リリースパイプラインでのソースマップアップロードを確認する。マップがなければ Claude はフレームから推論できない

確認： Sentry UI → Release → Artifacts

既知のイシューで 404 が返る

トークンが対象プロジェクトをカバーしていない。そのプロジェクトを含めるようトークンを再設定する

セルフホスト Sentry で接続が拒否される

SENTRY_HOST をプロトコルを含む実際のインスタンス URL に明示的に設定する

確認： curl $SENTRY_HOST/api/0/

代替案

Sentry MCP 他との比較

代替案	代わりに使う場面	トレードオフ
Datadog MCP	チームが Datadog APM / エラートラッキングを使用しているとき	カバレッジが異なる。APM ファースト。イシュー管理は弱め
Honeycomb MCP	スタックトレースではなくイベントを使うオブザーバビリティファーストのチームの場合	ファーストクラスのイシューグルーピングがない。トレース中心

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る