用途：在多个编码智能体（Claude Code、Cursor、VS Code、Claude Desktop、Gemini CLI、Codex、Goose、Zed 等）中统一管理 MCP 服务器，包括搜索、安装、配置、更新与移除。
主要能力：
- Claude Code 命令行管理：claude mcp add --transport http <name> <url>、claude mcp add --transport stdio <name> -- <command> [args...]、claude mcp add-json <name> '<json>'；查看用 claude mcp list、claude mcp get <name>；移除用 claude mcp remove <name>；OAuth 用 claude mcp login/logout。选项须写在服务器名之前。截至 2026-04，推荐 --transport http，sse 已终止支持。
- 多智能体批量安装：npx add-mcp <url 或包名>，支持 -g/--global、-a/--agent、-n/--name、-t/--transport、--header、-y/--yes、--all；npx add-mcp list-agents 可列出可用智能体。
- 搜索服务器：优先查官方厂商服务器，其次 MCP Registry API；信任层级为官方厂商 > MCP 参考服务器 > 已验证伙伴 > 社区。
- 配置范围（Claude Code）：local（默认，~/.claude.json）、project（.mcp.json）、user（~/.claude.json）。
- 环境变量语法：${VAR} 或 ${VAR:-default}；Windows 下 npx 需用 cmd /c 包装。
使用方式：安装前先用 AskUserQuestion 收集 API 密钥等必要配置；移除前必须用 AskUserQuestion 确认；增删改后需提示用户重启受影响的智能体。更新无直接命令，可编辑配置、移除后重加，或对 OAuth 服务器运行 /mcp 重新认证。
Codex 注意：CLI 可用 codex mcp list/get/login 验证；App/Desktop 线程仅在启动时加载并认证服务器后才获得工具，配置后需完全重启 App。项目级 .codex/config.toml 需在 ~/.codex/config.toml 中标记为 trusted。HTTP OAuth 用 codex mcp login <server-name>；bearer token 推荐 codex mcp add <name> --url https://example.com/mcp --bearer-token-env-var EXAMPLE_API_KEY。
OpenCode 注意：顶层键为 mcp，服务器须声明 type: "local" 或 "remote"；本地命令为单个数组，环境变量放在 environment 下；可用 enabled: false 禁用；OAuth 用 opencode mcp auth/logout。
限制：Claude Desktop 与 Goose 仅支持全局安装；Codex 项目级仅限受信任项目；部分第三方安装器写入的 http_headers.Authorization 不如原生字段清晰；OpenCode v1.14.x 中插件 tool.execute.* 钩子对 MCP 工具调用不触发。更多细节见 references 目录下 search.md、multi-agent.md、opencode-mcp.md、transports.md、scopes.md、troubleshooting.md。