Sentry MCP

Sentry MCPとは？

Sentry MCPは、標準化されたモデルコンテキストプロトコルを通じて、Sentryデータおよびアクションへの安全で構造化されたアクセスを提供するために設計されたオープンソースのMCPサーバーです。Claude DesktopやIDEのようなホストアプリケーションが、MCP準拠のツールとエンドポイントを介してSentryとプログラムで対話することを可能にします。リモートとローカル（stdio）の両方のトランスポートをサポートしているため、クラウドまたは自己ホストのSentryインストールの両方に柔軟性があります。

設定方法

1. 本番使用:
   展開されたサービスにアクセスします: https://mcp.sentry.dev。

2. 自己ホストのSentry（Stdioトランスポート）:

   • 適切なスコープを持つSentryユーザー認証トークンを作成します:

     org:read
     project:read
     project:write
     team:read
     team:write
     event:write
     

   • MCPサーバーを起動します:

     npx @sentry/mcp-server@latest --access-token=sentry-user-token --host=sentry.example.com
     

   • または、環境変数で設定します:

     SENTRY_ACCESS_TOKEN=
     SENTRY_HOST=
     

3. ローカル開発:

   • SentryでのOAuthアプリを作成し、http://localhost:5173をホームページURLおよびリダイレクトURIにします。
   • packages/mcp-cloudflare/内の.dev.varsに認証情報を追加します:

     SENTRY_CLIENT_ID=your_client_id
     SENTRY_CLIENT_SECRET=your_client_secret
     COOKIE_SECRET=my-super-secret-cookie
     

   • サーバーをローカルで実行します:

     pnpm dev
     

使用方法

1. ホストされたサーバーにアクセスします: https://mcp.sentry.dev、または上記の方法でローカル/stdioインスタンスを実行します。
2. MCPインスペクターを使用します:
   • サーバーのURLを入力（例: http://localhost:5173）し、接続します。
   • プロンプトに従って認証します（OAuthまたはアクセストークン）。
   • 「ツール一覧」機能で利用可能なツールを発見します。
   • 必要なツールエンドポイント（例: イシューの取得、プロジェクトの一覧）をインスペクターからまたはLLM対応クライアントを通じて直接呼び出します。
3. 自己ホストのSentryでは、関連するトークンを使用して実行し、「stdio」モードで接続します。
4. pnpm testでテストを実行し、pnpm evalでLLMサポートの評価を実行します（OPENAI_API_KEYを設定後）。

主な特徴

• MCP準拠プロトコルを介したSentryとの統合により、LLM/エージェントがエラーデータや操作にアクセス可能
• リモートHTTP(S)とローカルstdioトランスポートの両方をサポートし、デプロイメントタイプに応じた柔軟性を提供
• Sentryリソースへの安全なアクセスのためのOAuthとトークンベースの認証
• 自動化とデータ取得のための実行可能なツール（アクション/エンドポイント）の事前構築されたセット
• ローカル開発および貢献のために拡張可能でオープン
• インタラクティブな探索およびテストのためのビルトインインスペクターツールを含む

利用例

• LLMベースのエージェントまたはコパイロットが、IDEや統合デスクトップ環境内でSentryのインシデントを監視、取得、またはトリアージできるようにする
• AIワークフローによってトリガーされる、イシューの割り当て、ステータス変更、通知などの定期的なSentryアクションを自動化
• 言語モデルを活用したカスタムダッシュボードや報告ツールにSentryの可観測性データを統合
• 手動スクリプトなしで、安全で標準化されたAPIを通じてゼロタッチのSentry管理またはトリアージを可能にする

FAQ

Q1: 自己ホストのSentryインスタンスでSentry MCPを使用できますか？
はい、Sentry MCPはstdioトランスポートモードを介して自己ホストインスタンスをサポートしています。必要な権限を持つユーザー認証トークンを提供し、ホストを適切に設定する必要があります。

Q2: Sentry MCPをローカルでテストするためにOAuthアプリを構築する必要がありますか？
ローカル開発とテストには、SentryアカウントでOAuthアプリを登録し、その認証情報をプロジェクトの設定ファイルに提供する必要があります。

Q3: LLMはMCPツールを通じて私のSentryデータを変更できますか？
はい、MCPを介して公開されたツールは、ツールとトークンの権限に応じてSentryのデータを読み取ったり変更したりできます。提供するトークンは、必要なスコープのみに制限してください。

Q4: MCPサーバーの統合をテストするにはどうすればよいですか？
MCPサーバーのURLに接続して、ビルトインのインスペクターツールを使用します。これにより、認証、発見、およびツールをインタラクティブに呼び出すことができます。

Q5: どのような認証方法がサポートされていますか？
Sentry MCPは、リモートサーバー用のOAuthとローカル/stdio用のアクセストークンベースの認証フローの両方をサポートしています。