限制
限制按账户计算,由该账户的所有 MCP 连接共享。- 对 MCP 服务器的请求: 每分钟最多 60 个;如果你套餐的 API 速率限制更低,则以它为准。这些请求与你的 API 调用分开计算,因此繁忙的智能体不会阻塞你的 CLI、SDK 或机器人。超出后,或在账户超出 API 限制期间,MCP 服务器会返回
429 RATE_LIMITED。 - 工具调用: 每分钟的调用预算随套餐增长。
- 在你的应用内部或边缘网络上工作的工具(文件、日志、指标、网络分析、快照、数据库和删除操作)还另有更严格的限制。
- 每次工具调用都会计数,包括因资源或因取决于参数的权限范围(例如
set_env_vars中的restart)而被拒绝的调用。 - 提交按账户和按应用遵循同一节奏,与 API、CLI 和控制面板共用。提交过早会返回
RATE_LIMITED。
TOOL_RATE_LIMITED,并附上需要等待的时间。
zip 与文件
- zip:
upload_application和commit_application接受以 base64 发送、最大 1 MB 的 zip,解压后最大 100 MB。控制面板和 CLI 接受最大 100 MB 的 zip,较大的项目请使用它们。 - 文件:
commit_application最多接受 50 个文本文件,每个最大 128 KB,总计最大 512 KB。不能是隐藏文件、.env文件、私钥或配置文件;配置文件通过edit_config_file更改。
TOOL_RATE_LIMITED
超出限制的工具不会执行。返回的是一个标记为isError: true 的普通工具结果,而不是 HTTP 错误,因此连接仍可继续使用。retry_after_seconds 表示该工具多久后可以再次运行:
TOOL_EXECUTION_FAILED,告诉客户端停止:请等待几分钟或使用控制面板。
错误
HTTP 错误
这些错误以请求的 HTTP 状态码返回,JSON 响应体中带有code。
连接时
工具结果
这些代码以code 的形式出现在工具结果中,旁边附有供客户端读取的 summary。
密钥无法使用的工具或不存在的工具会返回 JSON-RPC 错误
-32602 Unknown tool。请检查密钥的权限范围。其他代码来自工具本身,summary 会对其进行说明。
