Raygun MCP Server について
Raygun MCP Serverは、AIアシスタントからRaygunのクラッシュレポート、リアルユーザーモニタリング、アプリケーション性能データを自然言語で調べられるホスト型リモートサービスです。デプロイ、顧客セッション、チーム連携、エラー管理のツールも提供します。
主な機能
- 01エラーグループとスタックトレースの検索
- 02エラーとデプロイの関連付け
- 03ページとバックエンド性能の分析
- 04顧客プロフィールとセッションの確認
- 05エラー状態、コメント、招待の管理
- 06性能メトリクスと傾向の調査
活用シーン
- 01直近のデプロイで発生したエラーの追跡
- 02頻発する本番エラーとトレースの調査
- 03遅いバックエンドリクエストの特定
- 04顧客セッションでの問題の分析
MCP 対応
Streamable HTTP経由で、Raygunのクラッシュレポート、リアルユーザーモニタリング、アプリケーション性能監視、デプロイ、チーム管理のツールを提供するリモートMCPサービスです。OAuthとパーソナルアクセストークン認証に対応します。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://api.raygun.com/v3/mcpclaude mcp add --transport http raygun https://api.raygun.com/v3/mcp{"mcpServers":{"raygun":{"type":"http","url":"https://api.raygun.com/v3/mcp"}}}Cursor で開く{"servers":{"raygun":{"type":"http","url":"https://api.raygun.com/v3/mcp"}}}VS Code で開く{"mcpServers":{"raygun":{"type":"http","url":"https://api.raygun.com/v3/mcp"}}}{"mcpServers":{"raygun":{"serverUrl":"https://api.raygun.com/v3/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
詳細
🔭 Raygun MCP サーバー
AI アシスタントを使って Raygun のエラーとパフォーマンスを調査
AI アシスタントを Raygun の Crash Reporting、Real User Monitoring、Application Performance Monitoring に接続するリモート Model Context Protocol(MCP)サーバーです。
✨ 主な機能
- 🐛 エラー管理 - スタックトレースとコンテキストを確認しながら、アプリケーションのエラーやクラッシュを調査、解決、追跡できます
- 🚀 デプロイの追跡 - リリースを監視し、エラーとデプロイを関連付けて、問題の原因となった変更を特定できます
- ⚡ パフォーマンス分析 - ページの読み込み時間、ユーザーメトリクス、パフォーマンスの経時的な傾向を分析できます
- 🔬 APM 調査 - バックエンドのボトルネック、繰り返し発生するパフォーマンスの問題、遅いトレースを特定できます
- 👥 ユーザー監視 - 顧客のセッションや行動パターンを追跡し、影響を受けたユーザーを特定できます
- 🤝 チームコラボレーション - 招待を管理し、チームでエラー解決に取り組めます
- 📊 メトリクスと分析 - エラーとパフォーマンスの時系列分析や分布ヒストグラムを利用できます
📋 要件
- 有効なサブスクリプションを持つ Raygun アカウント
- OAuth に対応した MCP クライアント、または Raygun Personal Access Token
🚀 はじめに
Raygun MCP サーバーのホスト先:
https://api.raygun.com/v3/mcp
サービスは Raygun がホストおよび更新するため、パッケージやローカルサーバーをインストールする必要はありません。
OAuth(推奨)
URL を Authorization ヘッダーなしで Streamable HTTP サーバーとして追加します。初回接続時に、MCP クライアントによってブラウザーで Raygun が開きます。サインインし、プランを選択して、要求された権限を確認したうえで、アクセスを許可してください。
OAuth クライアント ID やクライアントシークレットを指定する必要はありません。Raygun はクライアントの自動登録をサポートしています。
Codex と ChatGPT デスクトップアプリ
codex mcp add raygun --url https://api.raygun.com/v3/mcp
codex mcp login raygun
この設定は、同じ Codex ホスト上の Codex CLI、Codex IDE 拡張機能、ChatGPT デスクトップアプリで共有されます。
ChatGPT デスクトップアプリで、設定 > MCP サーバーを開き、サーバーを追加を選択して、Streamable HTTPを選び、Raygun のエンドポイントを入力します。保存してアプリを再起動し、Raygun の認証を選択します。
ChatGPT のウェブ版では、プラグインを通じてリモート MCP ツールを利用します。ローカルの Codex MCP 設定は読み込みません。別途公開されている Raygun プラグインは、プラグインカタログからインストールします。
Claude Code
claude mcp add --transport http raygun https://api.raygun.com/v3/mcp
Claude Code で /mcp を実行し、ブラウザーでの認証フローに従います。
Cursor
{
"mcpServers": {
"raygun": {
"url": "https://api.raygun.com/v3/mcp"
}
}
}
接続時に、Cursor から認証を求められます。
VS Code
{
"servers": {
"raygun": {
"type": "http",
"url": "https://api.raygun.com/v3/mcp"
}
}
}
接続時に、VS Code から認証を求められます。
Personal Access Token
MCP OAuth に対応していないクライアントや自動化では、PAT 認証も引き続き利用できます。以下の例では Cursor の設定形式を使用しています。他のクライアントでも、HTTP サーバーの設定で同じ Authorization ヘッダーを使用します。
{
"mcpServers": {
"raygun": {
"url": "https://api.raygun.com/v3/mcp",
"headers": {
"Authorization": "Bearer YOUR_PAT_TOKEN"
}
}
}
}
💬 最初のプロンプト
設定が完了したら、AI アシスタントに次のように尋ねてみましょう。
- 「チェックアウトアプリケーションの最新のデプロイ後に初めて発生したエラーを探してください。」
- 「本番環境で最も頻繁に発生しているエラーを調査し、代表的なスタックトレースを表示してください。」
- 「過去 24 時間で最も時間を消費したバックエンドメソッドまたはデータベースクエリはどれですか?」
- 「顧客
[email protected]の直近のセッションを表示し、どこでユーザー体験に問題が発生したか説明してください。」 - 「過去 7 日間のページパフォーマンスの p95 を比較し、最も大きなリグレッションを特定してください。」
🛠️ ツール
Raygun MCP サーバーでは、次のカテゴリのツールを利用できます。
📱 アプリケーション
applications_list- Raygun アカウント内のすべてのアプリケーションを一覧表示しますapplications_search- 名前でアプリケーションを検索しますapplication_get_details- アプリケーションの詳細情報を取得しますapplication_regenerate_api_key- アプリケーションの新しい API キーを生成します
🐛 エラー管理
error_groups_list- アプリケーション内のエラーグループを一覧表示しますerror_groups_search- エラー、スタックトレース、URL、バージョン、ユーザー、タグ、カスタムデータで発生箇所を検索しますerror_group_investigate- 特定のエラーグループの詳細情報を取得しますerror_group_update_status- エラーグループのステータスを変更します(解決、無視、有効化)error_group_add_comment- エラーグループに調査メモを追加しますerror_group_read_comments- 既存の調査メモを確認しますerror_group_instances_list- エラーグループ内の発生箇所を一覧表示しますerror_instance_get- 発生箇所のスタックトレースとコンテキスト全体を取得します
🚀 デプロイ
deployments_list- アプリケーションのデプロイを一覧表示しますdeployment_create- 新しいデプロイ記録を作成しますdeployment_get_latest- エラー分析とともに最新のデプロイを取得しますdeployment_investigate- デプロイの包括的な情報を取得しますdeployment_manage- デプロイを更新または削除します
👥 顧客とセッション
customers_search- 名前、メールアドレス、識別子で顧客を検索しますcustomer_investigate- 顧客のプロフィール、最近のエラーグループ、セッションを取得しますsessions_list- 環境およびデバイスデータとともにユーザーセッションを一覧表示しますsession_investigate- セッションの環境、エラー、ページビューを調査します
🔬 アプリケーションパフォーマンスモニタリング
apm_issues_search- 繰り返し発生するバックエンドのパフォーマンス問題やアンチパターンを検索しますapm_issue_investigate- 問題のメトリクスと影響を受けたトレースを調査しますapm_traces_search- 遅い、または失敗しているバックエンドリクエストを検索しますapm_trace_investigate- トレース内のプロファイラースレッドと重要な呼び出しを調査しますapm_hotspots_search- 遅いメソッド、データベースクエリ、外部呼び出しを順位付けします
📊 パフォーマンスとメトリクス
pages_list- アプリケーション内の監視対象ページを一覧表示しますpage_investigate- メトリクスのクエリに必要なページの詳細を取得しますmetrics_website_performance_analyze- パフォーマンスの推移を時系列で追跡しますmetrics_performance_distribution_analyze- パフォーマンスのばらつきを把握しますmetrics_error_trends_analyze- エラー率とパターンを追跡します
🤝 チーム管理
invitations_manage- チームへの招待を一覧表示して確認しますinvitation_send- 新しいチーム招待を送信しますinvitation_revoke- 保留中の招待を取り消します
各ツールの詳細なドキュメントについては、ツールリファレンスをご覧ください。
🔐 認証
OAuth
Raygun は、HTTP クライアント向けに MCP 認可フローを実装しています。サーバーは OAuth 保護リソースメタデータを通じて認可サーバーを提示し、互換性のあるクライアントはクライアント ID メタデータドキュメントまたは動的クライアント登録を使用して自動的に登録されます。
アクセス権は、Raygun のユーザー、プラン、および同意画面で承認されたスコープに紐づきます。互換性のあるクライアントは、独自のトークンを安全に保存し、更新します。
OAuth 接続ごとに、1 つの Raygun プランへのアクセス権が付与されます。別のプランを利用する場合は、Raygun MCP の設定をもう 1 つ追加し、別途認可してください。
セキュリティとアクセス
- OAuth によって、サインイン中の Raygun ユーザーがすでに持っている以上のアクセス権がクライアントに付与されることはありません。
- 読み取りおよび書き込みのアクセス権は、OAuth 中に承認されたスコープ、または PAT に割り当てられたスコープによって制御されます。
- エラーのステータス、デプロイ、招待、コメント、取り込み API キーなど、Raygun のデータを変更できるツールもあります。MCP クライアントで承認する前に、書き込み操作を確認してください。
- アプリケーションツールは、取り込み API キーを返したり、ローテーションしたりできます。返されたキーは認証情報として扱ってください。キーをローテーションすると、以前のキーはただちに無効になります。
- ツールの結果は、選択した AI クライアントまたはモデルプロバイダーによって処理される会話に含まれる場合があります。診断データや顧客データの共有については、所属組織のポリシーに従ってください。
Personal Access Token の取得
OAuth が適さない場合は、引き続き PAT を利用できます。
- Raygun Personal Access Tokens に移動します
- Create New Token をクリックします
- トークンにわかりやすい名前(例:「MCP Server Access」)を付けます
- 用途に適した権限を選択します
- 生成されたトークンをコピーし、
Authorization: Bearer YOUR_PAT_TOKENとして送信します
PAT は安全に保管し、バージョン管理にコミットしないでください。
詳しくは、Raygun API documentation をご覧ください。
📖 概要
Raygun MCP サーバーを使うと、AI アシスタントが自然言語での会話を通じて、Crash Reporting、RUM、APM のデータを調査し、デプロイを追跡し、パフォーマンスを分析し、アプリケーションのモニタリングを管理できます。
🔗 リソース
- 📚 Raygun Documentation
- 📘 Raygun MCP Setup Guide
- 🔌 Raygun API Reference
- 🤖 Model Context Protocol
- 🐛 問題を報告
Raygun が ❤️ を込めて開発
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。