一键为多编辑器安装 MCP 服务器

要解决的问题

当你决定给 Claude Code、Cursor、Codex 和 VS Code 同时接入同一个 MCP 服务器时，现实是每个客户端各有一套配置文件：有的在 ~/.claude.json，有的在项目根目录的 .mcp.json，还有的在应用目录下的 mcp_config.json。手工逐个编辑意味着：格式差异要逐个核对、传输类型（stdio / SSE / HTTP）要分别声明、环境变量和认证头要重复粘贴。改一次服务器地址就要在所有文件里同步改一遍，漏掉一个就是「这个客户端能用、那个不能用」的排查地狱。

技能如何工作

• 统一入口：底层调用 add-mcp 命令行工具，你只需要给出服务器 URL 或包名，配置的写入与同步交给它完成。
• 多客户端覆盖：一次操作即可把配置写入 Claude Code、Cursor、Codex、OpenCode、VS Code 等客户端各自的配置文件，不用逐个打开手写。
• 传输类型可声明：支持 stdio、SSE、HTTP 三种传输，部分客户端必须显式指定，工具通过 --type / --transport 参数处理。
• 参数与认证透传：stdio 服务器可以用 --env、--args 携带环境变量和启动参数；远程服务器可以用 --header 设置认证头，避免把密钥手工复制进每一份配置。

适用边界与注意点

• 需要本机已安装 Node.js 和 npx，这是唯一的运行时依赖。
• 部分 agent 对传输类型敏感，若不显式设置 type，可能出现服务器注册成功但无法连接的情况。
• 工具只负责写入和同步配置，服务器本身的可达性与认证有效性仍需自行验证。
• 涉及私有服务器时，认证头和环境变量会写入客户端配置文件，注意这些文件的权限管理。