本地 AI 助手连接与权限 AI 助手 · 问答

MCP 未知工具如何处理?

以当前客户端返回的工具列表为准,检查工具名和客户端版本,并区分后续调用的权限拒绝。

更新于 2026年8月24日

“Unknown tool”表示调用方请求的工具名不在 MaskPilot 当前实际提供的工具列表中。

建议处理

  1. 让调用方重新获取并列出当前 MCP 工具。
  2. 使用返回结果中的完整工具名,不要根据旧文档猜测。
  3. 确认客户端已更新到兼容版本。
  4. 如果工具存在但调用被拒绝,再检查当前登录账号的功能权限和目标资源访问范围。

工具列表会随客户端版本变化,不会按登录账号或成员权限筛选。自动化流程应先发现当前版本提供的工具,再发起调用,并分别处理“工具不存在”和“调用无权限”。