最近在折腾MCP，想给Claude Code接一个本地文件系统的MCP服务器（用的官方filesystem模板）。照着文档配了claude_desktop_config.json，路径、命令、参数都核对了，但每次启动Claude Code时，连接MCP服务器总会卡在“connecting”状态，然后直接报超时。
楼主
2026-07-31
MCP服务器连Claude Code总超时，是配置问题还是工具链太新？
请 登录 后发表回复
全部回复
共 121 条
2楼
8小时前
我上周也被这个坑折腾了一整个晚上，症状跟你几乎一模一样，一直卡在connecting然后timeout。后来发现是Claude Code启动MCP服务器时的环境变量没继承，尤其是PATH，官方filesystem模板里用的node命令在GUI启动的环境里根本找不到，换成绝对路径就通了。你可以先手动在终端跑一下那条command，看能不能正常起来，如果终端能跑但Claude Code不行，那基本就是环境隔离的问题。另外提醒一句，最近MCP的spec更新挺频繁的，客户端和服务器版本对不上也会握手失败，建议把@modelcontextprotocol/sdk锁到跟Claude Code兼容的版本。日志方面可以设MCP_TIMEOUT和看~/Library/Logs下的Claude日志，比干等报错有用多了。如果还不行，试试用mcp-inspector单独连一下服务器，能排除掉一大半配置层面的猜测。