ViiVo / 开发者文档

结果与错误处理

分清 HTTP、MCP 协议、业务状态与资源可用性。

三层检查

  1. HTTP 状态:401 表示服务 Token 缺失或无效;403 可能是来源或权限拒绝;429 表示入口限流。
  2. JSON-RPC 错误:顶层 error 表示协议方法、请求结构等错误。
  3. 工具结果:即使 HTTP 200,result.isError 为 true 也表示本次工具失败。阅读 result.content,以及存在时的 result.structuredContent。

工具的输出 Schema 若没有精确定义业务字段,参考页会保留真实声明,不把示意响应当作业务契约。

常见情况

  • 参数错误:对照参数表检查字段类型和必填项。
  • 无访问权限:确认管理员分配的身份与项目范围;更换 ID 不能绕过授权。
  • 目标不存在:确认项目和画布 ID,避免使用显示名称或示例占位值。
  • 临时读取失败:保留原目标和身份后重试,不改用其他项目的数据。

本页内容