在 Verboo Code 中添加 MCP 服务器：从 add 到 doctor

把外部工具接入编程代理听起来很简单，直到服务器连不上,而你完全找不到原因。在 Verboo Code 中,这条路很短:一个添加命令,一条按作用域区分的审批规则,再加一个专门的诊断命令,专治连不上的情况。

如何在 Verboo Code 中添加一个 MCP 服务器?

使用 verboo mcp add <name> <command-or-url>。对于 stdio 服务器(本地进程):

verboo mcp add sentry -- npx @sentry/mcp-server

对于远程 HTTP 服务器,需要声明传输方式:

verboo mcp add --transport http sentry https://mcp.sentry.dev/mcp --header "Authorization: Bearer YOUR_TOKEN"

四个参数控制配置保存位置以及服务器如何鉴权:

参数	作用
-s, --scope	local、project 或 user。默认是 local:只有当前项目、在你自己的机器上能看到该服务器
-t, --transport	stdio、sse 或 http。不加此参数时 Verboo Code 默认按 stdio 处理
-e, --env	为进程设置环境变量,例如 -e API_KEY=xxx
-H, --header	为远程服务器设置 HTTP 头,例如 -H "Authorization: Bearer ..."

添加的每个服务器都需要审批吗?

不是。只有 project 作用域需要,因为这份配置会被提交进代码仓库,团队里任何克隆该项目的人都会继承其中的服务器。所以 project 作用域的服务器一开始状态是 pending,直到有人明确批准。local 作用域是 mcp add 的默认值,完全跳过这一步:它是你自己的配置,在你自己的机器上,由你自己负责。

服务器连不上,该如何诊断?

使用 verboo mcp doctor <name>。它会读取配置、检查各作用域之间的优先级,并且默认会真正尝试连接:

verboo mcp doctor sentry

参数	作用
--config-only	不启动进程、不联系远程服务器,仅分析配置
--json	以 JSON 格式返回报告,便于脚本或 CI 读取
-s, --scope	将分析限定在某个作用域:local、project、user 或 enterprise

不带任何参数运行(verboo mcp doctor)会一次性诊断所有已配置的服务器,当你接入了多个 MCP 却不确定是哪个出问题时很有用。

如何在不删除服务器的情况下启用或禁用它?

在会话内使用 /mcp enable <name> 或 /mcp disable <name>。用 all 代替具体名字可以一次性开关所有服务器,方便判断问题到底出在某个特定 MCP 上,还是别的地方。