Sentry MCP

产品介绍

Sentry MCP Server 是 Sentry 官方构建并维护的 Model Context Protocol 服务器，作为 AI 助手与 Sentry 错误监控平台之间的中间层。它让 Claude、Cursor 等 AI 编码代理直接拉取生产环境的错误、Issue、堆栈、性能数据，甚至触发 Sentry 的 AI（Seer）进行根因分析，无需在 Sentry 控制台和编辑器之间来回切换。提供远程托管（OAuth 零安装）和本地 stdio 两种接入方式，是可观测性领域首个官方 MCP 服务器。

核心功能

• 导航与发现：list_organizations、find_projects、find_teams、identify_user 查询组织和项目
• Issue 调查：get_issue_details 获取完整 Issue 信息含堆栈，list_issues、search_issues 跨项目搜索
• Seer 根因分析：get_issue_analysis 调用 Sentry AI 解释错误原因并给出修复建议（Sentry 专有特性，社区服务器无法复制）
• 事件分析：get_event、list_error_events、search_error_events 按时间、环境、release、trace ID 过滤
• 会话回放与性能：list_replays、get_replay_details、get_profile_details 查看 Replay 和性能 Profile
• 项目管理：create_project 创建项目并获取 DSN，get_client_keys 管理客户端密钥

安装配置

远程服务器（推荐，零安装，OAuth 2.0 认证，无 Token 落盘）：

{
  "mcpServers": {
    "sentry": {
      "url": "https://mcp.sentry.dev/sse"
    }
  }
}

本地 stdio 运行（适用于自托管 Sentry 或需要 Token 认证的场景）：

{
  "mcpServers": {
    "sentry": {
      "command": "npx",
      "args": ["-y", "@sentry/mcp-server@latest"],
      "env": {
        "SENTRY_AUTH": "sntrys_your_auth_token"
      }
    }
  }
}

自托管 Sentry 需通过 --host 参数指定实例：

npx @sentry/mcp-server@latest --access-token=YOUR_SENTRY_TOKEN --host=sentry.example.com

Token 在 Sentry → Settings → Account → API → Auth Tokens 创建，至少需要 project:read 和 event:read 权限；如需修改 Issue 状态再加 issue:write。AI 搜索类工具（Seer）需额外配置 EMBEDDED_AGENT_PROVIDER（openai 或 anthropic）及对应 API Key。

典型使用场景

• 生产环境报错后，让 AI 直接拉取堆栈并定位引入代码
• 跨项目查询高频错误，按环境、release、级别过滤
• 触发 Seer 根因分析，获取错误原因解释和修复建议
• 配合 GitHub MCP 形成"错误发现 → 定位提交 → 起草修复"的完整调试闭环
• 查询数据库慢查询、性能瓶颈和 Trace 数据

平台支持

支持 Claude Desktop、Claude Code、Cursor 1.0+（原生 OAuth）、Windsurf、VS Code 等 MCP 客户端。TypeScript 实现，Node.js 18+。stdio 传输自 v0.31.0 起支持 Device Code Flow 浏览器登录。兼容 Sentry SaaS 和自托管实例。