MCP 服务器

你的 MCP 服务器,
一次进入所有代理 CLI

Claude Code 把 MCP 服务器存在 ~/.claude.json,Codex 存在 ~/.codex/config.toml,其他 CLI 也各有各的文件。给其中三个添加 Notion,就要把同一个服务器写三遍,再登录三次。AgentsRoom 只保留一份列表。

在“设置 > 代理行为 > MCP 服务器”中声明一个服务器,也可以声明在某个项目或单个代理上:AgentsRoom 启动的每个代理都会收到它,并以其自身 CLI 的格式写入。对于通过 OAuth 登录的远程服务器,例如 Notion、Linear 或 Atlassian,会显示一个“连接”按钮:在浏览器中登录一次,这台电脑上的所有 CLI 都能访问它。

一份列表,所有 CLI
你的 MCP 服务器
  • 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 之外。

AgentsRoom 设置,Agent behavior,MCP servers:交给所有 CLI 的所有代理的三个服务器,notion(Remote,This server offers an OAuth sign-in,Use OAuth)、sentry(Remote)和 github(Local,npx),每个都有开关和移除按钮,下方是 Add from catalog 和 Paste JSON
“设置 > 代理行为 > MCP 服务器”:每个代理都会收到的服务器,无论它用的是哪个 CLI。项目和单个代理也有同样的字段。

如何添加服务器

五个步骤,只做一次。之后启动的每个代理都会有这个服务器。

  1. 1

    打开“MCP 服务器”

    在“设置 > 代理行为”中的“代理工具”下,打开“MCP 服务器”。它不在“AI 服务商”里某个 CLI 的标签页中,因为服务器是你希望所有 CLI 都能用的工具。同样的字段也存在于“项目设置 > AI 服务商”和代理编辑器的“高级选项”中。

  2. 2

    添加服务器

    “从目录添加”会打开“MCP 服务器目录”:搜索、选中一个服务器,点击“添加”。或者点击“粘贴 JSON”,放入你已经在某个 CLI 中使用的 mcpServers 块,带不带 mcpServers 外层都可以。本地服务器需要一条命令,远程服务器需要一个 url。

  3. 3

    把密钥留在块之外

    如果服务器需要密钥,就在请求头或环境变量值中写入 {{secret:NAME}},再用这个名称把密钥保存到密钥管理器中。

  4. 4

    连接 OAuth 服务器

    对于通过 OAuth 登录的远程服务器,当这一行出现“使用 OAuth”时点击它,然后点击“连接”。浏览器会打开该服务的登录页面;你批准后,这一行会显示“已在这台电脑上连接”。

  5. 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 服务器列表,供你所有的代理使用

下载 AgentsRoom,只需声明一次服务器,就能交给 Claude Code、Codex 和所有代理 CLI。

免费下载 AgentsRoom

配套应用:随时随地监控你的 Agent

使用 Claude、Codex、Antigravity CLI 或其他 AI 提供商。

获取扩展程序
Chrome Web Store

把 Bug 和需求直接发送到您的公开待办清单。

多项目管理
多供应商
多代理运行
实时状态
文件差异与提交
移动应用
实时预览
代理团队
浏览器自动化
Backlog 驱动开发
提示词库
技能库
查看所有功能