Sentry MCP Server (Official)

Sentry MCP Server (Official) とは？

Sentry MCP Server (Official) は Sentry 公式の Sentry MCP サーバーで、Model Context Protocol を通じて Claude Code、Cursor、VS Code などの AI コーディングアシスタントを Sentry のエラー、issue、トレース、パフォーマンスデータに接続します。

Sentry が getsentry/sentry-mcp リポジトリで管理しており、主に https://mcp.sentry.dev/mcp のホスト型リモートサービスとして OAuth サインインで動作します。Sentry によれば、ツールの選定は Sentry API をすべて公開することではなく、人が関与するデバッグワークフローに重点を置いています。npm で @sentry/mcp-server として公開されている stdio トランスポートもあり、セルフホスト版 Sentry で使う最も簡単な方法です。

Sentry MCP Server (Official) の使い方

Sentry アカウントが必要です。ホスト型サーバーではインストールは不要で、最初の接続時にブラウザで OAuth フローが開き、Sentry アカウントと連携します。

ベースエンドポイントは https://mcp.sentry.dev/mcp です。1 つの組織（https://mcp.sentry.dev/mcp/{organizationSlug}）や 1 つのプロジェクト（https://mcp.sentry.dev/mcp/{organizationSlug}/{projectSlug}）にスコープを絞ることもできます。スコープを指定すると、ツールはその組織やプロジェクトを既定値として使い、不要な検出系ツールは非表示になります。Sentry は可能な限りプロジェクト単位のスコープを推奨しています。?experimental=1 を付けると実験的なツールが有効になります。

Claude Code

HTTP でリモートサーバーを追加します。

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

または Claude Code プラグインをインストールします。sentry-mcp サブエージェントが追加され、Sentry のエラー、issue、トレース、パフォーマンスについて尋ねると Claude が自動的に委任します。

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

Cursor

mcp.sentry.dev の "Install MCP Server" ボタンを使うか、MCP 設定に次を追加します。

{
  "mcpServers": {
    "sentry": {
      "url": "https://mcp.sentry.dev/mcp/{organizationSlug}/{projectSlug}"
    }
  }
}

VS Code

コマンドパレットで "MCP: Add Server" を実行し、HTTP を選んで https://mcp.sentry.dev/mcp/{organizationSlug}/{projectSlug} を入力します。

Claude Desktop とその他の stdio クライアント

ローカルサーバーを起動するクライアント（またはセルフホスト版 Sentry）では、org:read、project:read、project:write、team:read、team:write、event:write のスコープを持つ Sentry User Auth Token を作成し、stdio パッケージを使います。

{
  "mcpServers": {
    "sentry": {
      "command": "npx",
      "args": ["@sentry/mcp-server"],
      "env": {
        "SENTRY_ACCESS_TOKEN": "your-token",
        "EMBEDDED_AGENT_PROVIDER": "openai",
        "OPENAI_API_KEY": "sk-..."
      }
    }
  }
}

LLM プロバイダー関連の変数は AI 搭載の検索ツールを使う場合にのみ必要です。直接実行することもできます。

npx @sentry/mcp-server@latest --access-token=sentry-user-token

セルフホスト版 Sentry では --host=sentry.example.com（ホスト名のみ）を追加し、プレーン HTTP しか提供しない環境では --insecure-http も追加します。

明示的なトークンでリモート接続する

カスタムヘッダーに対応したクライアントは、OAuth を使わずに Sentry API トークンを直接渡せます。

{
  "mcpServers": {
    "sentry": {
      "url": "https://mcp.sentry.dev/mcp",
      "headers": {
        "Authorization": "Sentry-Bearer ${SENTRY_ACCESS_TOKEN}"
      }
    }
  }
}

Sentry MCP Server (Official) の主な機能

• Sentry（getsentry）が開発・管理する公式サーバー。
• OAuth 対応のホスト型リモートエンドポイントで、インストールや更新作業は不要。
• 組織・プロジェクト単位のスコープ付き URL で slug を自動設定し、不要な検出系ツールを非表示に。
• issue やイベント（errors、logs、spans、metrics、profiles、replays）を自然言語で検索。
• Seer 連携による根本原因分析とコード修正の提案。
• issue のトリアージ操作：解決、再オープン、無視、担当者の割り当て。
• release、チーム、DSN、ドキュメント検索などのロングテール操作向けのツールカタログ（search_sentry_tools / execute_sentry_tool）。
• セルフホスト版 Sentry 向けの stdio トランスポートと、有効・無効を切り替えられる skills（例：--skills=inspect,seer、--disable-skills=project-management）。

Sentry MCP Server (Official) のツール

mcp.so のページには 9 個のトップレベルツールが掲載されています。

• 検出：find_organizations と find_projects は、他のツールが必要とする組織やプロジェクトの slug を調べます。URL がスコープ済みの場合は非表示になります。
• 検索：search_issues はグループ化された issue の一覧（例：is:unresolved level:error）を返し、search_events は errors、logs、spans、metrics、profiles、replays にわたるカウント、集計、個別イベントを扱います。どちらも自然言語と Sentry の検索構文に対応しています。
• 参照：get_sentry_resource は Sentry の URL や ID から issue、イベント、トレース、span、replay、モニター、AI 会話を取得します。
• 修正とトリアージ：analyze_issue_with_seer は Seer による根本原因分析を実行し（新規分析には約 2〜5 分かかり、結果はキャッシュされます）、update_issue はステータスや担当者を変更します。
• カタログ：search_sentry_tools はトップレベルで公開されていない操作を探し、execute_sentry_tool がそれを実行します（例：whoami）。

Sentry MCP Server (Official) のユースケース

• エディターから本番環境のバグを修正：「https://my-org.sentry.io/issues/PROJECT-123/ を確認して、このリポジトリで根本原因を修正して」
• 新しいエラーをトリアージ：「my-project で過去 24 時間に初めて発生した未解決のエラーを表示して」
• 統計を確認：「今日のエラー数を issue ごとに集計して」
• AI による修正案を取得：「この issue で Seer を実行して修正を提案して」
• issue キューを整理：「PROJECT-123 を解決済みにして、PROJECT-456 を自分に割り当てて」
• パフォーマンスを調査：「過去 1 時間で最も遅いデータベース span を探して」

Sentry MCP Server (Official) と代替ツールの比較

• ホスト型リモート vs stdio：mcp.sentry.dev のリモートサーバーは OAuth を使い、検索に LLM キーは不要です。stdio パッケージはユーザー認証トークンが必要で、AI 搭載の検索ツールには LLM プロバイダーのキーも必要ですが、セルフホスト版 Sentry に接続できます。
• Claude Code プラグイン vs 通常の MCP：プラグインは同じサーバーを専用サブエージェントとしてまとめたもので、claude mcp add はツールをメインエージェントに直接公開します。
• コミュニティ版 Sentry サーバー：一部のディレクトリには小規模なコミュニティ製 Sentry MCP プロジェクトも掲載されています。公式の getsentry サーバーは Sentry が管理し、ドキュメントを提供しているものです。

Sentry MCP Server (Official) のトラブルシューティング

• AI 検索ツールが表示されない（stdio）：自然言語検索には LLM プロバイダー（OpenAI、Azure OpenAI、Anthropic、OpenRouter）が必要です。API キーを設定し、EMBEDDED_AGENT_PROVIDER を明示的に指定してください。それ以外のツールはなくても動作します。
• セルフホスト環境で Seer ツールがない：Seer はセルフホスト版 Sentry に含まれないため、--host が sentry.io 以外を指すと seer skill は外されます。Seer を運用している場合は --skills=inspect,seer を追加してください。
• プレーン HTTP のセルフホスト環境に接続できない：--insecure-http を追加し、--host にはホスト名のみを渡します。
• トークン使用時に権限エラーが出る：ユーザー認証トークンに上記のスコープが含まれているか確認してください。
• 127.0.0.1 上の MCP Inspector で OAuth が失敗する：代わりに localhost を使ってください。