Sentry MCP

🚀 リモートMCPサーバー

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

このサーバーは、CloudflareによるリモートMCPに関する取り組みに基づいています。

🚀 クイックスタート

https://mcp.sentry.dev

Stdioとリモートの比較

このリポジトリは主にリモートMCPの使用シナリオを対象としていますが、stdio伝送もサポートしています。

⚠️ 重要提示

現在、これはドラフトであり、配布によって利用可能になっていません。

あなたのトークンが必要なスコープを持っていることを確認する必要があります。執筆時点での必要スコープは以下の通りです。

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

必要なスコープの規範的な参照は、ソースコードで確認できます。

stdio伝送を開始するには、SENTRY_AUTH_TOKENを設定して提供されたスクリプトを実行します。

SENTRY_AUTH_TOKEN= npm run start:stdio

自前でホストするSentry

SENTRY_URL環境変数を上書きすることで、独自のSentryのベースURLを設定できます。

SENTRY_URL=https://sentry.mycompany.com

MCPインスペクター

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

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"
      ]
    }
  }
}

ツール（🔨の下）が界面に表示されたら、Claudeにそれらを使用させることができます。例えば、「23と19を足す数学ツールを使ってくれますか？」と依頼すると、Claudeがツールを呼び出し、MCPサーバーが生成した結果を表示します。

🔧 ローカル開発

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

• ホームページURLにはhttp://localhost:8788を指定します。
• 承認済みリダイレクトURIにはhttp://localhost:8788/callbackを指定します。
• Client IDをメモし、Client secretを生成します。
• プロジェクトのルートディレクトリに.dev.varsファイルを作成し、以下の内容を記述します。

SENTRY_CLIENT_ID=your_development_sentry_client_id
SENTRY_CLIENT_SECRET=your_development_sentry_client_secret

検証

サーバーをローカルで実行して、http://localhost:8788で利用可能にします。

pnpm dev

ローカルサーバーをテストするには、インスペクターにhttp://localhost:8788/sseを入力し、接続をクリックします。指示に従って操作を完了すると、「ツールを一覧表示」できるはずです。

テスト

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

単体テストは以下のコマンドで実行できます。

pnpm test

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

OAUTH_API_KEY=your_oauth_api_key

その後、以下のコマンドで評価を実行します。

pnpm lint

⚠️ 重要提示

評価スクリプトはコードの品質と書式の問題をチェックします。

📄 その他の注意事項

• このプロジェクトはTypeScriptで記述されているため、Node.jsとnpmがインストールされていることを確認してください。
• 依存関係の管理にはpnpmを使用しています。pnpmに不慣れな場合は、まずそのドキュメントを読んでください。
• プロジェクトには.gitignoreファイルが含まれており、不要なファイルやディレクトリが除外されます。