Raygun

官方

與您的 Raygun 帳戶中的崩潰報告和即時使用監控數據進行互動

GitHub
22
試用此 MCP贊助

你可以用 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 Server

使用 AI 助手調查 Raygun 中的錯誤與效能

MCP API Status Docs

一個遠端 Model Context Protocol (MCP) 伺服器，可將 AI 助手連接到 Raygun 的 Crash Reporting、Real User Monitoring 與 Application Performance Monitoring。

📘 設定指南 • 📚 工具參考 • 🚀 快速入門

✨ 主要功能

  • 🐛 錯誤管理 - 調查、解決並追蹤應用程式錯誤與當機，包含完整的堆疊追蹤與上下文
  • 🚀 部署追蹤 - 監控版本並將錯誤與部署關聯，以識別有問題的變更
  • ⚡ 效能洞察 - 分析頁面載入時間、使用者指標與隨時間變化的效能趨勢
  • 🔬 APM 調查 - 找出後端熱點、重複出現的效能問題與緩慢的追蹤
  • 👥 使用者監控 - 追蹤客戶工作階段、行為模式，並識別受影響的使用者
  • 🤝 團隊協作 - 管理邀請並協調團隊間的錯誤解決
  • 📊 指標與分析 - 錯誤與效能的時間序列分析與分佈直方圖

📋 需求

🚀 開始使用

Raygun MCP 伺服器託管於：

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

Raygun 負責託管與更新服務，因此無需安裝任何套件或本機伺服器。

Install in Cursor Install in VS Code

OAuth（建議）

將 URL 新增為 Streamable HTTP 伺服器，且不帶 Authorization 標頭。首次連線時，您的 MCP 用戶端會在瀏覽器中開啟 Raygun，讓您登入、選擇方案、檢閱要求的權限並授權存取。

您無需提供 OAuth client ID 或 client secret。Raygun 支援自動用戶端註冊。

Codex 與 ChatGPT 桌面應用程式 
codex mcp add raygun --url https://api.raygun.com/v3/mcp
codex mcp login raygun

此設定由 Codex CLI、Codex IDE 擴充功能與相同 Codex 主機上的 ChatGPT 桌面應用程式共用。

在 ChatGPT 桌面應用程式中，開啟 Settings > MCP servers，選擇 Add server，選取 Streamable HTTP，然後輸入 Raygun 端點。儲存並重新啟動應用程式，接著為 Raygun 選擇 Authenticate。

網頁版 ChatGPT 透過 Plugins 使用遠端 MCP 工具，不會讀取您本機的 Codex MCP 設定。需從 Plugins 目錄另行安裝已發佈的 Raygun Plugin。

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 小時內，哪些後端方法或資料庫查詢耗費了最多時間？」
  • 「顯示客戶 user@example.com 的最後一個工作階段，並說明他們的體驗在哪裡出了問題。」
  • 「比較過去七天的 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 - 檢查工作階段的環境、錯誤與頁面瀏覽
🔬 Application Performance Monitoring
  • apm_issues_search - 找出重複出現的後端效能問題與反模式
  • apm_issue_investigate - 檢查問題的指標與受影響的追蹤
  • apm_traces_search - 找出緩慢或失敗的後端請求
  • apm_trace_investigate - 檢查追蹤中的 profiler 執行緒與重要呼叫
  • 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 使用者、方案及同意畫面上核准的範圍相關。相容的用戶端會安全地儲存並自行重新整理其 token。

每個 OAuth 連線授予一個 Raygun 方案的存取權。當您需要處理不同方案時，請新增另一個 Raygun MCP 設定並分別授權。

安全性與存取

  • OAuth 絕不會授予用戶端超過已登入 Raygun 使用者所擁有的存取權限。
  • 讀取與寫入存取權由 OAuth 期間核准或指派給 PAT 的範圍控制。
  • 某些工具可以變更 Raygun 資料，包括錯誤狀態、部署、邀請、留言與 ingestion API 金鑰。在您的 MCP 用戶端中核准寫入動作前，請先檢閱。
  • 應用程式工具可以傳回或輪換 ingestion API 金鑰。請將傳回的金鑰視為憑證；輪換金鑰會立即讓先前的金鑰失效。
  • 工具結果可能包含在您所選 AI 用戶端或模型提供者處理的對話中。請遵循您組織關於分享診斷與客戶資料的政策。

取得 Personal Access Token

當 OAuth 不適用時，仍可使用 PAT：

  1. 前往 Raygun Personal Access Tokens
  2. 點擊 Create New Token
  3. 為您的 token 提供描述性名稱（例如「MCP Server Access」）
  4. 為您的使用情境選取適當的權限
  5. 複製產生的 token，並以 Authorization: Bearer YOUR_PAT_TOKEN 傳送

請妥善保管 PAT，切勿將其提交至版本控制。

如需更多詳細資料，請參閱 Raygun API 文件。

📖 關於

Raygun MCP 伺服器讓 AI 助手能夠調查 Crash Reporting、RUM 與 APM 資料；追蹤部署；分析效能；並透過自然語言對話管理應用程式監控。

🔗 資源

由 Raygun 以 ❤️ 打造

Raygun