Limiti
I limiti sono per account e condivisi da tutte le sue connessioni MCP.- Le richieste al server MCP: fino a 60 al minuto, oppure il rate limit dell’API del tuo piano se è più basso. Vengono contate a parte rispetto alle tue chiamate all’API, quindi un agente molto attivo non blocca mai la tua CLI, i tuoi SDK o i tuoi bot. Oltre questo limite, o mentre l’account è oltre il suo limite dell’API, il server MCP risponde
429 RATE_LIMITED. - Le chiamate ai tool: un budget al minuto che cresce con il tuo piano.
- I tool che lavorano dentro le tue applicazioni o sulla rete edge (file, log, metriche, analisi di rete, snapshot, database ed eliminazioni) hanno inoltre limiti propri più stretti.
- Ogni chiamata a un tool conta, comprese quelle rifiutate per una risorsa o per uno scope che dipende dagli argomenti (come
restartinset_env_vars). - I commit seguono un ritmo per account e per applicazione, condiviso con l’API, la CLI e la dashboard. Un commit inviato troppo presto risponde
RATE_LIMITED.
TOOL_RATE_LIMITED, descritto qui sotto, con il tempo di attesa.
Zip e file
- Zip:
upload_applicationecommit_applicationaccettano uno zip fino a 1 MB, inviato in base64, e fino a 100 MB una volta decompresso. La dashboard e la CLI accettano zip fino a 100 MB: usale per un progetto più grande. - File:
commit_applicationaccetta fino a 50 file di testo, fino a 128 KB ciascuno e 512 KB in totale. Non possono essere file nascosti, file.env, chiavi private né il file di configurazione, che si modifica conedit_config_file.
TOOL_RATE_LIMITED
Un tool oltre un limite non viene eseguito. La risposta è un normale risultato del tool contrassegnato conisError: true, non un errore HTTP, quindi la connessione continua a funzionare. retry_after_seconds indica quando il tool potrà essere eseguito di nuovo:
TOOL_EXECUTION_FAILED, che dice al client di fermarsi: attendi qualche minuto o usa la dashboard.
Errori
Errori HTTP
Questi errori arrivano come stato HTTP della richiesta, con un corpo JSON che contienecode.
Durante la connessione
Risultati dei tool
Questi codici arrivano dentro un risultato del tool, comecode, accanto a un summary che il client legge.
Un tool che la tua chiave non può usare, o che non esiste, risponde con l’errore JSON-RPC
-32602 Unknown tool. Controlla gli scope della chiave. Gli altri codici vengono dal tool stesso, e il summary li spiega.
