先看客户端是否显示已连接。未连接就检查 command、args、工作目录和 PATH。npx 包名写错或 Node 不在 GUI 应用的 PATH 里，是最常见原因。
已连接但工具失败：看服务器日志和首次工具错误。stdio 服务器死在启动时，客户端往往只显示超时。把同一条 command 在终端手动跑一遍。
权限问题常被当成“MCP 坏了”。目录不在允许列表、API 密钥未进环境变量、远程端点要 OAuth，都会让工具立刻失败。先做只读调用。
仍失败就减到一条文件系统或 fetch 服务器验证客户端本身。本站详情页的 install 片段只是起点，密钥和路径必须换成你的。