
一个环境变量四个客户端只有一个没生效上周我给一个 MCP server 加了行环境变量API_BASE指到内网地址。Claude Code 里加完能用。Cursor 里也加完能用。Codex 那份我想着回头补一忙就忘了。三天后我在 Codex 里调同一个 server一直连不上。查了半天网络最后才发现不是网络的事是那份配置里压根没这行变量。三份配置两份对一份漏。这种事你不会当场发现只会在某天用另一个客户端时突然撞上。复制出来的配置迟早会分叉问题不在「要写三遍」很累。累是可以忍的。问题是同一份配置抄成三份之后它们就不再是同一份了。你在 A 里改一处B 和 C 不会跟着变。时间一长三个客户端里的「同一个 server」参数各不相同而且没人告诉你哪个是对的。这跟省不省 token 没关系。这是配置管理最老的那条常识一份东西只能有一个来源。三个副本等于三份会各自腐烂的真相。我本机的claude.json里手写了 12 个 server光这段 JSON 就 1,388 个字符。这还只是一个客户端。收成一份再铺出去我找过一圈能统一管配置的工具最后留下的是 mcptoon342KB 的命令行程序本体只用 Python 标准库不装第三方包。它只做一件核心的事把 server 清单收在它自己那儿只留一份从 Claude 的配置里导一次。之后谁要它替你铺过去。mcptoon sync跑完是这样✓ Claude Desktop 7 servers ✓ Cursor (global) 7 servers ✓ Cline 7 servers ✓ Windsurf 7 servers ✓ VS Code Copilot 7 servers ✓ Claude Code 7 servers Done: 6 agents updated, 42 servers synced, 0 errors6 个客户端的配置文件同时更新一共写进 42 处 server0 个错误。其中 Cursor 和 Windsurf 的配置文件原来根本没有是它新建的。我 claude.json 里那 12 个 server这次它收进去 7 个够把这 6 个客户端铺满剩下几个是临时试用的没启用。重点在这这 6 个客户端里的 server 参数从此是同一份东西的 6 个投影不会再各自分叉。技能也是同一回事工具只是一半另一半是技能。我本机的技能目录里有427 个 SKILL.md全文加起来1,193,709 个 token比大多数模型的上下文窗口还大。这个数是我用 tiktoken 的 cl100k_base 数的tiktoken 是我自己的工具跟 mcptoon 无关。mcptoon 的办法是把技能目录索引一遍往客户端的指令文件里写一行指针常驻只占39 个 token。要用哪个技能agent 自己去查不用把 427 个全背进上下文。技能跟工具一样也是收一份、铺多处。mcptoon sync这一条命令两边一起处理。不在名单里的 agent反而更省事这里有个事我一开始搞错了得说清楚。mcptoon 会自动写配置的客户端是一份固定名单一共 12 个。它分两类一类是挂 MCP 的 GUI 客户端就是上面那 6 个另一类是 Codex、Gemini CLI、opencode 这种它不动你的 MCP 配置只往它们的常驻指令文件里写一行技能指针。那 Hermes Agent、OpenClaw 这种两边都不沾的呢不用手写配置文件。mcptoon 是个普通命令行工具任何能跑 shell 的 agent把它指过去就能用全部工具和技能。我拿 Hermes 实测过hermes mcp add mcptoon --command mcptoon --args serve✓ Connected! Found 9 tool(s) from mcptoon一条命令连上。agent 侧多出 9 个网关工具上游那几十个工具都从这 9 个入口调不用一个个配。所以「不在名单里」不等于「不支持」。名单管的是自动帮你写配置文件CLI 这条路是任何能跑 shell 的 agent 都能走。限制数字都是我在 Windows 本机实测的mcptoon 0.8.14。换机器、换版本会有出入。mcptoon 现在只帮 12 个已知客户端自动处理配置。你的客户端不在名单里就走 CLI 那条路别指望它自动写。OpenClaw 我没在本机跑过只验证了 Hermes。能跑 shell 就该走通但这一条你得自己试。技能那 39 个 token 是常驻指针的大小不是「所有技能一共 39 个 token」。技能全文还在硬盘上用的时候才拉。它会改写你已装客户端的配置文件。先备份或者用mcptoon off一键摘掉。如果你只有一个客户端配置根本不会分叉这事跟你没关系。别为了省而省。最后交代一句这工具不是我写的。我用了几周现在 server 清单只在它那儿存一份。你们那边有没有过「某个客户端里的配置早就跟别的对不上了」的经历是怎么发现的评论区聊聊。