Limites
Os limites são por conta e compartilhados por todas as conexões MCP dela.- Requisições ao servidor MCP: até 60 por minuto, ou o limite de requisições da API do seu plano, se for menor. Elas contam à parte das suas chamadas à API, então um agente muito ativo nunca bloqueia a sua CLI, os seus SDKs ou os seus bots. Acima disso, ou enquanto a conta estiver acima do limite da API, o servidor MCP responde
429 RATE_LIMITED. - Chamadas de ferramentas: um orçamento por minuto que cresce com o plano.
- Ferramentas que trabalham dentro das suas aplicações ou na rede de borda (arquivos, logs, métricas, análises de rede, snapshots, bancos de dados e exclusões) têm, além disso, limites próprios mais justos.
- Toda chamada de ferramenta conta, incluindo chamadas recusadas por um recurso ou por um escopo que depende dos argumentos (como
restartemset_env_vars). - Os commits seguem um ritmo por conta e por aplicação, compartilhado com a API, a CLI e o dashboard. Um commit enviado cedo demais responde
RATE_LIMITED.
TOOL_RATE_LIMITED, descrito abaixo, com o tempo de espera.
Zips e arquivos
- Zip:
upload_applicationecommit_applicationaceitam um zip de até 1 MB, enviado em base64, com até 100 MB depois de descompactado. O dashboard e a CLI aceitam zips de até 100 MB: use-os para um projeto maior. - Arquivos:
commit_applicationaceita até 50 arquivos de texto, de até 128 KB cada e 512 KB no total. Eles não podem ser arquivos ocultos, arquivos.env, chaves privadas nem o arquivo de configuração, que muda poredit_config_file.
TOOL_RATE_LIMITED
Uma ferramenta acima de um limite não roda. A resposta é um resultado de ferramenta comum marcado comisError: true, não um erro HTTP, então a conexão continua funcionando. retry_after_seconds diz quando a ferramenta pode rodar de novo:
TOOL_EXECUTION_FAILED, que diz ao cliente para parar: espere alguns minutos ou use o dashboard.
Erros
Erros HTTP
Estes voltam como o status HTTP da requisição, com um corpo JSON que trazcode.
Ao conectar
Resultados de ferramentas
Estes voltam dentro de um resultado de ferramenta, comocode, ao lado de um summary que o cliente lê.
Uma ferramenta que a sua chave não pode usar, ou que não existe, responde com o erro JSON-RPC
-32602 Unknown tool. Confira os escopos da chave. Outros códigos vêm da própria ferramenta, e o summary os explica.
