排查 API 与 MCP 接入

使用正确地址和凭据

MCP 已上线公开测试。浏览器未带 OAuth 直接打开 MCP URL 时，可能收到鉴权响应；它不是普通 HTML 页面。仅凭这一点不能判断服务不可用。

不要用 API Key 替代 MCP OAuth，不要把网页登录 Token 当作 API Key，也不要自行加 /sse 路径。按 MCP 客户端接入配置。

登录成功但工具失败

检查所登录的 AnimGen 账户是否已验证、开发者访问是否暂停，以及是否授予所需 Scope；产生费用的生成还要检查积分余额。

授权被撤销、权限缺失或客户端授权流程不兼容，都需要单独处理，不是增加余额就能解决。必要时通过官方流程重新连接，不要为了绕过错误禁用 PKCE 或放宽回调校验。

首先使用 list_models 做只读检查。它成功只能证明连接与读权限正常，不能证明客户端可以上传文件、用户已批准生成，或完整输出质量已验收。

上传或下载未完成

远程服务不能读取本地路径。调用 prepare_image_upload 后，必须用获准的客户端能力传输真实字节，再通过 complete_image_upload 获得可用文件 ID。

同样，download_asset 返回的是元数据和临时 URL，不是已经保存到电脑的文件。下载字节时不要转发 API/OAuth 凭据。客户端缺少相关能力时，应说明限制，使用获准且受支持的替代方式。

报价与支出拒绝

quote_id 和 max_credits 是 MCP 中与 request 同级的工具参数，不是公开 API 请求体字段。单次上限也不是整个会话总预算。详见支出保护。

安全恢复结果不明的创建请求

保留相同请求、幂等键、账户及凭据身份：API 对应 Key ID，MCP 对应 OAuth 客户端。不能换 Key 或客户端后，仍假定幂等去重会跟随。

已知任务 ID 时先轮询，再决定是否重试创建。遵守可重试标志及 API 返回的 Retry-After；MCP 结构化错误不保证携带这个 HTTP 响应头。为重试和本地等待设上限。

本地超时不会取消远端任务；终态失败也可能有部分输出和收费。求助时，通过私密渠道提供请求/任务 ID、时间、错误码、客户端类型和失败阶段，不附带凭据或签名链接。