mcp-server-raygun 是一个远程 Model Context Protocol (MCP) 服务器，用于将 AI 助手连接到 Raygun 的崩溃报告、真实用户监控（RUM）和应用性能监控（APM）服务。它的目标是让 AI 编程助手能够调查错误和性能问题，帮助用户解释并解决应用中的故障。
主要能力
该服务器提供以下类别的工具：
- 错误管理：调查、解决和跟踪应用错误与崩溃，包含完整堆栈跟踪和上下文。
- 部署跟踪：监控发布，并将错误与部署关联，以识别有问题的变更。
- 性能洞察：分析页面加载时间、用户指标和性能趋势随时间的变化。
- APM 调查：查找后端热点、重复出现的性能问题和慢速追踪。
- 用户监控：跟踪客户会话、行为模式，并识别受影响的用户。
- 团队协作：管理邀请，并在团队中协调错误解决。
- 指标与分析：对错误和性能进行时间序列分析和分布直方图。
具体工具包括：applications_list、applications_search、application_get_details、application_regenerate_api_key、error_groups_list、error_groups_search、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。详细文档见 Tool Reference。
使用方式
Raygun MCP 服务器托管在 Raygun 的远程地址上，由 Raygun 托管和更新，因此无需安装包或本地服务器。使用前提是拥有一个活跃订阅的 Raygun 账户，以及一个支持 OAuth 的 MCP 客户端，或一个 Raygun Personal Access Token。
OAuth（推荐）
将 URL 添加为 Streamable HTTP 服务器，不设置 Authorization 头。首次连接时，MCP 客户端会在浏览器中打开 Raygun 页面，让你登录、选择计划、查看请求的权限并授权访问。无需提供 OAuth 客户端 ID 或客户端密钥，Raygun 支持自动客户端注册。该配置在同一个 Codex 主机上的 Codex CLI、Codex IDE 扩展和 ChatGPT 桌面应用中共享。在 ChatGPT 桌面应用中，打开 Settings > MCP servers，选择 Add server，选择 Streamable HTTP，输入 Raygun 端点，保存并重启应用，然后选择 Authenticate for Raygun。ChatGPT 网页版通过 Plugins 使用远程 MCP 工具，不读取本地 Codex MCP 配置；需要从 Plugins 目录安装单独发布的 Raygun Plugin。在 Claude Code 中运行 /mcp 并按照浏览器认证流程操作。Cursor 和 VS Code 在连接时会提示进行身份验证。
Personal Access Token
PAT 认证仍支持没有 MCP OAuth 支持的客户端以及自动化场景。以下示例使用 Cursor 的配置格式；其他客户端在其 HTTP 服务器配置中使用相同的 Authorization 头。获取 PAT 的步骤：导航到 Raygun Personal Access Tokens，点击 Create New Token，为令牌提供描述性名称（例如 “MCP Server Access”），选择适合用例的权限，复制生成的令牌并作为 Authorization: Bearer YOUR_PAT_TOKEN 发送。请妥善保管 PAT，切勿将其提交到版本控制。更多详情见 Raygun API 文档。
适用场景
配置完成后，可以向 AI 助手提出类似以下问题：
- “查找在我的 checkout 应用最新部署后首次出现的错误。”
- “调查最频繁出现的生产错误，并展示一个有代表性的堆栈跟踪。”
- “过去 24 小时内哪些后端方法或数据库查询耗时最多？”
- “显示客户 user@example.com 的最后一个会话，并解释他们的体验在哪里失败。”
- “比较过去七天的 p95 页面性能，并找出最大的性能退化。”
认证与安全
Raygun 为 HTTP 客户端实现 MCP 授权流程。服务器通过 OAuth Protected Resource Metadata 公布其授权服务器，兼容的客户端使用 Client ID Metadata Documents 或 Dynamic Client Registration 自动注册。访问权限与在同意屏幕上批准的 Raygun 用户、计划和范围绑定。兼容客户端会安全地存储和刷新自己的令牌。每个 OAuth 连接授权访问一个 Raygun 计划；如需处理其他计划，请添加另一个 Raygun MCP 配置并单独授权。
安全与访问方面：OAuth 不会给客户端超过已登录 Raygun 用户已有的访问权限。读写访问由 OAuth 期间批准的范围或分配给 PAT 的范围控制。部分工具可以更改 Raygun 数据，包括错误状态、部署、邀请、评论和摄取 API 密钥；在 MCP 客户端中批准写操作前请先审阅。应用工具可以返回或轮换摄取 API 密钥；将返回的密钥视为凭据，轮换密钥会立即使前一个密钥失效。工具结果可能包含在所选 AI 客户端或模型提供商处理的对话中；请遵循组织关于共享诊断和客户数据的政策。
限制
使用该服务器需要拥有一个活跃订阅的 Raygun 账户，以及支持 OAuth 的 MCP 客户端或 Raygun Personal Access Token。该服务器为远程托管，由 Raygun 托管和更新，因此没有本地包或服务器可供安装。资料中未提供具体价格、计费方式或免费额度信息，暂未提供。
