MCP Setup 用于配置 Model Context Protocol（MCP）服务器，从而让 Claude Code 通过外部工具扩展能力，例如网页搜索、文件系统访问和 GitHub 集成。
主要能力 该技能帮助用户使用 claude mcp add 命令行界面配置常用的 MCP 服务器。CLI 会自动处理 settings.json 的更新与合并。支持的内置服务器包括：Context7（文档与代码上下文）、Exa Web Search（增强网页搜索，可替代内置 websearch）、Filesystem（扩展文件系统访问）、GitHub（GitHub API 集成，管理 issue、PR 和仓库）。还支持添加自定义的 stdio 或 HTTP MCP 服务器。
使用方式 配置流程以分步交互展开：第一步选择配置路径，包括“推荐入门配置”“单个热门服务器”或“自定义服务器”。推荐入门配置可进一步选择 Context7（默认推荐，零配置）、“Context7 + Exa”或包含 Context7、Exa、Filesystem、GitHub 的完整推荐组合。选择单个服务器时，可依次选择 Context7、Exa，或更多选项（Filesystem、GitHub、完整组合）。选择自定义服务器则直接进入自定义配置流程。交互式提问每次只问一个问题、选项不超过 3 个，避免过多选项被 Claude Code 判为无效参数。
第二步收集所需信息：Context7 无需 API key；Exa 需要 API key（可在 https://exa.ai 获取），也可输入 skip 稍后配置；Filesystem 需要允许访问的目录（默认当前工作目录）；GitHub 需要 Personal Access Token（可在 https://github.com/settings/tokens 创建，推荐作用域 repo、read:org），也可 skip。
第三步执行相应命令： Context7：claude mcp add context7 -- npx -y @upstash/context7-mcp Exa：claude mcp add -e EXA_API_KEY=<user-provided-key> exa -- npx -y exa-mcp-server Filesystem：claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem <allowed-directories> GitHub 本地 Docker 方案：claude mcp add -e GITHUB_PERSONAL_ACCESS_TOKEN=<user-provided-token> github -- docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/github/github-mcp-server GitHub HTTP 远程方案：claude mcp add --transport http github https://api.githubcopilot.com/mcp/ （Docker 方案需已安装 Docker；HTTP 方案更简单但能力可能不同。）
自定义服务器需要提供：服务器名称、传输类型（默认 stdio，或 http）、stdio 对应的命令与参数、http 对应的 URL、可选环境变量与 HTTP 头。随后构造并执行对应命令：stdio 使用 claude mcp add <server-name> -- <command> [args...]，可加 -e KEY=value；HTTP 使用 claude mcp add --transport http <server-name> <url>，可加 --header。若自定义服务器用于为 OMC 工作流提供组织专属参考资料，建议提供单一工具 get_company_context，通过 { context: string } 返回 markdown；示例注册命令为 claude mcp add company-context -- node examples/vendor-mcp-server/server.mjs，并在 .claude/omc.jsonc 或 ~/.config/claude-omc/config.jsonc 中把 companyContext.tool 指向完整工具名 mcp__company-context__get_company_context，onError 设为 warn。这属于提示上下文，而非运行时强制。
第四步验证：运行 claude mcp list 列出已配置的 MCP 服务器及其状态。第五步显示完成信息，提示重启 Claude Code 使更改生效，配置的 MCP 工具将对所有 agent 可用。
适用场景 适合需要为 Claude Code 增加文档查询、网页搜索、跨目录文件操作或 GitHub 仓库管理的用户，也适合接入组织自定义上下文服务器。
限制与注意事项 npx 类服务器需要 Node.js 18+；GitHub Docker 方案需要已安装并运行 Docker。若 MCP 服务器未加载，可检查 Node.js、npx、服务器状态与日志。Exa key 可在 https://dashboard.exa.ai 验证；GitHub token 需包含 repo、read:org 作用域。若 agent 仍使用内置工具，需重启 Claude Code。管理命令：claude mcp list 列出服务器，claude mcp remove <server-name> 移除，更新则先移除再重新添加。运行 /oh-my-claudecode:omc-doctor 可诊断问题。