创建

登录 ReadmeX

或

了解我们如何处理你的信息: 隐私政策

ReadmeX

陪你读懂 AI 动态

今天,想先了解什么?

选一份动态总结,或直接聊聊你的问题。

社区和关注动态总结只属于你自己。

资讯

Windows 配置 Claude Code MCP 的三个坑

AI 总结

一名掘金作者在 Windows 11、Claude Code 2.1.318 上使用官方 @modelcontextprotocol/server-filesystem 测试时,复现了三个 MCP 连接问题。解决方案包括在 Windows PowerShell 5.1 中为“--”加引号、避免 Git Bash 转换“cmd /c”的路径,以及为指定 MCP 服务将新版 Node.js 目录置于 PATH 前面。作者建议运行“claude mcp list”,核对实际命令并查看服务是否已连接。

深度见解

该文为 Claude Code 的常见 Windows 配置故障提供了可操作的排查方法,但结论仅基于一名作者的环境,且未测试 PowerShell 7。

网上的 Claude Code + MCP 教程很多,但我在 Windows 上照着做,好几次都卡在"命令明明一样,就是连不上",这是最让人绝望的,每个字母都认真核对后都还是不行。下面三个坑是我这两天在自己电脑上一个个复现出来的,每个都给出能直接用的解决办法。 先说结论:Windows PowerShell 像一坨屎

测试环境:Windows 11,Claude Code 2.1.318,Node.js 26 / 20.20.2,系统自带的 Windows PowerShell 5.1,Git Bash。测试用的 MCP 是官方的 @modelcontextprotocol/server-filesystem。

先说一个通用的排查办法:配完之后跑一下

claude mcp list

每个服务后面会显示 ✔ Connected 或 ✘ Failed to connect。重点看它显示的那条命令和你输入的是不是一样——下面第 2 个坑就是靠这个发现的。


坑 1:PowerShell 里 -- 被"吃掉",报 unknown option '-y'

教程里的标准写法:

#Claude Code#@modelcontextprotocol/server-filesystem#Node.js#Windows PowerShell 5.1#Git Bash

原文约 3 分钟读完阅读原文
群聊

还没有评论,来说说你的看法。