同一个 MCP server，换个宿主就连不上？先查这三处

同一个 MCP server 在 A 宿主跑得好好的，配置原样搬到 B：保存没报错，列表里也躺着一行，可工具调不出来。多数人第一反应是「server 挂了」或「B 不支持它」。

2026-11-02 那次全量采集给了更冷静的答案：17 个宿主 × 153 个 MCP server 逐格判定 2,601 格，通过率高的宿主 67.3%，低的只到 21.6%。同一个 server 换个宿主，结论确实会反，但「反了」不等于「坏了」。

装不上和用不了分三层：宿主读不懂配置、读懂了没让它生效、生效了却没有东西可调。按这三层对号，大部分问题不用重装；条目本身的传输方式与工具规模，可先查 完整插件清单与汉化避坑指南。

一分钟对号：先看你卡在哪一步

你看到的现象	大概率的原因	先做的动作
保存就报错，配置项标红	键名、类型写法不对	照宿主自己的示例重写
保存成功，状态一直灰的	缺一步信任或开关	找 Trust、Approve、项目开关
工具为空，或只出来一部分	不提供工具、被截断、超上限	数工具数并对上限
换成远程地址就连不上	宿主不认这个传输字段	确认宿主的传输支持面

第一处 · 宿主能不能读懂这份配置

MCP 规定了消息长什么样，没规定配置文件长什么样，于是每个宿主自己定一套键名。远程地址字段最典型：有的叫 serverUrl，有的要求 type 写 streamablehttp（没有连字符），还有的顶层容器根本不叫 mcpServers——具体哪家是哪家，见坑一。

没有「通用模板」能覆盖这些差异：每换一个宿主，只从它的官方示例复制结构，再填自己的命令和参数。先定传输方式（stdio 或 http），再对键名；键名对了类型不对，很多宿主不报错，只当条目不存在。

第二处 · 配了之后有没有真正生效

这一类常被误判成「配错了」，其实是「配了没启用」：列表有条目、文件也改对了，就是不起作用。采集里记了四种典型：项目级开关默认关闭、未受信任目录装不了 server、新配置要手动 Trust、项目级 server 要人工批准，四家的具体名字见坑三。

共同点是宿主把「装」和「用」拆成两步，中间那步是安全确认。先回界面看有没有待确认提示，别急着改 JSON——改配置解决不了权限问题。

第三处 · 连上之后有没有东西可调

状态绿了、工具列表空，这一层跟配置无关。

一种是 server 自己不提供工具：153 个 server 里 50 个工具数是 0，另有 13 格判定为「没有对外提供任何工具，装上也没东西可调」。连接成功，调用无对象——这类 server 往往只提供 resources 或 prompts。

另一种是被宿主截断：Cursor 约 40 个封顶，Windsurf 约 100 个。工具数中位数 4、均值 15.3、最大 628，撞上限的是少数重型 server。前者换 server，后者削工具面。

两组数字放在一起才看得出问题

最高那一档是七个宿主并列：103 个 pass、3 个 na，通过率 67.3%。最低的 qoder 是 33 个 pass、117 个 fail，21.6%。同样 153 个 server，两端差别不在 server，在宿主。

分母含 na，na 是「没测到」——codebuddy 与 opencode 各 153 格全是这种，采集机没装它们的命令行工具，不等于不可用。若只算测到的格子，qoder 33/150 = 22.0%、gemini-cli 34/150 = 22.7%；两种口径都成立，不能混着说。逐格的完整结果看 MCP 兼容矩阵。

四个坑，逐个拆

坑一 · 每个宿主的配置写法各写各的

现象：同一段配置从 A 抄到 B，保存就报错，或字段被静默忽略。
原因：远程地址键名不统一——Windsurf 是 serverUrl，WorkBuddy 的 type 写 streamablehttp 且无连字符，Gemini CLI 的 httpUrl 与 url 语义不同（url 走 SSE 解析，握手失败），Zed 用 context_servers。
解决：以宿主示例为模板重写字段，只搬命令和参数，不搬结构。

坑二 · 工具数超过宿主上限

现象：连上了，工具只出来一部分，调缺失的报不存在。
原因：Cursor 约 40 个、Windsurf 约 100 个上限；本次 55 格 limited 里 14 格是这个原因（Cursor 10 格、Windsurf 4 格）。
解决：先数工具数，超上限就只挂必要那一组。

坑三 · 配了不生效

现象：配置写对了，列表也在，就是没反应。
原因：Trae 项目级默认关、Gemini CLI 未受信目录、WorkBuddy 要手动 Trust、Claude Code 项目级要人工批准，都卡在最后一步。
解决：先在界面处理待确认提示，再回头看配置。

坑四 · 0 工具 server

现象：状态绿，工具列表空白，什么都调不了。
原因：50 个 server 工具数为 0，另有 13 格判定「没有对外提供任何工具」；连接成功和可用是两件事。
解决：换 server，或先确认它是否只提供 resources、prompts。

四个坑排完仍不通，回 完整插件清单与汉化避坑指南 找同类 server 在别家的表现做对照。

总结

多数「换个宿主就连不上」不是 server 的问题，而是配置结构、生效开关、容量上限这三处之一；宿主侧兼容性与配置差异见 MCP 兼容矩阵。

适合与不适合

适合：已有能跑的 server、想迁到新宿主的人；要给团队写接入检查清单的人；遇到「状态绿但没工具」的灰区现象、想先分类再动手的人。
不适合：只用同一个宿主、从不迁移的人；要在企业代理或内网镜像后面部署的人，这次的采集覆盖不到；要求「装了就一定可用」的人，2,601 格里 pass 只占 51.5%。

标签：MCP、DeepSeek Harness、宿主兼容、协议适配

本文由 DeepSeek Harness Hub 自动整理，数据来源于 MCP 采集快照（2026-11-02）。