最近在用 codex 發現 linear mcp 一直無法登入，於是花了一點時間排查這個問題。

1. 升級 codex

排查一陣子發現跟 codex 的版本貌似有關係，我的版本是 0.45.0，目前最新的版本是 0.53.0，因此要先升到最新版。

codex 如果是用 homebrew 安裝的話，是用這個指令：brew install --cask codex，因此一開始以為用：brew upgrade --cask codex，就可以直接升級 codex，發現沒用去查了官方文件才發現：

If you’re running Codex v0.46.0 or older, brew upgrade codex will not move you to the latest version because we migrated from a Homebrew formula to a cask.

因此要先移除 codex 的 homebrew formula，再重新安裝 codex

$ brew uninstall --formula codex
$ brew install --cask codex

2. 手動連結 codex binary

重新安裝 codex 後，如果直接執行 codex 會發現：

$ codex
zsh: command not found: codex

需要手動連結 binary

$ sudo ln -s /opt/homebrew/Caskroom/codex/0.53.0/codex-aarch64-apple-darwin /opt/homebrew/bin/codex

連結後，重新執行 codex 就會成功了

$ codex --version
codex-cli 0.53.0

3. 移除 linear mcp，再重新加入

先移除 linear mcp

$ codex mcp remove linear

新增 linear mcp

$ codex mcp add --url https://mcp.linear.app/mcp linear

透過 oauth 驗證 linear 帳號

$ codex mcp login linear -c experimental_use_rmcp_client=true

這樣就能成功連結 linear 的 mcp 了

參考資料

openai/codex: Lightweight coding agent that runs in your terminal
FAQ entry on brew upgrade codex
Linear MCP not working post autherization #3759