用途：install-mcp 是 MCP 配置的清单与调度入口，不新增安装脚本。执行模型依据清单完成预览、备份和精确写入，不替代任何专用安装器。Memorix full mode 的实际安装与校验交给 init-simple-memorix；通用第三方 MCP 仅在确认 server entry schema、command、args、env 和信任审批影响后处理。所有写入必须以保留既有配置为前提，不能覆盖其他 mcpServers。
已知配置目标：Codex 为 ~/.codex/config.toml 与 ~/.codex/config-2026-6-13-bg.toml（TOML）；Claude Code 为 ~/.claude.json；Cursor 为 ~/.cursor/mcp.json；WorkBuddy 为 ~/.workbuddy/mcp.json 与 ~/.workbuddy/.mcp.json；ZCode 为 ~/.zcode/cli/config.json；Qoder 为 ~/AppData/Roaming/Qoder/SharedClientCache/mcp.json 与 ~/.qoder/mcp.json；MiniMax Code 为 ~/.minimax/mcp/mcp.json；Kiro 为 ~/.kiro/settings/mcp.json（以上除 Codex 外均为 JSON）。
合并规则：JSON 通常以 mcpServers 对象保存 entry，只新增或更新目标 entry，保留未知顶层字段和其他 entries；TOML 只修改目标 table，保留注释、未知字段和其他 server tables。先解析当前文件生成 dry-run 预览，经授权后写入，写入前创建可识别备份。配置不存在时先确认平台接受的最小结构再创建；解析失败或结构不明时停止写入并报告。不用模板整体覆盖，也不假设不同平台 JSON entry 可互换。
特别处理：WorkBuddy 可能向子进程注入 Node 参数，对需隔离的 entry 可建议 env.NODE_OPTIONS = ""；变更可能触发信任审批，写入后应提示重启并确认连接。MiniMax Code 的 entry 字段更丰富，stdio 用 command、args、env，远程用 url + type: "streamable-http" 可带 headers；常带 enabled、configured、builtin、description、timeout 等元数据须原样保留，builtin: true 的内置服务不修改不删除；该文件及同目录 tokens.json 可能含敏感凭据，dry-run、备份与报告不得原样输出。Qoder 的 ~/.qoder/mcp.json 为极简形态，保持极简，注意不是 mcp-router.json；~/.qoder-cli、~/.qoder-cn、~/.qoderwork、~/.qoderworkcn 属不同产品，不得跨写；~/.qoder 下其他运行态目录不触碰。
限制：未知第三方 server 不写入，需先取得可靠配置来源与用户授权；Antigravity、Trae、Gemini CLI 等仅为候选平台，需找到可靠可验证路径与格式后才可加入可写目标。写入后重新解析配置，确认其他 mcpServers 未变化，并按平台要求重启或刷新后检查 server 状态。