Raygun
公式Raygunアカウントのクラッシュレポートとリアルユーザーモニタリングデータを操作します。
Raygun MCPで何ができますか?
- エラーグループの調査 —
error_groups_searchとerror_group_investigateを使用してエラーグループを検索・調査し、スタックトレースとコンテキストを取得するよう依頼します。 - デプロイメントの追跡 —
deployment_get_latestまたはdeployment_investigateを使用して、新しいエラーを最近のリリースと関連付けます。 - パフォーマンスの分析 —
metrics_website_performance_analyzeまたはapm_hotspots_searchをクエリして、遅いメソッド、データベースクエリ、ページ読み込みの劣化を見つけます。 - カスタマーセッションの探索 —
customers_searchとsession_investigateでユーザーアクティビティを調べ、エクスペリエンスが失敗した箇所を確認します。 - エラーステータスの管理 —
error_group_update_statusとerror_group_add_commentを使用して、解決状態を更新したりコメントを追加したりします。 - チーム招待の確認 —
invitations_manage、invitation_send、invitation_revokeを使用して、招待を一覧表示、送信、または取り消します。
ドキュメント
🔭 Raygun MCP サーバー
AIアシスタントでRaygunのエラーとパフォーマンスを調査
AIアシスタントをRaygunのクラッシュレポート、リアルユーザーモニタリング、アプリケーションパフォーマンスモニタリングに接続するリモートModel Context Protocol(MCP)サーバーです。
✨ 主な機能
- 🐛 エラー管理 - 完全なスタックトレースとコンテキストを使用して、アプリケーションのエラーやクラッシュを調査、解決、追跡します
- 🚀 デプロイメント追跡 - リリースを監視し、エラーをデプロイメントと関連付けて問題のある変更を特定します
- ⚡ パフォーマンスインサイト - ページの読み込み時間、ユーザーメトリクス、時間経過に伴うパフォーマンス傾向を分析します
- 🔬 APM調査 - バックエンドのボトルネック、繰り返し発生するパフォーマンス問題、遅いトレースを発見します
- 👥 ユーザーモニタリング - 顧客セッション、行動パターンを追跡し、影響を受けたユーザーを特定します
- 🤝 チームコラボレーション - 招待を管理し、チーム全体でのエラー解決を調整します
- 📊 メトリクスと分析 - エラーとパフォーマンスの時系列分析と分布ヒストグラム
📋 要件
- アクティブなサブスクリプションを持つRaygunアカウント
- OAuth対応のMCPクライアント、またはRaygunパーソナルアクセストークン
🚀 はじめに
Raygun MCPサーバーは以下の場所でホストされています:
https://api.raygun.com/v3/mcp
Raygunがサービスをホストおよび更新するため、インストールするパッケージやローカルサーバーはありません。
OAuth(推奨)
AuthorizationヘッダーなしでStreamable HTTPサーバーとしてURLを追加します。初回接続時に、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に対して認証を選択します。
Web上の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は接続時に認証を求めます。
パーソナルアクセストークン
PAT認証は、MCP OAuthをサポートしていないクライアントや自動化のために引き続き利用可能です。以下の例ではCursorの設定形式を使用しています。他のクライアントもHTTPサーバー設定で同じAuthorizationヘッダーを使用します:
{
"mcpServers": {
"raygun": {
"url": "https://api.raygun.com/v3/mcp",
"headers": {
"Authorization": "Bearer YOUR_PAT_TOKEN"
}
}
}
}
💬 最初のプロンプト
設定後、AIアシスタントに次のように試してみてください:
- 「チェックアウトアプリケーションの最新デプロイメント後に最初に出現したエラーを見つけてください。」
- 「最も頻繁に発生する本番エラーを調査し、代表的なスタックトレースを表示してください。」
- 「過去24時間で最も時間を消費したバックエンドメソッドやデータベースクエリはどれですか?」
- 「顧客
user@example.comの最後のセッションを表示し、どこでエクスペリエンスが失敗したか説明してください。」 - 「過去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 Protected Resource Metadataを通じて認可サーバーをアドバタイズし、互換性のあるクライアントはClient ID Metadata DocumentsまたはDynamic Client Registrationを使用して自動的に登録されます。
アクセスは、同意画面で承認されたRaygunユーザー、プラン、スコープに紐付けられます。互換性のあるクライアントは自身のトークンを安全に保存および更新します。
各OAuth接続は1つのRaygunプランへのアクセスを許可します。別のプランで作業する必要がある場合は、別のRaygun MCP設定を追加して個別に認可してください。
セキュリティとアクセス
- OAuthは、サインインしているRaygunユーザーがすでに持っているアクセス権を超えてクライアントにアクセス権を与えることはありません。
- 読み取りおよび書き込みアクセスは、OAuth中に承認されたスコープまたはPATに割り当てられたスコープによって制御されます。
- 一部のツールは、エラーステータス、デプロイメント、招待、コメント、取り込みAPIキーなど、Raygunデータを変更できます。MCPクライアントで承認する前に書き込み操作を確認してください。
- アプリケーションツールは取り込みAPIキーを返すかローテーションできます。返されたキーは資格情報として扱ってください。キーをローテーションすると、以前のキーは直ちに無効になります。
- ツールの結果は、選択したAIクライアントまたはモデルプロバイダーによって処理される会話に含まれる場合があります。診断データと顧客データの共有については、組織のポリシーに従ってください。
パーソナルアクセストークンの取得
OAuthが適さない場合でもPATは利用可能です:
- Raygunパーソナルアクセストークンに移動します
- 新しいトークンを作成をクリックします
- トークンにわかりやすい名前を付けます(例:「MCPサーバーアクセス」)
- ユースケースに適した権限を選択します
- 生成されたトークンをコピーし、
Authorization: Bearer YOUR_PAT_TOKENとして送信します
PATを安全に保管し、バージョン管理にコミットしないでください。
詳細については、Raygun APIドキュメントを参照してください。
📖 概要
Raygun MCPサーバーにより、AIアシスタントはクラッシュレポート、RUM、APMデータを調査し、デプロイメントを追跡し、パフォーマンスを分析し、自然言語での会話を通じてアプリケーションモニタリングを管理できます。
🔗 リソース
❤️ Raygunによって作られました