セントリーMCP

これは、上流の Sentry API プロバイダーへのミドルウェアとして機能するリモート MCP サーバーのプロトタイプです。

これは、Cloudflare のリモート MCP に向けた取り組みに基づいています。

はじめる

運用環境にデプロイされたサービスにアクセスすると、必要な情報がすべて見つかります。

https://mcp.sentry.dev

貢献したい場合、仕組みを知りたい場合、またはセルフホスト型 Sentry でこれを実行したい場合は、以下に進んでください。

Stdioとリモート

このリポジトリはMCPサービスとしての動作に重点を置いていますが、 stdioトランスポートもサポートしています。これはまだ開発中ですが、セルフホスト型のSentryインストールに対してMCPを実行するための最も簡単な方法です。

stdoioトランスポートを利用するには、必要なスコープを持つSentryでPersonal API Token（PAT）を作成する必要があります。執筆時点では以下のとおりです。

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

トランスポートを起動します:

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

注: 環境変数を使用することもできます。

SENTRY_AUTH_TOKEN=
SENTRY_HOST=

MCP検査官

MCP には、サービスを簡単にテストするためのInspectorが含まれています。

pnpm inspector

https://[domain].workers.dev/sse (TODO) と入力し、「接続」をクリックします。認証フローが完了すると、ツールが動作しているのが確認できます。

Claude Desktop からリモート MCP サーバーにアクセスする

Claude Desktopを開き、「設定」に移動し、 ⌘ + , (カンマ) を押して「開発」>「設定の編集」に進みます。これにより、ClaudeがアクセスできるMCPサーバーを制御する設定ファイルが開きます。

以下の設定に置き換えてください。Claude Desktopを再起動すると、ブラウザウィンドウが開き、OAuthログインページが表示されます。認証フローを完了して、ClaudeにMCPサーバーへのアクセスを許可してください。アクセスを許可すると、ツールが使用できるようになります。

{
  "mcpServers": {
    "math": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp-github-oauth.<your-subdomain>.workers.dev/sse"
      ]
    }
  }
}

ツール（🔨の下）がインターフェースに表示されたら、クロードにそれらを使うように頼むことができます。例えば、「数学ツールを使って23と19を足し算できますか？」と尋ねます。クロードはツールを起動し、MCPサーバーによって生成された結果を表示する必要があります。

地域開発

MCPサーバーの反復テストをローカル開発環境で実行できます。そのためには、Sentryで別のOAuthアプリを作成する必要があります（設定 => API =>アプリケーション）。

ホームページURLにはhttp://localhost:8788を指定します。
承認済みリダイレクトURIには、 http://localhost:8788/callbackを指定します。
クライアント ID をメモし、クライアントシークレットを生成します。
次のようにして、プロジェクトルートに.dev.varsファイルを作成します。

SENTRY_CLIENT_ID=your_development_sentry_client_id
SENTRY_CLIENT_SECRET=your_development_sentry_client_secret

確認する

サーバーをローカルで実行しhttp://localhost:8788で利用できるようにします。

pnpm dev

ローカルサーバーをテストするには、Inspectorにhttp://localhost:8788/sseと入力し、「接続」をクリックします。プロンプトに従うと、「ツールの一覧」が表示されます。

テスト

基本的な単体テストといくつかの評価の 2 つのテストスイートが含まれています。

ユニットテストは以下を使用して実行できます。

pnpm test

評価には、いくつかの設定を含む.envファイルが必要です。

OPENAI_API_KEY=

完了したら、次のコマンドを使用して実行できます。

pnpm test

注記

Claude や他の MCP クライアントの使用

Claude を使用してリモート MCP サーバーに接続すると、エラーメッセージが表示される場合があります。これは、Claude Desktop がまだリモート MCP サーバーをサポートしていないため、正しく動作しないことがあるためです。MCP サーバーに接続されているかどうかを確認するには、Claude インターフェースの右下にある🔨 アイコンにマウスを移動してください。利用可能なツールが表示されます。

カーソルとその他のMCPクライアントの使用

Cursor を MCP サーバーに接続するには、 Type :「コマンド」を選択し、 Commandフィールドでコマンドフィールドと引数フィールドを 1 つに結合します (例npx mcp-remote https://<your-worker-name>.<your-subdomain>.workers.dev/sse )。

Cursor は HTTP+SSE サーバーをサポートしていますが、認証はサポートしていないため、 mcp-remote (HTTP サーバーではなく STDIO サーバー) を使用する必要があります。

クライアントの構成ファイルを開き、Claude セットアップに使用したのと同じ JSON を追加して、MCP クライアントを再起動すると、MCP サーバーを Windsurf などの他の MCP クライアントに接続できます。

Sentry MCP

Integrations