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 服务器

使用 AI 助手调查 Raygun 中的错误和性能问题

MCP API Status Docs

一个远程模型上下文协议（MCP）服务器，将 AI 助手连接到 Raygun 崩溃报告、真实用户监控和应用性能监控。

📘 设置指南 • 📚 工具参考 • 🚀 快速入门

✨ 主要功能

  • 🐛 错误管理 - 调查、解决和跟踪应用程序错误与崩溃，包含完整的堆栈跟踪和上下文
  • 🚀 部署跟踪 - 监控发布并将错误与部署关联，以识别有问题的变更
  • ⚡ 性能洞察 - 分析页面加载时间、用户指标和随时间变化的性能趋势
  • 🔬 APM 调查 - 查找后端热点、反复出现的性能问题和慢速跟踪
  • 👥 用户监控 - 跟踪客户会话、行为模式，并识别受影响的用户
  • 🤝 团队协作 - 管理邀请并协调团队中的错误解决
  • 📊 指标与分析 - 针对错误和性能的时间序列分析和分布直方图

📋 要求

🚀 入门指南

Raygun MCP 服务器托管于：

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

Raygun 负责托管和更新该服务，因此无需安装任何软件包或本地服务器。

Install in Cursor Install in VS Code

OAuth（推荐）

将 URL 添加为流式 HTTP 服务器，无需 Authorization 标头。首次连接时，您的 MCP 客户端将在浏览器中打开 Raygun，以便您登录、选择计划、查看请求的权限并授权访问。

您无需提供 OAuth 客户端 ID 或客户端密钥。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 桌面应用中，打开 设置 > MCP 服务器，选择 添加服务器，选择 流式 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 在连接时会提示您进行身份验证。

个人访问令牌

对于不支持 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 - 检查会话的环境、错误和页面视图
🔬 应用性能监控
  • 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 连接授予对一个 Raygun 计划的访问权限。当您需要使用不同计划时，请添加另一个 Raygun MCP 配置并单独授权。

安全与访问

  • OAuth 永远不会授予客户端超出已登录 Raygun 用户已有的访问权限。
  • 读写访问权限由 OAuth 期间批准或分配给 PAT 的权限范围控制。
  • 某些工具可以更改 Raygun 数据，包括错误状态、部署、邀请、评论和摄取 API 密钥。在 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