Sentry MCP Server

Sentry MCP サーバー

Sentryと連携するためのモデルコンテキストプロトコル（MCP）サーバー。このMCPサーバーは、Sentry APIと連携するためのツールを提供し、AIアシスタントによるエラーデータの取得と分析、プロジェクトの管理、アプリケーションパフォーマンスの監視を可能にします。

要件

• Node.js (v14以上)
• npmまたはyarn
• APIアクセス可能なSentryアカウント
• 適切な権限を持つ Sentry 認証トークン

設定

1. 依存関係をインストールします:
   npm install

IDE内でこれを使用する

この MCP は Codeium Windsurf に対して動作することが検証されています。

Cursor は現在 MCP 実装に問題があり、このツールはまだ完全には機能していません。

クロードと一緒に使う

この MCP サーバーを Claude で使用するには、Claude 設定に次の構成を追加します。

• argsフィールドにディレクトリ パスを更新します。
• <YOUR_AUTH_TOKEN> Sentry 認証トークンに置き換えます。

利用可能なツール

プロジェクト一覧

特定の組織でアクセス可能なすべての Sentry プロジェクトを一覧表示します。

パラメータ:

• organization_slug (文字列、必須): プロジェクトを一覧表示する組織のスラッグ
• view (文字列、オプション): ビューの種類。「summary」または「detailed」のいずれか (デフォルト: 「detailed」)
• format (文字列、オプション): 出力形式。「plain」または「markdown」のいずれか (デフォルト:「markdown」)

解決短いID

短い ID を使用して問題の詳細を取得します。

パラメータ:

• organization_slug (文字列、必須): 問題が属する組織のスラッグ
• short_id （文字列、必須）: 解決する問題の短縮ID（例：PROJECT-123）
• format (文字列、オプション): 出力形式。「plain」または「markdown」のいずれか (デフォルト:「markdown」)

get_sentry_event

問題から特定の Sentry イベントを取得して分析します。

パラメータ:

• issue_id_or_url (文字列、必須): Sentry の問題 URL 全体、または数値の問題 ID のみ
• event_id (文字列、必須): 取得する特定のイベントID
• view (文字列、オプション): ビューの種類。「summary」または「detailed」のいずれか (デフォルト: 「detailed」)
• format (文字列、オプション): 出力形式。「plain」または「markdown」のいずれか (デフォルト:「markdown」)

プロジェクト内のエラーイベントのリスト

特定の Sentry プロジェクトからのエラー イベントを一覧表示します。

パラメータ:

• organization_slug (文字列、必須): プロジェクトが属する組織のスラッグ
• project_slug (文字列、必須): イベントを一覧表示するプロジェクトのスラッグ
• view (文字列、オプション): ビューの種類。「summary」または「detailed」のいずれか (デフォルト: 「detailed」)
• format (文字列、オプション): 出力形式。「plain」または「markdown」のいずれか (デフォルト:「markdown」)

プロジェクトを作成

Sentry に新しいプロジェクトを作成し、そのクライアント キーを取得します。

パラメータ:

• organization_slug (文字列、必須): プロジェクトを作成する組織のスラッグ
• team_slug (文字列、必須): プロジェクトを割り当てるチームのスラッグ
• name (文字列、必須): 新しいプロジェクトの名前
• platform （文字列、オプション）: 新しいプロジェクトのプラットフォーム
• view (文字列、オプション): ビューの種類。「summary」または「detailed」のいずれか (デフォルト: 「detailed」)
• format (文字列、オプション): 出力形式。「plain」または「markdown」のいずれか (デフォルト:「markdown」)

プロジェクトの問題一覧

特定の Sentry プロジェクトの問題を一覧表示します。

パラメータ:

• organization_slug (文字列、必須): プロジェクトが属する組織のスラッグ
• project_slug (文字列、必須): 問題を一覧表示するプロジェクトのスラッグ
• view (文字列、オプション): ビューの種類。「summary」または「detailed」のいずれか (デフォルト: 「detailed」)
• format (文字列、オプション): 出力形式。「plain」または「markdown」のいずれか (デフォルト:「markdown」)

問題イベント一覧

特定の Sentry の問題に関するイベントを一覧表示します。

パラメータ:

• organization_slug (文字列、必須): 問題が属する組織のスラッグ
• issue_id (文字列、必須): イベントを一覧表示する問題のID
• view (文字列、オプション): ビューの種類。「summary」または「detailed」のいずれか (デフォルト: 「detailed」)
• format (文字列、オプション): 出力形式。「plain」または「markdown」のいずれか (デフォルト:「markdown」)

get_sentry_issue

Sentry の問題を取得して分析します。

パラメータ:

• issue_id_or_url (文字列、必須): Sentry の問題 URL 全体、または数値の問題 ID のみ
• view (文字列、オプション): ビューの種類。「summary」または「detailed」のいずれか (デフォルト: 「detailed」)
• format (文字列、オプション): 出力形式。「plain」または「markdown」のいずれか (デフォルト:「markdown」)

リスト組織リプレイ

特定の Sentry 組織からのリプレイを一覧表示します。

パラメータ:

• organization_slug (文字列、必須): リプレイを一覧表示する組織のスラッグ
• project_ids (文字列[], オプション): リプレイをフィルタリングするプロジェクトIDのリスト
• environment （文字列、オプション）：リプレイをフィルタリングする環境
• stats_period (文字列、オプション): 統計の期間 (例: "24h"、"7d")
• start (文字列、オプション): リプレイのフィルタリングの開始日
• end (文字列、オプション): リプレイのフィルタリングの終了日
• sort (文字列、オプション): リプレイを並べ替えるフィールド
• query （文字列、オプション）: リプレイをフィルタリングするための検索クエリ
• per_page (数値、オプション): ページあたりのリプレイ数
• cursor （文字列、オプション）：ページ区切りのカーソル
• view (文字列、オプション): ビューの種類。「summary」または「detailed」のいずれか (デフォルト: 「detailed」)
• format (文字列、オプション): 出力形式。「plain」または「markdown」のいずれか (デフォルト:「markdown」)

サーバーの実行

認証

このツールを使用するには、Sentry APIにアクセスするための適切な権限を持つSentry認証トークンが必要です。トークンは、Sentryアカウント設定の「APIキー」で生成できます。

エラー処理

サーバーには、次の包括的なエラー処理が含まれています。

• 認証トークンがありません
• APIリクエストの失敗
• 無効なパラメータ
• ネットワークエラー

すべてのエラーはデバッグのためにコンソールに記録されます。