[ClaudeCode指北] Windows 本地 MCP 服务器配置与管理指南
如果你在 **Windows 原生环境（非 WSL）**下配置 Claude Code 的 MCP (Managed Compute Platform) 服务器，遇到 “连接关闭” 错误，你不是一个人！这是一个典型的 Windows 环境执行陷阱。
本文不仅提供快速解决方案，还涵盖了服务器的配置与日常管理命令。
🚨 第一课：Windows 上的 cmd /c 陷阱
在 Windows 上，claude mcp add 后面跟的本地命令（如 npx 启动的脚本）无法直接被执行，因为操作系统无法直接识别和运行非原生可执行文件。因此，连接会立即失败。
解决方案：使用 cmd /c 包装器
你必须使用 cmd /c 来包装你的实际启动命令。它会启动一个 cmd 实例来执行命令，确保 Windows 能够正确地启动服务器进程。
| 操作 | 命令示例 | 效果 |
|---|---|---|
| 错误配置 | claude mcp add my-server -- npx -y @some/package | 导致“连接关闭”错误 |
| 正确配置 | claude mcp add my-server -- cmd /c npx -y @some/package | 成功启动本地服务器 |
💻 第二课：MCP 服务器的日常管理
配置完成后，你可以使用以下 claude mcp 命令家族来管理你的所有服务器配置。
核心管理命令
| 命令 | 作用 | 示例 |
|---|---|---|
list | 列出所有已配置的服务器。 | claude mcp list |
get | 获取特定服务器的详细配置信息。 | claude mcp get github |
remove | 删除不再需要的服务器配置。 | claude mcp remove github |
/mcp | 在 Claude Code 内部检查服务器状态、连接或进行 OAuth 2.0 身份验证。 | /mcp |
进阶管理技巧
| 标志/变量 | 作用 | 示例 |
|---|---|---|
--scope | 指定配置的存储位置，影响谁可以访问。 | claude mcp add --scope user ... |
- local (默认)：仅在当前项目中对您可用。 | ||
- project：通过 .mcp.json 文件与项目中的所有人共享。 | ||
- user：在所有项目中对您可用。 | ||
--env | 为服务器设置环境变量。 | claude mcp add --env KEY=value ... |
MCP_TIMEOUT | 配置 MCP 服务器启动超时时间（单位毫秒）。 | MCP_TIMEOUT=10000 claude mcp add ... |
MAX_MCP_OUTPUT_TOKENS | 增加 MCP 工具输出的令牌限制（默认 10,000）。 | MAX_MCP_OUTPUT_TOKENS=50000 |
🎯 总结
配置 Windows 本地 MCP 服务器，核心在于理解并使用 cmd /c 来处理本地命令。掌握了 claude mcp 的管理命令后，你就能高效地在不同项目和环境间切换和管理你的计算资源了！