Passer au contenu principal

Limites

Les limites s’appliquent par compte et sont partagées par toutes ses connexions MCP.
  • Les requêtes vers le serveur MCP : jusqu’à 60 par minute, ou la limite de débit de l’API de votre plan si elle est plus basse. Elles sont comptées à part de vos appels d’API, donc un agent très actif ne bloque jamais votre CLI, vos SDK ou vos bots. Au-delà, ou tant que le compte dépasse sa limite d’API, le serveur MCP répond 429 RATE_LIMITED.
  • Les appels d’outils : un budget par minute qui augmente avec votre plan.
  • Les outils qui travaillent dans vos applications ou sur le réseau edge (fichiers, logs, métriques, analyses réseau, snapshots, bases de données et suppressions) ont en plus leurs propres limites, plus strictes.
  • Chaque appel d’outil compte, y compris les appels refusés pour une ressource ou pour un scope qui dépend des arguments (comme restart dans set_env_vars).
  • Les commits suivent un rythme par compte et par application, partagé avec l’API, la CLI et le tableau de bord. Un commit envoyé trop tôt répond RATE_LIMITED.
Un outil qui dépasse une limite répond TOOL_RATE_LIMITED, décrit ci-dessous, avec le temps d’attente.

Zips et fichiers

  • Zip : upload_application et commit_application acceptent un zip de 1 Mo au maximum, envoyé en base64, et de 100 Mo au maximum une fois décompressé. Le tableau de bord et la CLI acceptent des zips jusqu’à 100 Mo : utilisez-les pour un projet plus gros.
  • Fichiers : commit_application accepte jusqu’à 50 fichiers texte, de 128 Ko chacun au maximum et 512 Ko au total. Il ne peut s’agir ni de fichiers cachés, ni de fichiers .env, ni de clés privées, ni du fichier de configuration, qui se modifie avec edit_config_file.

TOOL_RATE_LIMITED

Un outil qui dépasse une limite ne s’exécute pas. La réponse est un résultat d’outil ordinaire marqué isError: true, pas une erreur HTTP, donc la connexion continue de fonctionner. retry_after_seconds indique quand l’outil pourra s’exécuter à nouveau :
Lorsque la limite atteinte est le budget d’outils par minute, tous les outils attendent ; sinon, seul cet outil attend. Rappeler le même outil avant la fin de l’attente répond TOOL_EXECUTION_FAILED, ce qui indique au client de s’arrêter : attendez quelques minutes ou utilisez le tableau de bord.

Erreurs

Erreurs HTTP

Elles sont renvoyées comme statut HTTP de la requête, avec un corps JSON contenant code.

Lors de la connexion

Résultats des outils

Ils sont renvoyés dans un résultat d’outil, sous forme de code, à côté d’un summary que lit le client. Un outil que votre clé ne peut pas utiliser, ou qui n’existe pas, répond l’erreur JSON-RPC -32602 Unknown tool. Vérifiez les scopes de la clé. Les autres codes viennent de l’outil lui-même, et le summary les explique.