Limites
Entenda os contadores do MCP, as recusas cobradas e quando reconectar o cliente de IA.
Limites do MCP
O MCP usa dois conjuntos de contadores: o balde da conta para chamadas de ferramenta e um balde separado por chave para mensagens do protocolo.
Balde da conta
Cada conta tem um único conjunto de contadores compartilhado pela API REST, por todas as chaves e por todas as chamadas tools/call do MCP.
| Plano com MCP | Por minuto | Por hora | Por dia |
|---|---|---|---|
| Plus | 20 | 300 | 2.000 |
| Pro | 30 | 600 | 5.000 |
Conta no balde da conta:
- Toda
tools/call, com sucesso ou erro. - Chamada de ferramenta desligada.
- Chamada de ferramenta de escrita com chave
read. - Nome de ferramenta desconhecido ou argumentos inválidos.
- Qualquer mensagem recebida enquanto o servidor MCP está desligado.
- JSON inválido e método que não pertence ao conjunto de mensagens de protocolo aceitas.
Uma recusa não devolve a cota. Quando qualquer janela estoura, a chamada recebe limite atingido e deve esperar antes de repetir.
Balde de protocolo
As mensagens usadas para conectar, conferir o servidor e descobrir ferramentas não gastam o balde da conta quando o servidor está ligado. Elas usam um limite separado de 60 mensagens por minuto para cada chave.
Entram nesse balde:
initializenotifications/initializedtools/listping
Esse balde não é cota para executar ferramentas. tools/call sempre usa o balde da conta.
Falhas de autenticação usam uma proteção separada por origem e não consomem os dois baldes autenticados.
Headers de limite
As respostas autenticadas podem informar:
| Header | Significado |
|---|---|
X-RateLimit-Limit | Total permitido na janela atual |
X-RateLimit-Remaining | Quantidade restante |
X-RateLimit-Reset | Renovação como Unix timestamp em segundos |
Ao receber limite atingido, não repita em loop. Aguarde a renovação indicada e aplique espera crescente se o cliente fizer novas tentativas automaticamente.
Quando reconectar
O servidor não mantém um canal aberto para avisar que a lista de ferramentas mudou. Por isso, estas mudanças só aparecem no cliente de IA depois de desconectar e conectar novamente:
- Ligar ou desligar uma ferramenta.
- Trocar a chave da API usada pelo cliente.
- Fazer upgrade para um plano com MCP.
Uma ferramenta desligada deixa de executar imediatamente, mesmo que ainda apareça numa lista guardada pelo cliente. O servidor confere a permissão de novo em toda chamada. A reconexão serve para atualizar a lista que a IA enxerga.
Depois de reconectar, confirme a lista de ferramentas antes de continuar uma conversa que possa alterar dados.