註冊
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 條評論

登入 後參與評論

還沒有評論，來搶沙發～