Sentry MCPをClaude Codeに追加する手順 — OAuth接続とSeer連携

Sentry MCPをClaude Codeに追加するには、claude mcp add --transport http sentryにエンドポイントを渡し、/mcpでOAuthサインインします。トークンの発行は要りません。Sentry MCPはインストール不要のリモートMCPサーバーです。エラー・issueの検索に加えて、SentryのAIデバッグエージェントSeerによる根本原因分析をMCPから呼べます。別機能として、Sentry側の設定でAutofixのコード生成をClaude Codeに引き継ぐこともできます。ここでは接続手順と、Seer連携で詰まりやすい前提条件をまとめます。

Sentry MCPとConnector版の違い

Web・デスクトップアプリで使うSentryConnectorは、Anthropic側で用意された接続をサインインするだけで使えます。Sentry MCPは同じmcp.sentry.devのリモートサーバーですが、Claude Codeから直接claude mcp addで登録し、組織・プロジェクト単位にスコープを絞ったエンドポイントを自分で選べる点が違います。

Claude Codeにつなぐ3ステップ

Sentryは接続方法として、プラグインのインストールとclaude mcp addによる直接登録の2つを用意しています。

直接登録では、次のコマンドでエンドポイントを追加します。Sentry公式の手順は、スラッグまで付けたプロジェクト単位のURLです。

claude mcp add --transport http sentry https://mcp.sentry.dev/mcp/{organizationSlug}/{projectSlug}

プラグイン版は、Sentryのエラー・issue・トレースについて質問したときにClaude Codeが自動で委任するsentry-mcpサブエージェントを追加します。

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

v2.1.287では、claude plugin marketplace addとclaude plugin installのどちらも--scopeを持ち、既定はuserです。プロジェクト単位に閉じたいときは、claude plugin install sentry-mcp@sentry-mcp --scope projectのようにinstall側にも指定します。marketplace側だけに付けても、プラグインはuserスコープに入ります。

プラグイン版と直接登録のどちらを選ぶか

プラグイン版は、Sentryの質問を専用のサブエージェントに任せたいときの選択肢です。組織・プロジェクトを絞った接続を自分で管理したいなら、直接登録が向いています。

ブラウザが開かない環境ではコマンドラインでログインする

SSH接続中やディスプレイのないLinuxでは、/mcpの画面からブラウザを開けません。そのときはclaude mcp loginでシェルから認証を進められます。v2.1.287でclaude mcp login --helpを実行すると、次のように表示されます。

Usage: claude mcp login [options] <name>
 
Authenticate with an MCP server (HTTP, SSE, or claude.ai connector)
 
Options:
  -h, --help    Display help for command
  --no-browser  Print the authorization URL instead of opening a browser (for
                SSH/headless sessions — paste the redirect URL back when
                prompted)

claude mcp login sentry --no-browserなら、認証URLが画面に出ます。手元のブラウザでサインインし、リダイレクト後のURL全体をプロンプトに貼り付けます。貼り付けには対話端末が要るため、SSHではssh -tで接続します。

調べる範囲を組織・プロジェクトで絞る

Sentry MCPのエンドポイントは、末尾に付けるスラッグで範囲が決まります。

絞ると、対象の組織・プロジェクトがツールの引数の既定値になり、探索用のツールが隠れます。実験的な機能は、末尾に?experimental=1を付けると有効になります。権限を絞る判断そのものでよくある失敗はClaude Connectorsの権限設定でよくある失敗と対策にまとめています。

意図しない組織のissueが返ってくるとき

スラッグなしで接続していると、全組織が対象です。扱うプロジェクトが決まっているなら、{organizationSlug}/{projectSlug}まで付けてclaude mcp addをやり直します。

OAuth以外の認証(自前トークンを直接渡す)

自前で発行したSentryのAPIトークンをカスタムヘッダーで渡す接続方法もあります。

{
  "mcpServers": {
    "sentry": {
      "url": "https://mcp.sentry.dev/mcp",
      "headers": {
        "Authorization": "Sentry-Bearer <YOUR_SENTRY_TOKEN>"
      }
    }
  }
}

Sentry-BearerヘッダーはMCP OAuthのアクセストークン用に予約されたBearerヘッダーとは別枠で、サーバー側はこのトークンを保存・検証・更新しません。CI環境やスクリプトから決まったトークンで動かしたい場合に使います。

headers.Authorizationを設定したサーバーがそのヘッダーを拒否すると、Claude CodeはOAuthへ切り替えず接続失敗として報告します。トークンの有効性を確かめるか、ヘッダーを外してOAuthに戻します。

Seerで自動issue修正を回す前に確認すること

Seerは、issue詳細・トレース・ログ・プロファイルを組み合わせてエラーの根本原因を分析するSentryのAIデバッグエージェントです。Sentry MCPのseerスキルには、根本原因分析を呼び出すanalyze_issue_with_seerツールがあります。分析が済んでいれば結果をすぐ返し、無ければ新しい分析を始めます。分析には2〜5分ほどかかります。Autofixのコード生成やハンドオフはこのツールではなく、Sentry側の機能です。

Seerが対応するのはGitHub.comとGitLab.comのクラウド版だけです。GitHub.com・GitLab.com以外のセルフホスト環境や、BitbucketとAzure DevOpsは対象外です。

Sentryの設定には、組織としてPR作成を止める項目もあります。code generationを無効にすると、AutofixのCreate PRボタンが消え、「Allow Root Cause Analysis to create PRs by Default」も有効にできなくなります。Autofixが自動で走るのは、プロジェクトのSeer設定でautomationを有効にしている場合に限ります。条件は、issueのイベントが10件以上あること、直近14日以内に発生していること、十分なfixability scoreがあることの3つです。自動実行の停止点は、Root Cause・Plan・PR Draftedの3段階から選べます。調査だけをAIに任せ、コード変更は人間かClaude Codeに限りたい組織は、この設定を先に見ておくと安心です。

最後のコード生成だけをClaude Codeに任せる

AutofixはRoot Cause Analysisと解決策の立案を常にSeer自身の内部ツールで行います。コード生成のステップだけを、外部のコーディングエージェントに引き継げます。

Sentryが挙げる引き継ぎ先は、Claude Code・Cursor Cloud Agent・GitHub Copilot Cloud Agentの3つです。有効にするには、SentryのIntegrations設定でコーディングエージェント連携を接続します。接続後は、Autofixのコード生成ステップに、既定の「Create PR」「Checkout locally」と並んで引き継ぎの選択肢が出ます。

見落としやすいのは、ハンドオフがGitHub限定という点です。Autofix自体はGitLab.comでも動きますが、コーディングエージェントへの引き継ぎはGitHubのリポジトリでしか使えません。引き継ぎ先のエージェントは、Sentryプロジェクトに接続されたものと同じリポジトリにアクセスできる必要があります。

スキル単位でツールを絞り込む

Sentry MCPのツールは、機能ごとにスキルとしてまとめられています。エンドポイントに?skills=inspect,triageのように指定すれば必要なスキルだけを、?disable-skills=seerのように指定すれば特定のスキルだけを除外して接続できます。

何も指定しない場合、直接リモート接続では有効なスキルがすべて公開されます。Seerを使わないチームや、Seerの分析をMCP経由で呼ばせたくない場合は?disable-skills=seerで調査用途だけに絞れます。

セルフホストSentryに接続する

自社運用のSentryにはstdioトランスポートを使い、必要なスコープを持つUser Auth Tokenを発行します。READMEが挙げるスコープはorg:read・project:read・project:write・team:read・team:write・event:writeです。

npx @sentry/mcp-server@latest --access-token=<SENTRY_USER_TOKEN> --host=sentry.example.com

--hostにはホスト名だけを書きます。sentry.io以外のホストを指定すると、Seerはセルフホストに無いためseerスキルが既定の公開対象から外れます。自社のデプロイでSeerが動いている場合は、--skills=inspect,seerで明示的に戻せます。TLSを終端していない内部ネットワークのSentryには、--insecure-httpを追加します。

READMEには、search_eventsやsearch_issuesのようなAI検索系のツールは、OpenAI・Azure OpenAI・Anthropic・OpenRouterのいずれかのLLMプロバイダーを設定しないと使えないとも書かれています。stdioで検索系ツールが見当たらないときは、まずプロバイダーの設定を疑います。

よくあるつまずき

別のプロジェクトで開くとまたサインインを求められる

Claude Codeは、OAuthのサインインをエンドポイントごとに保存します。同じ名前の定義をスコープごとに別のエンドポイントで持っていると、あるプロジェクトで認証済みでも、別の定義が読み込まれるプロジェクトでは改めてサインインが要ります。claude mcp listか/mcpに出る警告で各スコープのエンドポイントを見比べ、残す定義以外をclaude mcp removeで消します。

よくある質問

Sentry MCPとSentryConnectorは同時に接続できますか

重複かどうかの判定は、対象によって違います。ローカル・プロジェクト・ユーザーの3スコープ同士は名前で、プラグインとclaude.aiのコネクターはエンドポイントで照合され、同じURLを指すものだけが重複として扱われます。/mcp/{organizationSlug}/{projectSlug}のようにパスを絞った接続は、パスやクエリが違えば別のサーバーとして数えられます。コネクターと同じSentryに二重に繋がっていないかは、claude mcp listと/mcpで確かめられます。

まとめ

Sentryに繋ぐなら、見たいプロジェクトが決まっている時点でスラッグまで付けたエンドポイントを登録するのが近道です。Autofixの実装だけをClaude Codeに任せたい場合は、リポジトリがGitHubかどうかで可否が決まります。Datadogでも同じ調査をするならDatadog MCPをClaude Codeに接続する方法も合わせて読めます。