自動安裝#

1
claude mcp add proxyman \
2
  --transport stdio \
3
  -- /Applications/Proxyman.app/Contents/MacOS/mcp-server

這個指令會把 proxyman 加進 Claude Code 的 MCP 設定中。

手動設定#

如果你想確認核心設定，它等同於下面這段：

1
{
2
  "mcpServers": {
3
    "proxyman": {
4
      "command": "/Applications/Proxyman.app/Contents/MacOS/mcp-server"
5
    }
6
  }
7
}

通常不需要手動改，只要 claude mcp add 成功即可。

驗證 Claude Code#

先看 MCP 清單：

1
claude mcp list

或進入 Claude Code：

1
claude

再輸入：

1
/mcp

看到 proxyman 就代表 Claude Code 已經載入 Proxyman MCP。接著可以問：

1
請取得 Proxyman 版本

如果 Claude 可以回傳版本資訊，就表示連線成功。

開啟設定檔#

在 Claude Desktop 裡依序打開：

1
Settings
2
  → Developer
3
  → Edit Config

然後加入：

1
{
2
  "mcpServers": {
3
    "proxyman": {
4
      "command": "/Applications/Proxyman.app/Contents/MacOS/mcp-server"
5
    }
6
  }
7
}

如果你的設定檔裡已經有其他 MCP Server，不要整份覆蓋，只要把 proxyman 這段加進既有的 mcpServers 裡。

重新啟動 Claude Desktop#

Claude Desktop 改完設定後，需要完全關閉再重新開啟：

1
Claude
2
  → Quit Claude

只關視窗通常不夠，建議從選單列完整 Quit。

驗證 Claude Desktop#

重新開啟後，可以直接問：

1
請取得 Proxyman 版本

或：

1
列出最近 10 筆 Request

如果 Claude 能從 Proxyman 讀到資料，代表設定成功。

自動安裝#

1
codex mcp add proxyman \
2
  -- /Applications/Proxyman.app/Contents/MacOS/mcp-server

安裝後可以用：

1
codex mcp list

確認清單裡是否有 proxyman。

手動設定#

如果要手動編輯 ~/.codex/config.toml，加入：

1
[mcp_servers.proxyman]
2
command = "/Applications/Proxyman.app/Contents/MacOS/mcp-server"

這裡有一個很容易踩的坑：

1
# 正確
2
[mcp_servers.proxyman]
3

4
# 錯誤
5
[mcp.servers.proxyman]

Codex 使用的是 [mcp_servers.xxx]，不是 [mcp.servers.xxx]。

驗證 Codex CLI#

啟動 Codex：

1
codex

查看 MCP：

1
/mcp

或直接問：

1
取得 Proxyman 版本

有回應就代表 Codex CLI 已經能呼叫 Proxyman MCP。

驗證 Codex App#

可以問：

1
取得 Proxyman 版本

或：

1
列出最近 10 筆 API Request

我這邊是用這個方式安裝成功；重點是 ~/.codex/config.toml 的 TOML 區塊名稱要寫對，然後 Proxyman 本身的 MCP Server 要先開。

Q: Proxyman MCP 設定好了，但 Claude 或 Codex 讀不到怎麼辦？#

A: 先確認 Proxyman App 正在執行，並且 Settings → MCP 裡的 Enable MCP Server 已開啟。接著確認路徑是否正確：官網版是 /Applications/Proxyman.app/Contents/MacOS/mcp-server，Setapp 版本則在 /Applications/Setapp/Proxyman.app/Contents/MacOS/mcp-server。最後重新啟動 Claude Desktop 或 Codex App，因為桌面 App 通常不會即時重新載入 MCP 設定。

Q: Codex 的 MCP 設定應該寫 [mcp_servers.proxyman] 還是 [mcp.servers.proxyman]？#

A: Codex 的 ~/.codex/config.toml 要寫 [mcp_servers.proxyman]。這是很常見的踩坑，因為很多人會直覺把 MCP Server 寫成 [mcp.servers.xxx]，但 Codex 不會吃這個區塊。改完後重啟 Codex CLI 或 Codex App，再用 /mcp 檢查是否載入。

Q: Claude Desktop 可以直接用 claude mcp add 嗎？#

A: 不建議這樣理解。claude mcp add 是 Claude Code 的安裝方式；Claude Desktop 使用的是 ~/Library/Application Support/Claude/claude_desktop_config.json。如果你只改了 Claude Code 的設定，Claude Desktop 不一定會看到同一組 MCP Server。

Q: Proxyman MCP 會不會把我的流量暴露到外網？#

A: Proxyman 官方文件說明 MCP Server 綁定在 127.0.0.1，並使用 session token 驗證；敏感資料也會在回應中自動遮蔽。也就是說，它主要是本機工具整合。不過，AI 工具能讀取到你授權的 Proxyman 流量摘要，因此仍建議避免在不必要的對話中要求它讀取含有 Token、密碼或個人資料的 Request。