在 Verboo Code 添加 MCP 服务器：完整命令指南

MCP 服务器，是你给编程智能体接上它出厂时没有的工具的方式：你的 issue 系统、你的数据库、你的内部 API。Verboo Code 用一条命令就能加上。大家真正会搞错的是两件事：配置落在哪个作用域，以及服务器说的是哪种传输方式。

本文把这两件事讲清楚，再加上服务器拒绝连接时用的诊断命令。

Verboo Code 中 MCP 服务器的流程图。三个连续步骤：添加，使用 verboo mcp add，默认 local 作用域；授权，你在对话框中授权该服务器；使用，服务器的工具加入会话。下方分支展示了用 verboo mcp doctor 进行诊断的路径及其参数。 — 三个步骤，外加第三步没发生时的一个分支。

怎么添加一个 MCP 服务器？

命令是 verboo mcp add。不论哪种传输方式，形式都一样：

verboo mcp add <名称> <命令或URL> [参数...]

变的是传输方式。一共三种，你不指定时 Verboo Code 默认用 stdio。

通过 HTTP 的远程服务器

verboo mcp add --transport http sentry https://mcp.sentry.dev/mcp

需要请求头的远程服务器

verboo mcp add --transport http corridor https://app.corridor.dev/api/mcp \
  --header "Authorization: Bearer ..."

--header 可以重复使用，一个请求头写一次。

通过 stdio 的本地服务器

verboo mcp add -e API_KEY=xxx my-server -- npx my-mcp-server

-- 很关键。它后面的一切会成为子进程的命令行，而不会被当作 verboo 的参数解析，这正是你能给自己服务器传参的原因：

verboo mcp add my-server -- my-command --some-flag arg1

两个看起来一样的错误。漏掉名称会得到 Error: Server name is required.，漏掉命令会得到 Error: Command is required when server name is provided.。两者都会打印用法行，所以重试之前先看清你碰到的是哪一个。

该用哪个作用域？

这个参数决定还有谁能看到这个服务器，而默认值是最窄的那个。

作用域	配置存放位置	什么时候用
`local` （默认）	只在这台机器、只在这个项目	你在试用这个服务器，或它里面有个人令牌
`project`	随仓库一起走	所有在这个代码库上工作的人都需要同一个服务器
`user`	你的机器，所有项目	你希望到处都有的服务器，比如笔记或任务系统

verboo mcp add --scope project ci-tools https://internal.example.com/mcp --transport http

还有第四个作用域，只能读不能写。verboo mcp doctor 接受 enterprise 作为要检查的作用域，而 verboo mcp add 只接受 local、user 和 project。如果你们团队有企业级下发的 MCP 配置，你可以用 CLI 诊断它，但不能在那里编辑。

需要 OAuth 的服务器怎么办？

三个参数就够了，而且只适用于 HTTP 和 SSE 传输：

`--client-id <id>`	OAuth 的 client ID
`--client-secret`	当场提示输入密钥。也可以设置 `MCP_CLIENT_SECRET` 代替手输
`--callback-port <端口>`	固定回调端口，用于要求预注册 redirect URI 的服务器

固定端口这条最值得记。很多 OAuth 提供方会拒绝没见过的 redirect URI，而随机端口每次都会失败，还不告诉你原因。

服务器连不上，怎么办？

按名称对这个服务器运行诊断：

verboo mcp doctor my-server

它会报告配置、作用域之间的优先级、服务器是被禁用还是处于待定状态，以及连接健康度。三个参数会改变它的行为：

参数	作用
`--config-only`	只分析配置。不启动进程，不联系远程服务器
`-s, --scope <作用域>`	把分析限制在一个作用域：local、project、user 或 enterprise
`--json`	以 JSON 输出报告，方便脚本或 CI 步骤使用

在不是你写的目录里运行之前，先读这段。命令自己的说明写得很直白：不加 --config-only 时，stdio 服务器可能被启动，远程服务器可能被联系。随克隆仓库一起进来的 project 作用域 MCP 配置，就是你即将执行的代码。在陌生的代码库里，先从 --config-only 开始。

怎么关掉一个服务器而不删除它？

在会话内，由 /mcp 斜杠命令处理。它的参数提示是 [enable|disable [server-name]]：

/mcp                      打开 MCP 设置面板
/mcp disable my-server    关闭某一个服务器
/mcp disable              全部关闭
/mcp enable my-server     重新打开
/mcp reconnect my-server  不重启会话直接重连

省略服务器名会作用于全部，方便，但偶尔会让人意外。如果一切已经处于你要求的状态，它会直说，而不是假装做了什么：All MCP servers are already disabled。

reconnect 是最容易被忽略的一个。远程服务器掉线时，本能反应是重启整个会话，然后丢掉你辛苦攒起来的上下文。只重连那一个服务器则能保住它。

真正好用的顺序

用能满足需要的最窄作用域添加。local 是默认值是有原因的。等你确认这个服务器值得提交进仓库，再升级到 project。
授权它。Verboo Code 会在让新服务器进入会话之前询问你。那个对话框是安全边界，不是走过场。
连不上时，先用 --config-only 跑 doctor。大多数失败都是配置问题，而只看配置的那一遍能告诉你这一点，且不执行任何东西。
之后再让它去尝试真实连接。

上面每一条命令都来自 2026 年 9 月 3 日对 verbeux-ai/code 源码的阅读，位置在 src/commands/mcp/。这些参数、默认值和报错文本是代码真正在做的事，不是 changelog 声称的事。

智能体之所以能在回答之前读完整个仓库，也是同一个原因：在 Verboo Code 上，模型跑在专用 GPU 且 token 不限量，读三个文件和读三十个文件成本一样。

MCP 值得那点配置成本，恰恰因为配完之后它就不再是成本了。服务器一旦落在正确的作用域，工具就一直在那儿，每个会话都在，智能体也就不用再去猜那些本可以直接查到的东西。

如何在 Verboo Code 中添加 MCP 服务器（以及连不上时怎么排查）