Sentry MCP Server について
エラーの調査やプロジェクト管理を行う AI アシスタント向けの、独立した Sentry MCP サーバーです。学習用途を想定し、Sentry API の操作を提供します。README では、より多くの機能を備えた新しい Sentry Remote-MCP Server が推奨されています。
主な機能
- 01プロジェクトと課題の一覧取得
- 02課題とイベントの詳細取得
- 03エラーイベントとリプレイの一覧取得
- 04Sentry プロジェクトの作成
- 05要約または詳細形式の選択
活用シーン
- 01短縮 ID で課題を調査
- 02プロジェクト内のエラーイベントを確認
- 03環境や期間で組織のリプレイを絞り込み
- 04Sentry プロジェクトを作成してクライアントキーを取得
MCP 対応
MCP クライアントに Sentry API のツールを公開し、エラー、課題、イベント、プロジェクト、リプレイの読み取りとプロジェクト作成を可能にします。Sentry 認証トークンが必要です。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
注記 - このサーバーは、より多くの機能(認証、より優れたツールなど)をサポートする Sentry の Remote-MCP Server にほぼ置き換えられています。このサーバーは、スタンドアロンの MCP サーバーとしての教育目的で用意されていますが、おそらくリモート版を使うことになるでしょう。https://mcp.sentry.dev で実際の動作を確認できます。
Sentry MCP サーバー
Sentry と連携するための Model Context Protocol(MCP)サーバーです。この MCP サーバーは、Sentry API と連携するツールを提供し、AI アシスタントがエラーデータの取得と分析、プロジェクトの管理、アプリケーションのパフォーマンス監視を行えるようにします。
要件
- Node.js(v14 以降)
- npm または yarn
- API アクセス権のある Sentry アカウント
- 適切な権限を持つ Sentry 認証トークン
セットアップ
- 依存関係をインストールします:
npm install
IDE 内での使用
この MCP は、Cursor、Codeium Windsurf、Claude Desktop で動作することを確認済みです。
Claude での使用
この MCP サーバーを Claude で使用するには、次の設定を Claude の設定に追加します:
{
"mcpServers": {
"sentry": {
"command": "npx",
"args": ["ts-node", "/Users/<your-user-directory>/sentry-mcp-ts/index.ts"],
"env": {
"SENTRY_AUTH": "<YOUR_AUTH_TOKEN>"
}
}
}
}
argsフィールドにディレクトリのパスを指定します。<YOUR_AUTH_TOKEN>を Sentry 認証トークンに置き換えます。
利用可能なツール
list_projects
指定した組織でアクセス可能なすべての Sentry プロジェクトを一覧表示します。
パラメーター:
organization_slug(string、必須):プロジェクト一覧の取得元となる組織のスラッグview(string、任意):ビューの種類。「summary」または「detailed」(デフォルト:「detailed」)format(string、任意):出力形式。「plain」または「markdown」(デフォルト:「markdown」)
resolve_short_id
ショート ID を使用して、イシューの詳細を取得します。
パラメーター:
organization_slug(string、必須):イシューが属する組織のスラッグshort_id(string、必須):解決するイシューのショート ID(例:PROJECT-123)format(string、任意):出力形式。「plain」または「markdown」(デフォルト:「markdown」)
get_sentry_event
イシューから特定の Sentry イベントを取得し、分析します。
パラメーター:
issue_id_or_url(string、必須):Sentry イシューの完全な URL、または数値のイシュー IDevent_id(string、必須):取得する特定のイベント IDview(string、任意):ビューの種類。「summary」または「detailed」(デフォルト:「detailed」)format(string、任意):出力形式。「plain」または「markdown」(デフォルト:「markdown」)
list_error_events_in_project
特定の Sentry プロジェクトのエラーイベントを一覧表示します。
パラメーター:
organization_slug(string、必須):プロジェクトが属する組織のスラッグproject_slug(string、必須):イベント一覧の取得元となるプロジェクトのスラッグview(string、任意):ビューの種類。「summary」または「detailed」(デフォルト:「detailed」)format(string、任意):出力形式。「plain」または「markdown」(デフォルト:「markdown」)
create_project
Sentry に新しいプロジェクトを作成し、そのクライアントキーを取得します。
パラメーター:
organization_slug(string、必須):プロジェクトを作成する組織のスラッグteam_slug(string、必須):プロジェクトを割り当てるチームのスラッグname(string、必須):新しいプロジェクトの名前platform(string、任意):新しいプロジェクトのプラットフォームview(string、任意):ビューの種類。「summary」または「detailed」(デフォルト:「detailed」)format(string、任意):出力形式。「plain」または「markdown」(デフォルト:「markdown」)
list_project_issues
特定の Sentry プロジェクトのイシューを一覧表示します。
パラメーター:
organization_slug(string、必須):プロジェクトが属する組織のスラッグproject_slug(string、必須):イシュー一覧の取得元となるプロジェクトのスラッグview(string、任意):ビューの種類。「summary」または「detailed」(デフォルト:「detailed」)format(string、任意):出力形式。「plain」または「markdown」(デフォルト:「markdown」)
list_issue_events
特定の Sentry イシューのイベントを一覧表示します。
パラメーター:
organization_slug(string、必須):イシューが属する組織のスラッグissue_id(string、必須):イベントを一覧表示するイシューの IDview(string、省略可):ビューの種類。「summary」または「detailed」(デフォルト:「detailed」)format(string、省略可):出力形式。「plain」または「markdown」(デフォルト:「markdown」)
get_sentry_issue
Sentry イシューを取得して分析します。
パラメーター:
issue_id_or_url(string、必須):Sentry イシューの完全な URL、または数値のイシュー IDview(string、省略可):ビューの種類。「summary」または「detailed」(デフォルト:「detailed」)format(string、省略可):出力形式。「plain」または「markdown」(デフォルト:「markdown」)
list_organization_replays
特定の Sentry 組織のリプレイを一覧表示します。
パラメーター:
organization_slug(string、必須):リプレイを一覧表示する組織のスラッグproject_ids(string[]、省略可):リプレイの絞り込みに使用するプロジェクト ID の一覧environment(string、省略可):リプレイの絞り込みに使用する環境stats_period(string、省略可):統計の対象期間(例:「24h」、「7d」)start(string、省略可):リプレイの絞り込みに使用する開始日end(string、省略可):リプレイの絞り込みに使用する終了日sort(string、省略可):リプレイの並べ替えに使用するフィールドquery(string、省略可):リプレイの絞り込みに使用する検索クエリper_page(number、省略可):1 ページあたりのリプレイ数cursor(string、省略可):ページネーション用のカーソルview(string、省略可):ビューの種類。「summary」または「detailed」(デフォルト:「detailed」)format(string、省略可):出力形式。「plain」または「markdown」(デフォルト:「markdown」)
サーバーの実行
npx ts-node index.ts
認証
このツールを使用するには、Sentry API にアクセスするための適切な権限を持つ Sentry 認証トークンが必要です。Sentry アカウントの設定で、Settings -> User Settings -> Auth Tokens の順に移動すると、トークンを生成できます。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。