Límites
Los límites son por cuenta y los comparten todas sus conexiones MCP.- Solicitudes al servidor MCP: hasta 60 por minuto, o el límite de tasa de la API de tu plan si es menor. Cuentan aparte de tus llamadas a la API, así que un agente muy activo nunca bloquea tu CLI, tus SDKs ni tus bots. Al superarlo, o mientras la cuenta esté por encima del límite de la API, el servidor MCP responde
429 RATE_LIMITED. - Llamadas a herramientas: un presupuesto por minuto que crece con tu plan.
- Las herramientas que trabajan dentro de tus aplicaciones o en la red de borde (archivos, logs, métricas, análisis de red, snapshots, bases de datos y eliminaciones) tienen además límites propios más estrictos.
- Cada llamada a una herramienta cuenta, incluidas las rechazadas por un recurso o por un alcance que depende de los argumentos (como
restartenset_env_vars). - Los commits siguen un ritmo por cuenta y por aplicación, compartido con la API, la CLI y el dashboard. Un commit enviado demasiado pronto responde
RATE_LIMITED.
TOOL_RATE_LIMITED, descrito más abajo, con el tiempo de espera.
Zips y archivos
- Zip:
upload_applicationycommit_applicationaceptan un zip de hasta 1 MB, enviado en base64, y de hasta 100 MB una vez descomprimido. El dashboard y la CLI aceptan zips de hasta 100 MB: úsalos para un proyecto más grande. - Archivos:
commit_applicationacepta hasta 50 archivos de texto, de hasta 128 KB cada uno y 512 KB en total. No pueden ser archivos ocultos, archivos.env, claves privadas ni el archivo de configuración, que se cambia conedit_config_file.
TOOL_RATE_LIMITED
Una herramienta que supera un límite no se ejecuta. La respuesta es un resultado de herramienta normal marcado conisError: true, no un error HTTP, así que la conexión sigue funcionando. retry_after_seconds indica cuándo puede volver a ejecutarse:
TOOL_EXECUTION_FAILED, que le indica al cliente que se detenga: espera unos minutos o usa el dashboard.
Errores
Errores HTTP
Llegan como el estado HTTP de la solicitud, con un cuerpo JSON que incluyecode.
Al conectar
Resultados de herramientas
Llegan dentro de un resultado de herramienta, comocode, junto a un summary que lee el cliente.
Una herramienta que tu clave no puede usar, o una que no existe, responde el error JSON-RPC
-32602 Unknown tool. Revisa los scopes de la clave. Los demás códigos vienen de la propia herramienta, y el summary los explica.
