关于 Raygun MCP Server
Raygun MCP Server 是托管式远程服务,让 AI 助手通过自然语言检查 Raygun 的崩溃报告、真实用户监控和应用性能数据。它还提供部署、客户会话、团队协作及错误处理工具。
主要功能
- 01搜索错误组并检查堆栈信息
- 02关联错误与部署记录
- 03分析页面和后端性能
- 04查看客户资料与会话
- 05管理错误状态、备注和邀请
- 06查询性能指标与趋势
适用场景
- 01定位最新部署引入的错误
- 02调查高频生产错误及堆栈
- 03查找耗时较长的后端请求
- 04分析客户会话中的体验故障
MCP 相关
该远程 MCP 服务通过 Streamable HTTP 向客户端提供 Raygun 崩溃报告、真实用户监控、应用性能监控、部署和团队管理工具。支持 OAuth,也可使用个人访问令牌认证。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://api.raygun.com/v3/mcpclaude mcp add --transport http raygun https://api.raygun.com/v3/mcp{"mcpServers":{"raygun":{"type":"http","url":"https://api.raygun.com/v3/mcp"}}}在 Cursor 中打开{"servers":{"raygun":{"type":"http","url":"https://api.raygun.com/v3/mcp"}}}在 VS Code 中打开{"mcpServers":{"raygun":{"type":"http","url":"https://api.raygun.com/v3/mcp"}}}{"mcpServers":{"raygun":{"serverUrl":"https://api.raygun.com/v3/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
🔭 Raygun MCP 服务
使用 AI 助手调查 Raygun 中的错误和性能问题
一个远程 Model Context Protocol(MCP)服务,可将 AI 助手连接到 Raygun Crash Reporting、Real User Monitoring 和 Application Performance Monitoring。
✨ 主要功能
- 🐛 错误管理 - 调查、解决和跟踪应用错误与崩溃,并查看完整的堆栈跟踪和上下文信息
- 🚀 部署跟踪 - 监控发布版本并将错误与部署关联起来,以识别有问题的更改
- ⚡ 性能洞察 - 分析页面加载时间、用户指标和随时间变化的性能趋势
- 🔬 APM 调查 - 查找后端热点、反复出现的性能问题和缓慢的跟踪记录
- 👥 用户监控 - 跟踪客户会话和行为模式,并识别受影响的用户
- 🤝 团队协作 - 管理邀请,并协调团队内的错误解决工作
- 📊 指标与分析 - 对错误和性能数据进行时间序列分析和分布直方图分析
📋 要求
- 拥有有效订阅的 Raygun 账户
- 支持 OAuth 的 MCP 客户端,或 Raygun 个人访问令牌
🚀 快速开始
Raygun MCP 服务托管于:
https://api.raygun.com/v3/mcp
Raygun 负责托管和更新此服务,因此无需安装软件包或本地服务。
OAuth(推荐)
将 URL 添加为 Streamable 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 主机上的 Codex CLI、Codex IDE 扩展和 ChatGPT 桌面应用共享。
在 ChatGPT 桌面应用中,打开 设置 > MCP 服务,选择 添加服务,选择 Streamable 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 小时内,哪些后端方法或数据库查询耗时最长?”
- “显示客户
[email protected]最近一次会话,并说明他们的体验在哪个环节出了问题。” - “比较过去 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 连接都授予对一个 Raygun 套餐的访问权限。如需使用其他套餐,请添加另一项 Raygun MCP 配置并单独授权。
安全与访问
- OAuth 绝不会让客户端获得超过已登录 Raygun 用户已有权限的访问权。
- 读写权限由 OAuth 期间批准的作用域或分配给 PAT 的权限控制。
- 某些工具可以更改 Raygun 数据,包括错误状态、部署、邀请、评论和采集 API 密钥。在 MCP 客户端中批准写入操作前,请先检查这些操作。
- 应用工具可以返回或轮换采集 API 密钥。请将返回的密钥视为凭据;轮换密钥会立即使之前的密钥失效。
- 工具结果可能会被纳入由您选择的 AI 客户端或模型提供商处理的对话中。请遵循所在组织关于共享诊断数据和客户数据的政策。
获取个人访问令牌
OAuth 不适用时,仍可使用 PAT:
- 前往 Raygun Personal Access Tokens
- 点击 Create New Token
- 为令牌指定一个描述性名称(例如,“MCP Server Access”)
- 选择适合您使用场景的权限
- 复制生成的令牌,并将其作为
Authorization: Bearer YOUR_PAT_TOKEN发送
请妥善保管 PAT,切勿将其提交到版本控制系统。
更多详情,请参阅 Raygun API 文档。
📖 关于
Raygun MCP 服务支持 AI 助手通过自然语言对话调查 Crash Reporting、RUM 和 APM 数据,跟踪部署,分析性能,并管理应用监控。
🔗 资源
由 Raygun 倾力打造 ❤️
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。