你的 MCP 伺服器,
一次進入所有代理 CLI
Claude Code 把 MCP 伺服器存在 ~/.claude.json,Codex 存在 ~/.codex/config.toml,其他 CLI 也各有各的檔案。給其中三個新增 Notion,就要把同一個伺服器寫三遍,再登入三次。AgentsRoom 只保留一份列表。
在「設定 > 代理行為 > MCP 伺服器」中宣告一個伺服器,也可以宣告在某個專案或單個代理上:AgentsRoom 啟動的每個代理都會收到它,並以其自身 CLI 的格式寫入。對於透過 OAuth 登入的遠端伺服器,例如 Notion、Linear 或 Atlassian,會顯示一個「連線」按鈕:在瀏覽器中登入一次,這台電腦上的所有 CLI 都能訪問它。
- notionmcp.notion.com/mcp已在這台電腦上連線
- sentrymcp.sentry.dev/mcp遠端
- githubnpx github-mcp本地
- Claude Code
- Codex
- GitHub Copilot CLI
- Cursor
- 以及另外 12 個代理 CLI
一次宣告,啟動時交付給每個 CLI。OAuth 登入每台電腦只需一次,對所有 CLI 都有效。
MCP 伺服器是程式設計代理連線你其他工具的方式:問題跟蹤系統、文件、錯誤監控、通往資料庫的橋接。每個代理 CLI 都支援它們,但每個 CLI 的存放方式都不一樣,新增伺服器的命令各不相同,對於透過 OAuth 登入的伺服器,登入方式也各不相同。
只用一個 CLI 時沒問題。用三個時,新增一個伺服器就意味著要按三種格式改三次,而一個 OAuth 伺服器意味著要登入三次,前提是那個 CLI 支援 OAuth。通常你是在某天另一個 CLI 上的代理說它無法訪問 Linear 時,才發現這些列表早已不一致。
AgentsRoom 把這份列表往上提了一層。你只需宣告一次伺服器,可以用每個 CLI 都有文件說明的 mcpServers JSON,也可以從官方 MCP 登錄檔的目錄中選擇。啟動時,桌面版會把它寫進代理所執行的那個 CLI 的配置裡,和 AgentsRoom 自己的伺服器放在一起。它適用於 AgentsRoom 執行的、帶有 MCP 客戶端的所有 CLI:Claude、Codex、GitHub Copilot CLI、Cursor 以及另外 12 個代理 CLI。Aider 是例外:它沒有 MCP 客戶端。
一份伺服器列表帶給你什麼
用你已經熟悉的格式宣告一次,每個代理啟動時由 AgentsRoom 交付。
宣告一次,交付給每個 CLI
一個 mcpServers 塊,就是每個 CLI 文件中寫的格式。啟動時,AgentsRoom 會把它轉換給 Claude Code、Codex、OpenCode、Grok Build、Cursor 和其他 CLI,你再也不用把同一個伺服器寫兩遍。
三個層級,範圍最小的優先
「設定」作用於所有專案的所有代理,專案作用於它的程式碼儲存庫,單個代理只作用於它自己。伺服器按名稱合併,代理可以關閉繼承來的伺服器,而無需重新宣告。
內建官方 MCP 登錄檔
「從目錄新增」會搜尋維護者發布到官方 MCP 登錄檔的伺服器,並帶有「已驗證的發布者」標記,然後替你寫好宣告:有遠端地址時用遠端地址,否則用本地軟體包。
一個「連線」按鈕完成 OAuth 登入
當遠端伺服器返回 OAuth 質詢時,它那一行會顯示「此伺服器支援 OAuth 登入。」。點選「使用 OAuth」,再點選「連線」,在瀏覽器中完成登入,這一行就會顯示「已在這台電腦上連線」。令牌會自動續期。
金鑰始終只是引用
任何地址、請求頭、環境變數值或引數都接受 {{secret:NAME}}。金鑰儲存在金鑰管理器中,啟動時在桌面版解析,絕不會儲存在宣告裡。
恢復時保留,不進 git
Claude Code 和 GitHub Copilot CLI 透過一個私有的啟動檔案獲得這些伺服器,恢復對話時會再次傳入。對於其他 CLI,AgentsRoom 會寫入專案級設定檔,並把它排除在 git 之外。

如何新增伺服器
五個步驟,只做一次。之後啟動的每個代理都會有這個伺服器。
- 1
開啟「MCP 伺服器」
在「設定 > 代理行為」中的「代理工具」下,開啟「MCP 伺服器」。它不在「AI 服務商」裡某個 CLI 的分頁中,因為伺服器是你希望所有 CLI 都能用的工具。同樣的欄位也存在於「專案設定 > AI 服務商」和代理編輯器的「高階選項」中。
- 2
新增伺服器
「從目錄新增」會開啟「MCP 伺服器目錄」:搜尋、選中一個伺服器,點選「新增」。或者點選「貼上 JSON」,放入你已經在某個 CLI 中使用的 mcpServers 塊,帶不帶 mcpServers 外層都可以。本地伺服器需要一條命令,遠端伺服器需要一個 url。
- 3
把金鑰留在塊之外
如果伺服器需要金鑰,就在請求頭或環境變數值中寫入 {{secret:NAME}},再用這個名稱把金鑰儲存到金鑰管理器中。
- 4
連線 OAuth 伺服器
對於透過 OAuth 登入的遠端伺服器,當這一行出現「使用 OAuth」時點選它,然後點選「連線」。瀏覽器會開啟該服務的登入頁面;你批准後,這一行會顯示「已在這台電腦上連線」。
- 5
啟動你的代理
從此以後啟動的每個代理,無論在哪個 CLI 上,都會在 AgentsRoom 自己的伺服器旁邊擁有這個伺服器。已經在執行的代理會在重啟時獲得新的伺服器或新的連線。
Claude Code 和 Codex 自己已經能做什麼
Claude Code 有一套完整的 MCP 配置功能:claude mcp add --transport http notion https://mcp.notion.com/mcp 可以新增一個遠端伺服器,local、project 或 user 作用域決定它存放在 ~/.claude.json 中,還是存放在透過 git 共享的 .mcp.json 中,而 /mcp 會在瀏覽器中幫你登入 OAuth 伺服器,令牌會替你儲存並續期(Claude Code 2.1.308,文件查閱於 2026年10月22日)。
Codex CLI 也有:codex mcp add notion --url https://mcp.notion.com/mcp 會把伺服器寫入 ~/.codex/config.toml,codex mcp login notion 會執行 OAuth 登入,在沒有瀏覽器的機器上可以加 --no-browser(codex-cli 0.163.0)。它支援可流式傳輸的 HTTP 伺服器,不支援 SSE。
如果你只用一個 CLI,這些就夠了。AgentsRoom 不會取代這些命令,也不會動你用它們新增的伺服器。它只是在上面加了一層:一份面向所有 CLI 的列表,在啟動時交付;OAuth 伺服器每台電腦只需登入一次,透過開源的 mcp-remote 橋接程式實現,無論各個 CLI 自身是否支援 OAuth,它在每個 CLI 上的表現都一樣。
限制
- 連線 OAuth 伺服器需要電腦上裝有 Node.js,因為登入是透過 npx 進行的。沒有它時,「連線」會提示在這台電腦上找不到 npx。
- OAuth 連線屬於這台電腦:在另一台機器上需要重新登入,「斷開連線」也只會在這台電腦上清除它。「設定」中的列表同樣如此;宣告在專案上的伺服器會隨專案來到你的其他電腦上。
- 已經在執行的代理只有在重啟後才會看到新的伺服器或新的連線。
- Aider 沒有 MCP 客戶端,所以不會收到任何伺服器。Codex 和 Mistral Vibe 沒有 SSE 傳輸:普通的 SSE 伺服器對它們會被跳過,HTTP 可以使用,而 OAuth 伺服器仍會透過本地橋接到達它們。
- 在 Windows 上,如果 OAuth 伺服器的地址或請求頭中含有 cmd.exe 視為特殊字元的字元,例如 & 或 %,它就無法啟動:該伺服器會被跳過,「連線」會給出提示。
- 每個代理會為它使用的每個 OAuth 伺服器啟動自己的橋接程序。
- 手機上沒有 MCP 伺服器編輯器。從手機上啟動的代理由桌面版以同樣的伺服器啟動,並使用在那台電腦上建立的連線。
常見問題
怎樣把同一個 MCP 伺服器新增到 Claude Code 和 Codex?
在 AgentsRoom 的「設定 > 代理行為 > MCP 伺服器」中宣告一次,可以用你會貼上到任何 CLI 裡的 mcpServers JSON,也可以從目錄中選擇。之後,AgentsRoom 啟動的每個代理都會以自己 CLI 的格式收到它,Claude Code 和 Codex 也包括在內。不用 AgentsRoom 的話,你要新增兩次:Claude Code 用 claude mcp add,Codex 用 codex mcp add。
怎樣登入使用 OAuth 的 MCP 伺服器?
在 Claude Code 中,執行 /mcp 並在瀏覽器中完成登入;在 Codex CLI 中,執行 codex mcp login 並加上伺服器名稱。在 AgentsRoom 中,當伺服器返回 OAuth 質詢時,伺服器那一行會提供「使用 OAuth」:點選「連線」,在瀏覽器中完成登入,這台電腦上所有 CLI 的每個代理都能訪問該伺服器,令牌也會自動續期。
對於不支援 OAuth 的 CLI,OAuth 連線也能用嗎?
能。OAuth 伺服器以同一條本地命令到達每個 CLI,也就是開源的 mcp-remote 橋接程式,由它處理登入並續期令牌。這個連線在所有帶 MCP 客戶端的 CLI 上表現一致,SSE 伺服器也以這種方式到達 Codex 和 Mistral Vibe,儘管它們自己沒有 SSE 傳輸。
哪些伺服器可以用 OAuth 連線?
任何透過 OAuth 登入的遠端 MCP 伺服器:Notion、Linear、Atlassian、Buddy.Works 等。AgentsRoom 會檢查沒有請求頭的遠端伺服器:當它返回 OAuth 質詢時,它那一行會顯示「此伺服器支援 OAuth 登入。」。
MCP 伺服器需要的 API 金鑰該放在哪裡?
放在金鑰管理器中。在需要它的請求頭、地址、環境變數值或引數中寫入 {{secret:NAME}},再用這個名稱儲存金鑰。這個值在啟動時於桌面版解析,絕不會儲存在宣告裡。
能只為一個代理關閉某個伺服器嗎?
能。在代理編輯器的「高階選項 > MCP 伺服器」中,關閉繼承來的那一行。該代理會儲存一個只說明此伺服器已停用的覆蓋設定,其他代理照常保留它。
我的 Claude Code 代理看不到我用 claude mcp add 新增的伺服器,為什麼?
在 AgentsRoom 的帳戶設定檔中,Claude Code 預設不讀取你的個人配置。在「設定 > 多帳戶」中開啟「使用我的個人 CLI 配置」,或者在 AgentsRoom 的「MCP 伺服器」中宣告這個伺服器,它會到達所有帳戶和所有 CLI。
我的 MCP 伺服器在我的其他電腦上也一樣嗎?
宣告在專案上的伺服器會隨專案來到你的其他電腦上。「設定」中的列表和 OAuth 連線屬於電腦本身:你需要在每台機器上各宣告和連線一次。手機上沒有編輯器;從手機啟動的代理使用執行它的那台電腦上的伺服器和連線。
你可能還喜歡
MCP : 代理可駕駛:手動或自動
四個 MCP 伺服器讓 Claude Code、Codex 等 CLI 駕駛 AgentsRoom 本身:讀取 backlog、執行 dev 命令、使用 prompt library、操作內嵌瀏覽器。
金鑰管理器
把 API 金鑰、令牌和密碼存進作業系統鑰匙串,在開發命令和代理環境裡用 {ref} 引用,交給 AgentsRoom 在啟動時解析。代理只看得到名稱,看不到值,任何內容都不會同步到伺服器。
多供應商
AgentsRoom支援17個AI編碼供應商:Claude、Codex、GitHub Copilot CLI、OpenCode、Antigravity CLI、Aider、Grok Build、Mistral Vibe、Kimi Code、Amp、oh-my-pi、Freebuff、Devin、Cursor、Command Code、Muse Code和Pi。為每個代理分配不同的供應商,在對話中途切換供應商,透過自動交接保持完整上下文。最好用的多供應商AI編碼工具。
Claude 多帳戶
在 AgentsRoom 裡,一台電腦上並排執行多個 Claude Code 帳戶:一個專案用個人帳戶,另一個用工作帳戶,第三個用客戶帳戶。按專案固定帳戶,按代理覆蓋,直接在應用內登入。macOS、Windows 和 Linux 上均可免費下載。
網路代理伺服器
為 Claude Code、Codex 和每個代理 CLI 分別設定不同的 HTTP 或 SOCKS 代理伺服器。AgentsRoom 按提供商設定 HTTPS_PROXY,在啟動前顯示出口 IP,並且不以明文儲存密碼。
一份 MCP 伺服器列表,供你所有的代理使用
下載 AgentsRoom,只需宣告一次伺服器,就能交給 Claude Code、Codex 和所有代理 CLI。
配套應用:隨時隨地監控你的 Agent
使用 Claude、Codex、Antigravity CLI 或其他 AI 提供商。
把 Bug 和需求直接傳送到您的公開待辦清單。