兼容性表 17 格全绿，我还是装不上

上周有人在评论区贴了张截图：一份 MCP 兼容性矩阵，十七个宿主整整齐齐全绿。他说自己照着表挑了三个客户端，配完一个都连不上，问我这表是不是刷出来的。

表没骗人，是读法有问题。那张表的全部证据来自一个被测对象——官方那个时间服务器，本地进程、两个工具、零个资源、不校验身份（采集于 2026-10-25，十七格里只有五格跑过真机，另外十二格是照官方文档填的）。它能证明的事情非常窄：一个用 uvx 拉起来的 Python 小程序装得上。它证明不了你配远程地址、带鉴权、挂着几十个工具的服务器时会不会翻车。

所以这篇不吵结论，只做对号。按你屏幕上看到的东西查，查到了再翻到对应那一节。十七个坑点我按配置写法、能力缺失、容量超时、认证、生效条件分过组，完整版在 MCP 兼容性速查清单 里，下面只挑最常撞的四条。

按症状对号

这张表只能帮你定位到"哪一类"，具体到某一家，还是要看下面四条。

坑一 · 地址写对了，键名不对

现象：你把远程服务器写成"url": "https://..."，配置能保存，界面也显示已添加，但连接状态永远是失败，日志里连一次 HTTP 请求都没有。

原因：Windsurf 读的键是serverUrl，不是url。它不会因为你写了别的键名就报错，只会当成"没有地址"，静默跳过。这一条属于纯命名差异，抄别家的配置过来必踩。

解决：把键改成serverUrl，值不动。改完重启客户端再连，别在旧进程里等它自己刷新。

坑二 · 少了 type，保存按钮先投降

现象：填完 URL 点保存，弹一个校验错误，条目根本没进列表。删掉重填、换浏览器、重启都不行。

原因：Roo Code 只认url，同时要求type必须存在；只给地址不给类型，它没法判断这是本地进程还是远程端点，于是在写盘之前就把你拦下来。这跟网络无关，跟服务器也无关。

解决：url和type一起写，两个字段同进同出。遇到"保存即失败"，先数一遍字段，别急着排查网络。

坑三 · streamable 后面多打一个连字符

现象：配置保存成功，连接也建立了，但一发请求就断，反复重连，日志里是一堆看不懂的协议错误。

原因：WorkBuddy 认的类型值是streamablehttp，中间没有连字符。写成streamable-http它不认识，会退回一个默认类型去握手，两边的帧格式对不上。

解决：把连字符删掉。这类拼写问题没法靠猜，只能对着宿主文档一个字符一个字符核。

坑四 · 握手成功，工具列表是空的

现象：状态是绿的，连接正常，但工具面板空的，你让它干活它说没有可用工具。换宿主、换客户端，结果一样。

原因：服务端自己没注册任何工具。握手阶段只交换能力声明，不校验你实际挂了几个函数，所以"连上了"和"能用"是两件事。

解决：回到服务器侧，用命令行直连一次，看它返回的工具数量和名字。数量为零就说明问题不在客户端，任何宿主都救不回来。

复核只用三步

第一步，绕开所有客户端，直接用命令行连一次，确认这个服务本身活着、工具有几个。第二步，把你打算用的宿主单独拿出来，只配这一个服务，把其余条目全注释掉，排除互相干扰。第三步，配完重启进程，不要相信热加载。

三步做完还是不通，再去看文档。顺序反了，你会在客户端上耗掉一整晚。

补一句关于"卡在第几步"的判断：卡在保存，就是字段问题；卡在连接，就是地址或类型问题；卡在工具列表，就是服务端问题。这三段的边界很清楚，别把它们混成一团去查。

另外别在同一份配置里同时改三处。改一个字段、重启一次、看一眼结果，比一口气改五个地方然后不知道是哪一处生效要快得多。

总结

一张全绿的表回答的是"这个样本能不能装"，不是"你的场景能不能跑"；装不上时先对症状、再核字段，四类问题里有三类跟网络一点关系都没有。想把十七个坑点一次看完，可以对照 这份中文速查。

适合与不适合

适合：已经从别处抄了一份配置、结果连不上的人；要在三四个客户端之间来回搬同一份 JSON 的人；给团队写内部接入文档、需要一份排错顺序的人；手上同时有本地 server 和远程 server、被两种写法搞混的人。

不适合：只用过一个宿主、也只配过一个官方 server 的人，这四条坑你大概率一条都撞不上；不打算自己动手复核、只想知道"哪个客户端最好"的人，这篇给不了排名；以及所有服务都走市场一键安装、从不碰原始配置文件的人。

标签：MCP、DeepSeek Harness、配置排错、客户端兼容

本文由 DeepSeek Harness Hub 自动整理，数据来源于插件详情页。