注册
Claude

Claude Code 配 Sentry MCP 排查线上报错：添加命令、浏览器授权、贴 issue 链接修 bug 和插件子智能体

线上报错只能手动复制堆栈给 Claude Code？Sentry 官方提供 MCP 服务，可以让它直接读 issue、堆栈和 trace。本文按 Claude Code 官方 MCP 文档和 Sentry MCP 官方说明，讲添加命令、/mcp 授权、典型排查流程、插件方式和自托管注意事项。

NNathaniel bigo··原创首发·AI 辅助撰写
11 分钟读完
资料核对于 2026-11-05 · 依据官方文档与公开资料整理 Pro 账号
本文根据 Claude Code 官方文档《Connect Claude Code to tools via MCP》《MCP quickstart》与 Sentry 官方 MCP 说明整理，资料核对于 2026-11-05。配图为本站整理的示意图，不是界面截图。本站（bigolab.com）不是 Anthropic 或 Sentry 官方网站。

适用于谁

  • 项目接了 Sentry，线上出了报错，想让 Claude Code 直接读 issue 并定位原因的人；
  • 总是手动把堆栈截图或复制进对话，嫌麻烦的人；
  • 想看一个「需要网页登录授权」的 MCP 服务完整怎么接的人（Claude Code 官方也拿 Sentry 当示范）。

MCP 的基础概念和通用配置见 /guides/claude-code-mcp-setup，本文只讲 Sentry 这一个。

结论先说

  1. Sentry 官方提供远程 MCP 服务，地址是 https://mcp.sentry.dev/mcp。Sentry 官方页面说，它把 Sentry 的 API 接给你的助手，让你用自然语言问数据，用于调试、修线上错误、理解应用行为；页面同时标注这是 Beta。
  2. 添加只需要一条命令，然后在 Claude Code 里用 /mcp 在浏览器里授权。这正是 Claude Code 官方 MCP 文档里用的示例。
  3. 最顺手的用法是贴 issue 链接：Sentry 官方演示的流程是复制浏览器里的 Sentry issue 地址，助手读取 issue 详情、分析堆栈，再改代码、跑测试验证。
  4. 改代码前先别急着让它动手。 线上报错可能只是症状，让它先给出原因判断，你确认后再改。
  5. 报错数据里可能有用户信息。 接入前确认你们团队允许把这类数据交给 AI 工具。

用 Sentry MCP 排查线上报错的流程

图：本站根据 Claude Code 官方文档：MCP 与 Sentry 官方说明整理的示意图

一、添加服务器并授权

在项目目录的终端里运行（官方命令）：

bash
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

Claude Code 官方 quickstart 说明：添加后 claude mcp list 会显示该服务器为 ! Needs authentication，这是正常的，下一步完成登录。启动会话后输入：

text
/mcp

选中 sentry，按回车，选择 Authenticate，浏览器会打开 Sentry 的登录页，在那里批准连接。回到 Claude Code，状态会变成已连接。官方给的几个小提示：

  • 认证令牌会被安全保存并自动刷新；
  • 想撤销，在 /mcp 菜单里选 “Clear authentication”；
  • 浏览器没有自动打开时，复制它给的链接手动打开；
  • 如果浏览器登录后回调报连接错误，把地址栏里完整的回调 URL 粘贴到 Claude Code 弹出的 URL 输入框里；
  • 不想进会话，也可以在 shell 里运行 claude mcp login sentry；在 SSH 等没有浏览器的环境里，它会打印授权链接让你在本机打开，再把重定向后的完整地址粘回去，需要交互式终端，所以用 ssh -t 连接。

如果之前已经加过同名的 sentry，重复运行 claude mcp add 会报 MCP server sentry already exists in local config，跳过这一步直接授权即可。

范围（scope）： 官方说默认是 local，只在当前项目、只你自己可用，存在 ~/.claude.json。想所有项目都用，加 --scope user；想写进仓库让团队共用，用 --scope project，会生成 .mcp.json，Claude Code 在使用前会弹窗让每个人批准。Sentry 这种每人各自登录的服务，一般用默认或 user 即可，不要把任何令牌写进共享文件。

装好以后，用官方 quickstart 的第一个问题验证：

text
What Sentry projects do I have access to?

看输出里有没有标着 sentry 的工具调用。

二、典型排查流程

下面的提示词和步骤是本站设计的，不是官方示例。

第 1 步：贴 issue 链接，只要分析，不要改代码。

text
这是线上的 Sentry issue：<粘贴 issue 链接>
请先读取这个 issue 的详情、堆栈和最近的事件，告诉我：
1）错误是什么、影响多少用户、什么时候开始的；
2）堆栈里哪几个文件和行号是我们自己的代码；
3）你认为的根本原因，以及哪些是推测。
先不要改代码。

第 2 步：让它去仓库里对号入座。

text
根据上面的堆栈，在代码库里找到对应位置，解释为什么这种输入会触发这个错误，给我一个最小改动的修复方案，列出会改哪些文件。我确认后再改。

复杂的先分析再动手，可以配合 /guides/claude-code-plan-mode。

第 3 步：确认后修复，并补测试。

text
按方案修复，并为这个错误写一个能复现的测试，先确认测试在修复前会失败、修复后通过。最后给我 git diff 摘要。

第 4 步：回头确认。 修复上线后，再让它查这个 issue 最近有没有新事件，看是否真正解决。

其他可问的问题（都需要你的账号有权限）：

text
最近 24 小时我们 checkout 项目里新增了哪些未解决的错误？按影响用户数排序。
这个接口的 trace 里最慢的是哪一段？

三、用插件方式，让它自动委派给子智能体

Sentry 的 GitHub 仓库里还给了一种 Claude Code 插件的装法：

bash
claude plugin marketplace add getsentry/sentry-mcp
claude plugin install sentry-mcp@sentry-mcp

仓库说明，这会提供一个 sentry-mcp 子智能体，当你问到 Sentry 的错误、issue、trace 或性能时，Claude 会自动委派给它。子智能体的概念见 /guides/claude-code-subagents，插件的安装管理见 /guides/claude-code-plugins-marketplace。仓库还说有一个 sentry-mcp-experimental 版本带前瞻性的工具变体；稳定性自行判断。

四、几个要注意的地方

Sentry MCP 连不上时先查什么

图：本站根据官方文档整理的示意图

  • 限流。 Sentry 官方仓库说，工具调用受 Sentry API 的速率限制，服务端会自动重试；限制持续时会返回 “Rate Limited” 提示并说明何时重试。最常见的原因是并行发了太多 Sentry 调用，看到这个提示就让它一个一个查。
  • 自托管 Sentry。 官方走的是另一条路：用 npm 包 @sentry/mcp-server 的 stdio 方式，用 SENTRY_HOST 指向你的域名，认证用 npx @sentry/mcp-server@latest auth login 或 SENTRY_AUTH_TOKEN。仓库还说，Seer 不属于自托管版 Sentry，所以主机不是 sentry.io 时默认不带 seer 技能；并且 AI 驱动的搜索类工具需要你自己配置 LLM 提供方。令牌权限请按官方列出的范围最小化创建。
  • 传 token 的远程方式。 官方说客户端支持自定义请求头时，可以用 Authorization: Sentry-Bearer ${SENTRY_ACCESS_TOKEN}。注意是 Sentry-Bearer，不是 Bearer，后者保留给 MCP 的 OAuth 令牌。令牌用环境变量，不要写死进文件。
  • 数据与注入风险。 Claude Code 官方提醒：连接前确认你信任该服务；能拉取外部内容的服务器可能带来提示注入。Sentry 里的错误信息有一部分来自用户输入，让它在改代码前把可疑内容摘出来给你看。选型思路见 /guides/mcp-servers-how-to-choose-audit。
  • 连不上时。 Claude Code 官方的排查建议：用 curl -I https://mcp.sentry.dev/mcp 看响应。404 或 405 说明服务器在线（很多 MCP 端点只接受 POST）；401 或 403 说明服务器在线但需要认证；没有任何响应则检查地址和网络。Windows PowerShell 里要写 curl.exe，否则会调用 Invoke-WebRequest 别名。

常见问题

Q：必须用 Sentry 吗？日志类还有别的吗？

本文只写了 Sentry，因为官方文档有现成示例。其他日志、监控平台是否提供 MCP，请去对应官方文档查。Claude Code 官方 MCP 页面也提到，可以用 MCP 分析监控数据。

Q：和 GitHub issue 的流程怎么配合？

可以先用 Sentry 定位，再用 GitHub 那边提 issue 或 PR，见 /guides/claude-code-github-mcp-gh-issues。

Q：授权后别人能用我的账号权限吗？

令牌存在你本机的 Claude Code 里，范围按 Sentry 里你账号的权限。不要把 ~/.claude.json 发给别人。

订阅和额度

读堆栈、读 trace 会产生较多上下文，排查一个线上问题的对话往往较长。订阅选择见 /chongzhi/claude-code，价格和额度以官方页面当前显示为准。

相关教程

参考资料

  • Claude Code 文档：Connect Claude Code to tools via MCP — https://code.claude.com/docs/en/mcp
  • Claude Code 文档：MCP quickstart — https://code.claude.com/docs/en/mcp-quickstart
  • Sentry 文档：Sentry MCP — https://docs.sentry.io/product/sentry-mcp/
  • Sentry MCP 仓库 — https://github.com/getsentry/toolkit

Nathaniel 的更多内容

  1. 01

    Claude Personal Finance 是什么：连银行账户问花销、怎么开、只读权限、谁能用、怎么解除

    Claude 的 Personal Finance（beta）通过 Plaid 只读连接你的银行、信用卡、贷款和投资账户，在一页里看余额和花销并用自然语言提问。本文按官方帮助页讲谁能用（仅美国、Pro/Max/Ultra）、连接与解除步骤、Claude 能看什么，以及它做不到的事。

    Claude0
  2. 02

    Claude Code 离开一小时回来对话被「压缩」了：Idle compaction 是什么、条件、怎么关

    Claude Code 的 idle compaction 会在你离开约一小时后，把 200K token 以上的长对话先压缩成摘要，下一条消息就不用重新处理整段历史。本文按官方文档讲触发条件、看到什么提示、用 /config 或 idleCompaction 关闭、调阈值，以及恢复旧对话的用量警告。

    Claude0
  3. 03

    ChatGPT Computer History 是什么：Mac 桌面端的活动记忆怎么开、怎么暂停和清除、谁能用

    Computer History 是 ChatGPT macOS 桌面应用里默认关闭的可选功能，把你在应用和网站里的活动整理成记忆和时间线，供 ChatGPT 与 Codex 引用。本文按官方文档讲怎么开、记录什么不记录什么、怎么暂停与清除、数据存哪、谁能用，以及提示注入风险。

    ChatGPTCodex0
  4. 04

    Codex 输入框出现灰色建议：Composer predictions 是什么、Tab 接受、怎么关、谁能用

    Codex 桌面 App 的 Composer predictions（beta）会在 Codex 回完后，根据当前对话在输入框里给出下一条消息的建议，按 Tab 接受、不会自动发送。本文按官方帮助页讲谁能用、哪些线程支持、怎么关、算不算额度，以及没出现时怎么查。

    ChatGPTCodex0
  5. 05

    ChatGPT 隐私中心（Privacy Center）在哪里：隐私设置入口、三大分类和哪些套餐有

    ChatGPT 的 Privacy Center 把记忆、广告、位置、临时对话、锁定对话、两步验证、模型改进、数据导出和删号等入口集中到一页。本文按官方帮助页讲怎么打开、三大分类各有什么、哪些套餐有，以及它不会替你改任何设置。

    ChatGPT0
  6. 06

    Claude Code 处理大仓库：怎么让它只看需要的目录（子目录 CLAUDE.md、claudeMdExcludes、deny 规则）

    仓库太大，Claude Code 总在读无关文件、读进别的包的规则？本文按官方大仓库指南讲：从哪个目录启动、子目录 CLAUDE.md、claudeMdExcludes、Read 的 deny 规则、worktree.sparsePaths、additionalDirectories，以及一份合并后的配置示例。

    Claude0

同产品的其他教程

  1. 01

    Claude Code 在 CI 里跑：从本机 claude -p 到 GitHub Actions 的完整例子（自动审 PR、控成本）

    一条线走完 Claude Code 的 CI 用法：先在本机用 claude --bare -p 配 --json-schema 跑通，再写进 GitHub Actions 用 claude-code-action@v1 自动审 PR，最后加上 --max-turns、超时、并发限制来控成本，并附上常见故障的排查顺序。

    Claude0
  2. 02

    Claude Code 自定义 subagent 实例：测试员、调试员、只读调研员、只读数据库员怎么写

    四个可直接改的 subagent 实例：跑测试的 test-runner、找根因的 debugger、只读调研员、用 PreToolUse hook 限成只读 SQL 的 db-reader；讲 tools、disallowedTools、model、maxTurns 怎么配，怎么点名调用。

    Claude0
  3. 03

    Claude Code 的 CLAUDE.md 模板：前端、后端、数据分析各一份，附拆分与自检方法

    直接拿去改的三份 CLAUDE.md 模板（前端、后端、数据分析），每份都控制在官方建议的 200 行以内；再讲怎么用 .claude/rules 的 paths 拆出专属规则、用 @ 导入长文档，以及用 /context all 和 /doctor prompt-audit 检查是否生效。

    Claude0
  4. 04

    Claude Code 自己写一个插件并发布到 marketplace：plugin.json、marketplace.json、validate 到团队安装的完整流程

    想把自己写的 Skill、Hook 打包给团队用？按 Claude Code 官方 Plugins 文档，从目录结构、plugin.json、claude plugin validate，到写 marketplace.json、推到 Git、让同事一条命令安装，再到版本更新，走完一遍完整流程。

    Claude0
  5. 05

    Claude Code 写一个会自动触发的 Skill：从需求到触发，用 description、when_to_use 和 paths 控制它什么时候出场

    写好的 Skill 总是不触发，或者什么都触发？本文按 Claude Code 官方「Extend Claude with skills」走一遍完整实例：把「改数据库迁移前先检查」写成一个会自动出场的 Skill，包含 description、when_to_use、paths、附带脚本、触发测试和评估。

    Claude0
  6. 06

    Claude Code 配 Context7 MCP 查最新文档：两种安装方式、use context7 怎么写、指定库和版本

    Claude Code 写出来的代码用了旧版 API？Context7 是一个把库的最新文档喂给编程助手的 MCP 服务。本文按 Context7 官方仓库和文档，讲两种安装方式、在 Claude Code 里的添加命令、use context7 与 library ID 的写法，以及使用时的注意事项。

    Claude0

0 条评论

登录 后参与评论

还没有评论，来抢沙发～