🎯 你遇到的问题是这样吗？

在Claude Code中配置Playwright MCP时，遇到以下情况：

• ✅ GitHub MCP正常工作
• ❌ Playwright显示"× failed"
• ❌ 错误信息：MCP error -32000: Connection closed

如果是的话，恭喜你找对地方了！这个问题有完美解决方案。

🔍 为什么会出现这个问题？

简单来说：Windows系统的锅！

详细解释：

1. Claude Code想要启动Playwright MCP服务
2. 它使用npx命令来启动
3. 但在Windows下，npx是个批处理文件(.cmd)
4. Claude Code不知道怎么正确执行批处理文件
5. 结果连接建立后立即断开

这就像你想打电话，但不知道要先按区号一样。

💡 解决方案（5分钟搞定）

第一步：安装必要组件

# 安装playwright相关包
npm install -g @playwright/test
npm install -g @executeautomation/playwright-mcp-server

# 安装浏览器（会下载Chrome、Firefox等，比较大，需要等一会）
npx playwright install

第二步：移除旧配置（如果有的话）

claude mcp remove playwright -s local

第三步：用正确的方式配置（关键步骤！）

claude mcp add-json playwright "{\"command\": \"cmd\", \"args\": [\"/c\", \"npx\", \"@executeautomation/playwright-mcp-server\"]}"

这一步的意思是：告诉Claude Code要先启动Windows命令行(cmd)，然后在命令行里执行npx命令。

第四步：验证是否成功

# 查看配置是否正确
claude mcp list

# 测试连接（会看到很多调试信息，找到这一行就是成功了）
claude --print "测试playwright" --debug | findstr "connected"

成功的标志：看到类似这样的信息

[DEBUG] MCP server "playwright": Connection attempt completed in xxxx ms - status: connected

🚨 常见错误和解决办法

错误1：命令行提示"unknown option"

原因：参数解析有问题
解决：必须使用上面的JSON格式，不要用简化命令

错误2：还是显示"Connection closed"

解决步骤：

1. 确认安装了所有依赖包
2. 重启Claude Code
3. 删除配置重新添加

错误3：找不到npx或npm

原因：Node.js没装好或没加到系统路径
解决：重新安装Node.js，确保勾选"Add to PATH"

🎉 成功后你能做什么？

配置成功后，你就可以在Claude Code中：

• 自动化打开网页
• 模拟点击和输入
• 截图和数据抓取
• 自动化测试
• 等等…

📝 完整一键脚本

懒得一步步操作？复制下面的脚本，在命令行里一次性执行：

echo "开始安装Playwright MCP..."
npm install -g @playwright/test
npm install -g @executeautomation/playwright-mcp-server
npx playwright install
echo "移除旧配置..."
claude mcp remove playwright -s local
echo "添加新配置..."
claude mcp add-json playwright "{\"command\": \"cmd\", \"args\": [\"/c\", \"npx\", \"@executeautomation/playwright-mcp-server\"]}"
echo "验证安装..."
claude mcp list
echo "完成！"

❓ 还有问题？

Q: 为什么要用这么复杂的JSON格式？

A: 因为要告诉Windows系统正确的执行方式，简单命令会被误解。

Q: Mac/Linux用户也需要这样配置吗？

A: 不需要，这是Windows特有问题。Mac/Linux直接用npx就行。

Q: 这个方法安全吗？

A: 完全安全，只是改变了命令的执行方式，没有修改任何系统文件。

Q: 以后会自动修复这个问题吗？

A: 应该会，这是Claude Code的已知bug，未来版本可能会修复。

🏆 总结

记住这个关键命令就够了：

claude mcp add-json playwright "{\"command\": \"cmd\", \"args\": [\"/c\", \"npx\", \"@executeautomation/playwright-mcp-server\"]}"

这一行命令解决了Windows下Claude Code与Playwright MCP的兼容性问题。

---

如果这个方案帮到了你，别忘了收藏和分享！ ⭐