Sentry MCP 是什么？
Sentry MCP 是把真实错误事件、Issue、堆栈和性能线索接入编码任务的服务。Codex 可以直接查询指定组织和项目的故障证据，再把错误版本、影响范围和代码修复放在同一条排查链上。
一句话理解把 Sentry Issue、错误上下文和性能线索带入受控的故障排查流程。
为什么需要它？
减少手工转贴错误详情，让日志、Issue 和代码修复处于同一条证据链。
接入前，AI 只能依赖你粘贴的材料、截图或旧上下文；接入后，它可以在你授权的范围内调用真实工具，并把结果、来源和状态带回当前任务。
核心能力
读取 Sentry Issue 与事件上下文
把真实信息带回当前任务，减少反复复制和手动核对。
查询项目、组织和性能线索
在明确授权范围内调用工具，并保留执行过程和结果。
支持远程 OAuth 与自托管 stdio 场景
回读来源、状态与限制，方便继续处理和人工验收。
适合谁？怎么用？
- 用真实错误事件定位故障
- 已经使用 Sentry，并希望编码助手基于真实错误证据进行归因和修复建议的团队。
- Issue、事件时间、版本和堆栈能对应到真实项目；结论标明证据和未知项。
- 不适合把包含用户输入、请求体或个人信息的全量事件暴露给任务。
- 错误事件可能包含用户数据、请求参数和堆栈路径
- Token 不应保存在公开配置或仓库
怎么接入？
- 1准备
选择官方远程 OAuth 或自托管 stdio 方案。
- 2授权
将权限限制在目标组织和项目。
- 3连接
在客户端登记服务并完成授权。
- 4开始使用
读取一个已知测试 Issue 核对字段。
安装命令
添加 Sentry MCP
codex mcp add sentry --url https://mcp.sentry.dev/mcp添加后完成 Sentry OAuth，并把授权限制在要排查的组织和项目。
检查命令
确认 MCP 已经登记
codex mcp list不想自己操作终端时，把下面整段发给 Codex。它会先核对官方说明和前置条件，遇到凭证或占位符会停下来询问。
发给 Codex
自助接入 Sentry MCP
请帮我在当前电脑上接入并验证 Sentry MCP。
官方来源：https://github.com/getsentry/sentry-mcp
目标接入命令：codex mcp add sentry --url https://mcp.sentry.dev/mcp
请按以下步骤执行：
1. 先阅读官方 README，核对当前推荐接入方式与上述命令。如果官方说明已经变化，先告诉我差异，不要盲目执行旧命令。
2. 检查运行环境、登录状态、Token、项目 ID、允许访问路径等前置条件。不要在输出中显示任何凭证，也不要把凭证写入仓库。
3. 如果命令中有需要替换的占位符，先列出需要我提供的值并停下来，不要自行猜测。
4. 条件满足后执行接入命令，再运行 codex mcp list，确认 Sentry MCP 已登记，并回报实际服务名、传输方式和检查结果。
5. 用下面这个只读任务验证连接：请用 Sentry MCP 查询过去 24 小时 checkout 项目的高频错误，按版本和影响范围归类，不要关闭 Issue。
6. 不要创建、修改、删除、发送内容，也不要连接生产环境；需要写权限或更高权限时先征求我确认。- 复制完整指令，发给一个有终端和当前项目访问权限的 Codex 任务。
- Codex 会先核对官方来源和本机环境；遇到 Token、项目 ID、路径或其他占位符时，应停下来向你确认。
- 接入后运行
codex mcp list，再用 Sentry MCP 的只读首测任务回读结果。
第一次调用示例
登记完成后，新开一个任务，先用下面这句做只读验证，把目标、范围和停止条件一次说清楚。
发给 Codex
第一次只读任务
请用 Sentry MCP 查询过去 24 小时 checkout 项目的高频错误，按版本和影响范围归类，不要关闭 Issue。怎样算成功
Issue、事件时间、版本和堆栈能对应到真实项目；结论标明证据和未知项。
- 限定项目、环境和时间窗口。
- 读取 Issue、事件和堆栈上下文。
- 把错误证据与代码版本对应。
- 修复后重新查询事件状态和回归结果。
权限与安全
凭证与连接方式
远程 OAuth 或本地 stdio；限制组织、项目和时间窗口。
- 错误事件可能包含用户数据、请求参数和堆栈路径
- Token 不应保存在公开配置或仓库
- 仓库 API 元数据未声明 SPDX 许可证，使用前需复核仓库许可文件
