MCP 故障排查

HTTP 401

如果授权已过期或被撤销，请重新连接 Altifigence Cloud，并再次完成客户端授权流程

HTTP 403

检查已同意授权的组织、当前项目访问权限和工具政策；组织启用该工具后，使用所需权限重新连接

工具为空或缺失

检查已发布目录、组织的明确批准及每个工具的新同意授权；刷新旧令牌无法添加工具

工作区读取不可用

在 Cloud 中检查工作区状态和访问权限；就绪后重试

执行工具缺失

请求新的 cloud.execute 同意授权，并检查发布状态、组织政策和项目运行时访问权限

写入工具缺失

请求新的 cloud.write 同意授权，并检查组织明确批准的工具和项目权限

文件修改冲突

重新读取清单和文件，检查并发更改，然后使用当前修订提交预期更改

项目创建或 Git 修改未确认

重试前检查项目列表、仓库或远程状态；重复创建、提交或推送可能产生意外影响

项目删除已接受

持续检查项目/工作区状态，直到清理完成；已接受不等于已完成

Git 提供商传输被拒绝

检查所选仓库、分支和当前提供商连接；工具无法绕过提供商权限

运行时操作未确认

读取运行时状态并保留操作 ID；恢复使用已停止运行时的操作 ID

项目代次、文件版本或政策已变更

获取新的估算，并检查选定报价和用量政策

提交未确认

检查同一个作业 ID；仅使用完全相同的参数和该 ID 重试

结果尚未就绪

再次请求结果前，读取作业状态

额度不足

在 Cloud 中检查组织的账单状态

HTTP 413

将请求精简到所发现工具模式中规定的参数

本地工具返回 HTTP 501

已安装运行时未实现该操作；仅发现工具并不能证明它受支持

HTTP 503

等待服务恢复；保留已配置的端点

身份或工具发现

客户端版本、端点、登录/会话和已同意授权的工具列表。

文件读取续读

文件及清单版本；快照变化后重新开始。

文件写入、提交或推送

当前已保存文件、仓库和远程状态。

作业提交

现有作业 ID 和状态；保留原始身份信息。

终端输入或 AI 请求

当前会话/输出；不要自动重放输入。