使用情境 · Codex

Sentry 搭配 Codex:加入 MCP 伺服器,依排程分流錯誤

Codex 直接透過 streamable HTTP 連接 Sentry 託管的 MCP 伺服器:加上網址、用 OAuth 登入一次,Codex 就能在你的程式碼旁讀取問題、事件和堆疊追蹤。本頁說明設定、AGENTS.md 的分流規則,以及如何不開工作階段、用 codex exec 執行分流。

Sentry 錯誤分流:Codex 能做什麼

  • 讀取自上次執行以來新出現或再次出現的未解決 Sentry 問題。
  • 先查看板,反覆出現的錯誤只會多一則評論,而不是十個新 issue。
  • 把每個新錯誤開成 issue,寫清楚影響、首次和最近出現時間、從哪個版本開始、最上面幾層堆疊,以及可能原因(標明是推測)。
  • 把既小又明顯的問題修掉,附上測試開 pull request,等待審查。

Sentry 錯誤分流:用得上的 Codex 功能

功能用途怎麼開始
Sentry MCP 伺服器你 Sentry 組織裡的問題、事件、堆疊追蹤和版本在 config.toml 裡寫 url = "https://mcp.sentry.dev/mcp"
codex mcp login登入 OAuth 伺服器;在遠端機器上加 --no-browsercodex mcp login sentry
required = trueSentry 沒連上時,讓 codex exec 報錯停止,不會在看不到資料的情況下分流寫在 [mcp_servers.sentry] 底下
codex exec跑一輪分流後就結束;-o 會儲存摘要codex exec "Triage new Sentry errors"

Sentry 錯誤分流:如何設定 Codex

  1. 連接工具

    把 Sentry 加成 streamable HTTP 伺服器,再登入一次。Sentry 自己的文件也列出 mcp-remote 橋接,同樣可行,但 Codex 不需要它。

    # ~/.codex/config.toml
    [mcp_servers.sentry]
    url = "https://mcp.sentry.dev/mcp"
    required = true
    
    # 接著用 OAuth 登入
    codex mcp login sentry
  2. 把規則寫進 AGENTS.md

    Codex 在開始任何工作前都會讀取 AGENTS.md:先讀 ~/.codex/AGENTS.md,再從儲存庫根目錄一路讀到它工作的資料夾。把這項工作的規則寫在那裡;規則很長的話,放進 .agents/skills/ 下的 skill。參見 AGENTS.md 指南。

    ## Sentry 分流規則
    1. 列出正式環境中,自上次執行以來首次出現或再次出現的
       未解決問題。
    2. 開 issue 前,先在看板上搜尋 Sentry 的問題 ID。
    3. 新問題開成 issue,寫清楚受影響的使用者數和事件數、
       首次和最近出現時間、版本、最上面幾層堆疊,
       以及可能原因(標明是推測)。
    4. 擋住註冊、付款或資料的標 Urgent;影響超過 1% 工作階段的
       標 High;其餘標 Medium。
    5. 修正既小又明顯:附上測試開 pull request。不要合併。
    6. 絕不在 Sentry 裡解決、忽略或刪除任何東西。
  3. 不開互動介面也能執行

    codex exec 執行一個任務後就結束。進度輸出到 stderr,最終訊息輸出到 stdout;-o 會另外寫進檔案,--json 則以串流輸出事件。除非傳入 --sandbox workspace-write,否則沙箱是唯讀的。

    # 從 cron 跑一輪分流;摘要寫進檔案
    codex exec --sandbox workspace-write \
      -o triage.md "依 AGENTS.md 裡的規則分流新的 Sentry 錯誤"
  4. 排入排程

    在 ChatGPT 桌面 App 或網頁版建立排程任務(CLI 無法管理排程任務),或從 cron 執行 codex exec。參見如何讓 Codex 主動工作。

來源:Codex 文件

限制與安全

  • 它只需要讀取 Sentry 問題,不需要修改。解決和忽略交給人。
  • 它寫的原因是根據堆疊追蹤做的推測。修正上線前要由人確認。
  • 錯誤可能帶有使用者資料。它開的 issue 要放在私人看板或儲存庫。
  • Codex 預設會把指令放進沙箱:寫入只限於工作區,網路關閉。danger-full-access 只留給隔離的 runner 或容器使用。

Sentry 錯誤分流,用 Claude Code 還是 Codex?

規則可以共用。在 AGENTS.md 寫一次,再把 @AGENTS.md 放進 CLAUDE.md,兩個 agent 就會讀同一份檔案。

另一個 agent 的逐步做法:Claude Code Sentry 錯誤分流。

Claude CodeCodex
規則檔CLAUDE.mdAGENTS.md
連接工具claude mcp addcodex mcp add 或 config.toml
你不在也能執行claude -pcodex exec
排程/schedule、桌面排程任務、/loopChatGPT App 的排程任務、cron
內建功能(Sentry 錯誤分流)透過 HTTP 的 Sentry MCP、/mcp 登入原生 HTTP MCP、codex mcp login
使用 Crewmark

Sentry 錯誤分流:讓它成為某個人的固定工作

指令只在有人記得時才會執行。Crewmark 把你自己的 Codex 變成 AI 員工,有職位、量化目標、工作時間和心跳,工作就會依排程完成,並出現在看板上。

  1. 從職位開始

    AI 軟體工程師:在職位說明裡寫上這些規則。

  2. 把工作放上它的看板

    把這項工作加成週期性 issue。員工依心跳醒來,做完後以評論回報。

  3. 相關內容

    Sentry 錯誤分流頁面有完整的職位說明和優先順序規則。

常見問題

如何把 Sentry MCP 伺服器加到 Codex?

在 ~/.codex/config.toml 加入 [mcp_servers.sentry] 表,寫上 url = "https://mcp.sentry.dev/mcp",再執行 codex mcp login sentry 登入。

Codex 連 Sentry 需要 mcp-remote 嗎?

不需要。Codex 支援 streamable HTTP 伺服器,有網址就夠了。Sentry 文件裡的 mcp-remote 橋接也能用。

Codex 能修正 Sentry 錯誤嗎?

它能找出錯誤背後的程式碼,並開一個附修正和測試的 pull request。合併,以及在 Sentry 裡解決問題,都交給人。

已於 2026 年 11 月 13 日對照 Claude Code 文件和 OpenAI 的 Codex 文件查核。

Sentry 錯誤分流,交給 Codex 上的 AI 員工。

Crewmark 把 Claude Code 和 Codex 工作階段變成有職位、目標、工作時間和心跳的 AI 員工。