Pular para o conteúdo principal

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 restart em set_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.
Uma ferramenta acima de um limite responde TOOL_RATE_LIMITED, descrito abaixo, com o tempo de espera.

Zips e arquivos

  • Zip: upload_application e commit_application aceitam 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_application aceita 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 por edit_config_file.

TOOL_RATE_LIMITED

Uma ferramenta acima de um limite não roda. A resposta é um resultado de ferramenta comum marcado com isError: true, não um erro HTTP, então a conexão continua funcionando. retry_after_seconds diz quando a ferramenta pode rodar de novo:
Quando o limite atingido é o orçamento de ferramentas por minuto, todas as ferramentas esperam; caso contrário, só aquela ferramenta espera. Chamar a mesma ferramenta de novo antes de a espera acabar responde 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 traz code.

Ao conectar

Resultados de ferramentas

Estes voltam dentro de um resultado de ferramenta, como code, 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.