claude mcp add-json 支持从标准输入读配置:令牌不用再写在命令行里
用 claude mcp add-json 加远程 MCP 服务器很方便,但有个老问题:整段 JSON 要作为参数写在命令行里,里面往往带着 Authorization 头或 API Key。这些内容会进 shell 历史,也可能被同机其他用户通过进程列表看到。
2.1.327 给出了一个简单的解法:把 JSON 名称后面的参数写成 -,配置就从标准输入读取。
怎么用
以前的写法:
bash
claude mcp add-json my-api '{"type":"http","url":"https://mcp.example.com/mcp","headers":{"Authorization":"Bearer sk-xxx"}}'现在可以把配置放在一个文件里(或由其他命令生成),再通过管道交给它:
bash
claude mcp add-json my-api - < my-api.mcp.json也可以配合密码管理器或环境变量,在管道里现场拼出 JSON:
bash
jq -n --arg t "$MY_API_TOKEN" \
'{type:"http",url:"https://mcp.example.com/mcp",headers:{Authorization:("Bearer " + $t)}}' \
| claude mcp add-json my-api -这样令牌只在管道里流过,命令行参数里只有 my-api -。
需要注意的地方
- 只能在普通 shell 里用。这个
-写法在 Claude Code 会话内部不可用,请在自己的终端里执行,而不是让 Claude 在会话中替你跑。 - 配置最终仍会写进配置文件。stdin 只是解决「传参时泄露」的问题,写入后的令牌依旧保存在对应作用域的配置里(用户级或项目级
.mcp.json)。项目级配置要提交到仓库前,记得改用环境变量占位,别把真实令牌提交上去。 - 临时文件用完就删。如果先把 JSON 存成文件再重定向,事后把文件清掉,或者干脆用上面的管道写法,不落盘。
顺带的一处修复
同一版本还修了 claude mcp add / claude mcp remove 在项目作用域下的一个坑:以前它们改写 .mcp.json 时,会把文件里其他顶层键(例如 $schema,或别的工具使用的 servers 字段)一起删掉。2.1.327 起这些键会原样保留,多个工具共用同一个 .mcp.json 的团队可以放心用命令行增删服务器了。
一句话:带密钥的 MCP 配置,改用 claude mcp add-json <name> - 从管道喂进去,比直接写在命令行里干净得多。