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のエラーとパフォーマンスを調査

MCP API Status Docs

AIアシスタントをRaygunのクラッシュレポート、リアルユーザーモニタリング、アプリケーションパフォーマンスモニタリングに接続するリモートModel Context Protocol(MCP)サーバーです。

📘 セットアップガイド • 📚 ツールリファレンス • 🚀 クイックスタート


✨ 主な機能

  • 🐛 エラー管理 - 完全なスタックトレースとコンテキストを使用して、アプリケーションのエラーやクラッシュを調査、解決、追跡します
  • 🚀 デプロイメント追跡 - リリースを監視し、エラーをデプロイメントと関連付けて問題のある変更を特定します
  • ⚡ パフォーマンスインサイト - ページの読み込み時間、ユーザーメトリクス、時間経過に伴うパフォーマンス傾向を分析します
  • 🔬 APM調査 - バックエンドのボトルネック、繰り返し発生するパフォーマンス問題、遅いトレースを発見します
  • 👥 ユーザーモニタリング - 顧客セッション、行動パターンを追跡し、影響を受けたユーザーを特定します
  • 🤝 チームコラボレーション - 招待を管理し、チーム全体でのエラー解決を調整します
  • 📊 メトリクスと分析 - エラーとパフォーマンスの時系列分析と分布ヒストグラム

📋 要件

🚀 はじめに

Raygun MCPサーバーは以下の場所でホストされています:

https://api.raygun.com/v3/mcp

Raygunがサービスをホストおよび更新するため、インストールするパッケージやローカルサーバーはありません。

Install in Cursor Install in VS Code

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は利用可能です:

  1. Raygunパーソナルアクセストークンに移動します
  2. 新しいトークンを作成をクリックします
  3. トークンにわかりやすい名前を付けます(例:「MCPサーバーアクセス」)
  4. ユースケースに適した権限を選択します
  5. 生成されたトークンをコピーし、Authorization: Bearer YOUR_PAT_TOKENとして送信します

PATを安全に保管し、バージョン管理にコミットしないでください。

詳細については、Raygun APIドキュメントを参照してください。


📖 概要

Raygun MCPサーバーにより、AIアシスタントはクラッシュレポート、RUM、APMデータを調査し、デプロイメントを追跡し、パフォーマンスを分析し、自然言語での会話を通じてアプリケーションモニタリングを管理できます。

🔗 リソース


❤️ Raygunによって作られました

Raygun