Sentry MCPをOAuthでClaude Codeに接続しSeerで自動修正する
Sentry MCPをOAuthだけでClaude Codeに繋ぐ手順と、Seerの自動修正をClaude Codeにハンドオフして使う設定をまとめます。
Sentry MCPは、インストール不要でOAuth接続だけでClaude Codeから使えるリモートMCPサーバーです。エラー・issueの検索に加えて、SentryのAIデバッグエージェントSeerの自動修正を呼び出し、その最終ステップをClaude Codeに引き継がせることもできます。ここでは接続手順とSeer連携の設定をまとめます。
Sentry MCPとConnector版の違い
Web・デスクトップアプリで使うSentryConnectorは、Anthropic側で用意された接続をサインインするだけで使えます。Sentry MCPは同じmcp.sentry.devのリモートサーバーですが、Claude Codeから直接claude mcp addで登録し、組織・プロジェクト単位にスコープを絞ったエンドポイントを自分で選べる点が違います。
Claude Codeへの接続方法
Sentry公式は、Claude Codeプラグインとしてのインストールと、claude mcp addによる直接登録の2つを案内しています。
プラグイン版は、Sentryのエラー・issue・トレースについて質問したときにClaude Codeが自動で委任するsentry-mcpサブエージェントを追加します。
claude plugin marketplace add getsentry/sentry-mcp
claude plugin install sentry-mcp@sentry-mcp直接登録する場合は、次のコマンドでエンドポイントを追加します。
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp追加後、Claude Code内で/mcpを実行するとブラウザでのOAuthログイン画面が開き、Sentryアカウントでサインインするだけで接続が完了します。トークンの発行やAPIキーの取得といった事前作業は不要です。
組織・プロジェクト単位でスコープを絞る
Sentry MCPのエンドポイントは、組織スラッグとプロジェクトスラッグを付けて絞り込めます。
| エンドポイント | 範囲 |
|---|---|
https://mcp.sentry.dev/mcp | 範囲サインインしたユーザーがアクセスできる全組織・全プロジェクト |
https://mcp.sentry.dev/mcp/{organizationSlug} | 範囲指定した1組織のみ |
https://mcp.sentry.dev/mcp/{organizationSlug}/{projectSlug} | 範囲指定した1プロジェクトのみ |
プロジェクト単位に絞ると、対象の組織・プロジェクトがツールの引数の既定値になり、プロジェクトを探すためだけの検索系ツールが隠れます。Sentry公式も、可能な場合はプロジェクト単位までスコープを絞ることを推奨しています。実験的な機能を試す場合は、末尾に?experimental=1を付けて有効化できます。スコープを絞る判断そのものでよくある失敗はClaude Connectorsの権限設定でよくある失敗と対策にまとめています。
OAuth以外の認証(自前トークンを直接渡す)
自前で発行したSentryのAPIトークンをカスタムヘッダーで渡す接続方法もあります。
{
"mcpServers": {
"sentry": {
"url": "https://mcp.sentry.dev/mcp",
"headers": {
"Authorization": "Sentry-Bearer <YOUR_SENTRY_TOKEN>"
}
}
}
}Sentry-BearerヘッダーはMCP OAuthのアクセストークン用に予約されたBearerヘッダーとは別枠で、サーバー側はこのトークンを保存・検証・更新しません。CI環境やスクリプトから決まったトークンで動かしたい場合に使います。
Seerで自動issue修正を回す
Seerは、issue詳細・トレース・ログ・プロファイルを組み合わせてエラーの根本原因を分析するSentryのAIデバッグエージェントです。Sentry MCPには、Seerの修正実行(Autofix)をトリガーし、その進行状況を照会するツールが含まれています。
Autofixは、issueが取り込まれるたびに根本原因を分析し、修正の候補を提示します。Claude CodeからSentry MCP経由でAutofixの実行をトリガーし、ステータスを確認しながら結果を待つ、という使い方ができます。
外部コーディングエージェントへの引き継ぎ(External Coding Agent)
AutofixはRoot Cause Analysisと解決策の立案を常にSeer自身の内部ツールで行いますが、最後のコード生成ステップだけは外部のコーディングエージェントに引き継げます。Sentry公式が対応を明言しているハンドオフ先はClaude Code・Cursor Cloud Agents・GitHub Copilotの3つです。Seerが立てた修正方針をもとに、実際のコード変更とPR作成をClaude Codeに任せる、という分業ができます。
スキル単位でツールを絞り込む
Sentry MCPのツールは、機能ごとにスキルとしてまとめられています。エンドポイントに?skills=inspect,triageのように指定すれば必要なスキルだけを、?disable-skills=seerのように指定すれば特定のスキルだけを除外して接続できます。
| スキル | 用途 |
|---|---|
inspect | 用途issue・トレース・ログの検索と詳細取得 |
triage | 用途issueの優先度判断・担当割り当てなどのトリアージ系操作 |
seer | 用途Autofixの実行トリガーとステータス照会 |
何も指定しない場合、直接リモート接続では有効なスキルすべてが公開されます。Seerを使わないチームや、Autofixの実行権限をClaude Codeに渡したくない場合は?disable-skills=seerを付けて接続すると、調査・トリアージ用途だけに絞れます。
Seerの費用と利用条件
Seerはコード変更を伴う機能のため、有効化する前に確認しておくべき制約があります。GitHub連携はGitHub.com、GitLab連携はGitLab.comのクラウド版のみが対象で、セルフホストのGitHub Enterprise・GitLab自己ホスト版では利用できません。
Seer Agentという、issueに限らずアプリケーションについて自由に質問できる機能や、GitHub/GitLab上のコード変更をレビューするCode Review機能も同じSeerのラインに含まれますが、Sentry MCP経由での操作は主にAutofixの実行とステータス照会が中心です。
セルフホストSentryでの注意点
自社運用のSentryに接続する場合はstdioトランスポートを使い、必要なスコープを持つUser Auth Tokenを発行します。
npx @sentry/mcp-server@latest --access-token=<SENTRY_USER_TOKEN> --host=sentry.example.comSeerのようなクラウド版限定の機能はセルフホスト環境で使えないことがあり、その場合は--disable-skills=seerを付けて該当ツールを公開対象から外します。TLSを終端していない内部ネットワークのSentryに接続するときは、--insecure-httpを追加します。
よくあるつまずき
/mcpを実行してもOAuthのブラウザが開かない
SSH接続中やディスプレイのないLinux環境では自動でブラウザが開きません。表示された認証URLを手元のブラウザで開き、リダイレクト後のURLをClaude Codeのプロンプトに貼り付けます。
意図しない組織・プロジェクトのissueが返ってくる
エンドポイントに組織・プロジェクトのスラッグを付けずに接続すると、サインインしたユーザーがアクセスできる全組織が対象になります。特定のプロジェクトだけを扱いたい場合は、{organizationSlug}/{projectSlug}まで指定したエンドポイントに接続し直します。
Seerの修正実行ツールが見当たらない
セルフホストのSentryや--disable-skills=seerを付けた接続では、Seer関連のツールが公開されません。クラウド版のSentry.ioに、スコープ制限なしまたはSeerを除外していないエンドポイントで接続しているか確認します。
よくある質問
Sentry MCPとSentryConnectorは同時に接続できますか
できます。片方をClaude Code、もう片方をWeb・デスクトップアプリで使う分には競合しません。ただし同じエンドポイントを指すサーバーをClaude Code側にも.mcp.jsonなどで重複登録すると、Claude Codeで追加した側が優先されます。
AutofixのPR作成にもClaude Codeを使えますか
使えます。External Coding AgentへのハンドオフはAutofixの最終ステップ(コード生成)を対象にした機能で、対応先としてClaude Codeが明記されています。根本原因の分析と修正方針の決定はSeer自身が行い、実際のコード変更とPR作成をClaude Codeに任せる流れです。
個人のSentryアカウントでもSeerを試せますか
Seerはプロジェクト・リポジトリ単位で有効化するアドオンで、個人アカウントでも対象プロジェクトがSeer-Enabledになっていれば利用できます。ただし課金対象になるかはそのプロジェクトでのPR作成数によって決まるため、試す前にSentry側の料金ページで最新の条件を確認するのが確実です。
まとめ
Sentry MCPはOAuth接続だけでClaude Codeに繋がり、{organizationSlug}/{projectSlug}までスコープを絞ればプロジェクト単位の調査に使えます。Seerの自動修正(Autofix)はSentry側でGitHub/GitLab連携とAutofixの有効化が前提で、最後のコード生成だけをClaude Codeにハンドオフする使い方が公式にサポートされています。Web・デスクトップから手軽に使うだけならSentryConnectorのほうが手間は小さく、同じ観測データの調査をDatadogでも行いたい場合はDatadog MCPをClaude Codeに接続する方法を参考にしてください。