Saltar al contenido principal

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 restart en set_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.
Una herramienta que supera un límite responde TOOL_RATE_LIMITED, descrito más abajo, con el tiempo de espera.

Zips y archivos

  • Zip: upload_application y commit_application aceptan 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_application acepta 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 con edit_config_file.

TOOL_RATE_LIMITED

Una herramienta que supera un límite no se ejecuta. La respuesta es un resultado de herramienta normal marcado con isError: true, no un error HTTP, así que la conexión sigue funcionando. retry_after_seconds indica cuándo puede volver a ejecutarse:
Cuando el límite alcanzado es el presupuesto de herramientas por minuto, todas las herramientas esperan; si no, solo espera esa herramienta. Volver a llamar a la misma herramienta antes de que termine la espera responde 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 incluye code.

Al conectar

Resultados de herramientas

Llegan dentro de un resultado de herramienta, como code, 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.