MCP 工具列表为空，或工具可见但调用失败怎么查

工具列表为空和调用失败属于不同阶段

Server 显示连接只证明传输可能建立。还要确认能力声明、客户端支持、授权和工具参数；先定位失败发生在发现还是执行。

工具列表为空

常见原因：Server 未声明工具、启动后立即退出、客户端未刷新或该连接只提供资源。

处理方法：查看 Server 能力和日志，重载客户端，确认配置的确指向预期 Server。

记录 Client、Server、配置位置、传输方式、认证范围、工具列表和一次真实调用结果。

工具可见但参数报错

常见原因：客户端传入字段与当前 schema 不一致，必填、类型或枚举变化。

处理方法：查看工具当前 schema，用最小参数调用，不从旧示例推断。

确认“工具可见但参数报错”已经有可回查结果，再进入“工具开始调用后失败”；依据仍然来自猜测时，把缺口单列并停在当前步骤。

工具开始调用后失败

常见原因：工具内部依赖、网络、凭证或目标资源权限错误。

处理方法：关联调用 ID、Server stderr/日志和上游状态，定位第一处失败。

确认“工具开始调用后失败”已经有可回查结果，再进入“某客户端能用，另一客户端不能”；依据仍然来自猜测时，把缺口单列并停在当前步骤。

某客户端能用，另一客户端不能

常见原因：客户端支持、配置作用域、传输或授权行为不同。

处理方法：分别按当前客户端文档核对，不直接复制配置并假设兼容。

先用只读、小范围请求验证连接；涉及写入、删除、付款或外发时必须重新确认对象与权限。 完成后把证据归入“工具发现与调用对照表”。

对照表记录发现和调用两次结果

工具名、schema、最小参数、调用结果和日志位置一并保存。只有列表截图没有实际只读调用，不能证明可用。