Vai al contenuto principale

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 restart in set_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.
Un tool oltre un limite risponde TOOL_RATE_LIMITED, descritto qui sotto, con il tempo di attesa.

Zip e file

  • Zip: upload_application e commit_application accettano 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_application accetta 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 con edit_config_file.

TOOL_RATE_LIMITED

Un tool oltre un limite non viene eseguito. La risposta è un normale risultato del tool contrassegnato con isError: true, non un errore HTTP, quindi la connessione continua a funzionare. retry_after_seconds indica quando il tool potrà essere eseguito di nuovo:
Quando il limite raggiunto è il budget dei tool al minuto, tutti i tool restano in attesa; altrimenti attende solo quel tool. Chiamare di nuovo lo stesso tool prima che l’attesa finisca risponde 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 contiene code.

Durante la connessione

Risultati dei tool

Questi codici arrivano dentro un risultato del tool, come code, 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.