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
restartdansset_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.
TOOL_RATE_LIMITED, décrit ci-dessous, avec le temps d’attente.
Zips et fichiers
- Zip :
upload_applicationetcommit_applicationacceptent 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_applicationaccepte 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 avecedit_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 :
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 contenantcode.
Lors de la connexion
Résultats des outils
Ils sont renvoyés dans un résultat d’outil, sous forme decode, à 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.
