跳转到主要内容

限制

限制按账户计算,由该账户的所有 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 会对其进行说明。