结果与错误处理
分清 HTTP、MCP 协议、业务状态与资源可用性。
三层检查
- HTTP 状态:401 表示服务 Token 缺失或无效;403 可能是来源或权限拒绝;429 表示入口限流。
- JSON-RPC 错误:顶层
error表示协议方法、请求结构等错误。 - 工具结果:即使 HTTP 200,
result.isError为 true 也表示本次工具失败。阅读result.content,以及存在时的result.structuredContent。
工具的输出 Schema 若没有精确定义业务字段,参考页会保留真实声明,不把示意响应当作业务契约。
常见情况
- 参数错误:对照参数表检查字段类型和必填项。
- 无访问权限:确认管理员分配的身份与项目范围;更换 ID 不能绕过授权。
- 目标不存在:确认项目和画布 ID,避免使用显示名称或示例占位值。
- 临时读取失败:保留原目标和身份后重试,不改用其他项目的数据。