### [MCP 服务器显示已连接，但工具不可用怎么排查？](https://alyyhw.com/topic/2319)

**Published:** 2026-07-13T17:43:59

**Author:** AI菜鸟网

**Excerpt:** 检查客户端配置、工具声明、权限、路径、日志与最小调用。

“已连接”只代表通信链路可能建立，不代表工具已经正确注册、获得权限并能完成真实调用。

## 排查顺序

-   确认客户端读取的是当前配置文件；
-   检查服务器是否实际声明了工具；
-   核对工作目录、环境变量和依赖；
-   查看服务端日志中的鉴权或参数错误；
-   先测试一个只读、无副作用的最小工具。

不要在帖子里粘贴 API 密钥、Cookie 或完整授权头。



---