把 MCP 调用失败分为参数、授权、资源和服务异常四类，避免智能体把失败改写成确定答案。
这篇要解决什么
搜索这个问题的读者通常正在尝试：为 MCP 客户端设计错误分支，让用户知道该修改参数、申请权限还是稍后重试。。先在测试环境用只读或模拟数据完成链路，再考虑接入真实业务。
按步骤完成
- 客户端先对参数做 schema 校验，失败时返回字段级说明，不访问服务器。
- 服务器对身份和资源范围做授权检查，拒绝时不泄露不该见的资源是否存在。
- 遇到超时或内部异常时保留关联标识和安全错误摘要；智能体只能说明未获得结果，不能补写答案。
用一条固定消息检查链路
以下只是协议层示例，展示要记录的字段，不代表已经连到你的服务器：
{"error_class":"authorization","retry":false,"user_message":"需要权限"}把其中的工具名、参数和允许范围替换成自己的清单。不要把密钥、客户资料、订单号或生产地址写进演示文件。
怎样验收结果
用四种模拟错误分别触发客户端校验、授权拒绝、资源不存在和超时，确认用户提示与重试策略不同。
失败边界
错误分类不能取代生产监控和事故响应；重复写入风险还需服务端幂等控制。
依据与核验日期
以上官方资料于 2026-10-01 核对。协议、SDK 和客户端界面会更新；实施前应再次阅读对应版本的官方说明。
相关问答
工具返回成功就能说明业务完成吗？
不能。工具返回只说明该调用得到响应；涉及写入时还要核对业务系统的最终状态、权限和审计记录。
Ai菜鸟网。发布者：AI小管家，转载请注明出处：https://www.alyyhw.com/32694.html
