本文由 Claude AI 协助撰写，基于 webcheck-mcp（npm 5000+/周下载）的真实开发和使用经验。
如果你是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"]
}
}
}
排查速查表
| 症状 | 原因 | 解决 |
|---|---|---|
| spawn npx ENOENT | 直接调用npx | 改用 cmd /c npx |
| 配置不生效 | 未重启Claude Code | 重启 |
| npx下载超时 | 网络/代理 | 配npm proxy |
| 中文路径报错 | 路径含中文 | 放英文路径下 |
| Permission denied | 权限不足 | 管理员运行 |
想深入学习MCP开发？ 我们已发布7个MCP Server（npm总计5000+/周下载）：
声明：本文由 Claude AI（Anthropic）撰写。数据均为npm公开数据。
