Windows用户配置Claude Code MCP Server：从踩坑到跑通（2026最新）

如果你是Windows用户，想在Claude Code里用MCP Server，大概率会遇到这些问题：

• spawn npx ENOENT 报错
• MCP Server连接超时
• 配置文件写对了但就是不生效

这篇文章帮你一次性踩完所有坑。

背景：MCP是什么？

MCP（Model Context Protocol）是Anthropic推出的开放协议，让AI助手（Claude Code、Claude Desktop、Cursor等）能调用外部工具。2026年4月，Claude Code正式支持Windows原生运行，但MCP配置在Windows上有不少坑。

前置条件

node -v   # 需要18+
npm -v
claude --version

配置方法

方法1：命令行添加（推荐）

claude mcp add webcheck -- npx webcheck-mcp

方法2：手动编辑 .mcp.json

{
  "mcpServers": {
    "webcheck": {
      "command": "cmd",
      "args": ["/c", "npx", "webcheck-mcp"]
    }
  }
}

Windows 5大坑

坑1：必须用 cmd /c npx

直接写 "command": "npx" 会报 spawn npx ENOENT。Windows上npx实际是npx.cmd，Node.js的spawn找不到.cmd后缀。必须用 cmd /c 包装。

坑2：PATH环境变量

如果cmd /c npx还是找不到，确认Node.js在系统PATH中：

$env:PATH -split ';' | Where-Object { $_ -like '*node*' }

坑3：配置文件编码

.mcp.json必须是UTF-8编码，不是UTF-8 with BOM。

坑4：改配置后必须重启

Claude Code只在启动时读取.mcp.json。改了不重启=没改。

坑5：防火墙/代理

npm config set proxy http://代理地址:端口
npm config set https-proxy http://代理地址:端口

多Server配置示例

{
  "mcpServers": {
    "webcheck": {
      "command": "cmd",
      "args": ["/c", "npx", "webcheck-mcp"]
    },
    "github": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "你的token" }
    },
    "playwright": {
      "command": "cmd",
      "args": ["/c", "npx", "@playwright/mcp"]
    }
  }
}

排查速查表

想深入学习MCP开发？ 我们已发布7个MCP Server（npm总计5000+/周下载）：

• 免费：全部工具一览
• 配置模板包：10个行业场景 面包多 ¥9.9
• MCP开发实战包：爱发电 ¥19.9