# Limites e erros (/mcp/limites-e-erros)

Quantas chamadas cabem por minuto, o tamanho máximo das consultas e o que cada erro quer dizer.

## Limites

- **Chamadas por minuto**: Folga de sobra pra um assistente encadeando várias consultas numa resposta. Ao passar do limite, a chave espera um minuto antes de voltar.

- **Janela de datas**: `start_date` e `end_date` podem cobrir no máximo 366 dias. Não existe o atalho "todo o período".

- **Listas nos parâmetros**: Parâmetros que recebem lista, como `exclude_terms`, aceitam até 100 itens.

- **Tamanho da requisição**: Limite do corpo de cada chamada.

## Erros de conexão

Estes voltam como status HTTP, antes de qualquer tool rodar.

- **401**: Chave ausente, errada ou revogada. Confira o cabeçalho `Authorization: Bearer SUA_CHAVE` ou crie outra chave.

- **429**: Passou de 120 chamadas no minuto. O cabeçalho `Retry-After` diz quantos segundos esperar.

- **413**: O corpo passou de 256 KB.

- **405**: O servidor só aceita `POST`. Não há stream nem sessão pra abrir com `GET`.

## Erros das tools

Quando a conexão está certa mas a consulta não, a resposta vem normal, com `isError: true` e uma mensagem em português. O assistente costuma ler a mensagem e tentar de novo com os parâmetros corrigidos.

- **Argumento inválido**: Um parâmetro com tipo errado, valor fora da lista, abaixo do mínimo ou acima do máximo. A mensagem diz qual, por exemplo `period: valor inválido. Use um de: today, 7d, ...`.

- **Obrigatório**: Faltou um parâmetro obrigatório, normalmente o `brand_id`.

- **Operação não permitida**: O `brand_id` é de uma marca que a sua chave não enxerga.

- **Nenhuma marca liberada**: A sua conta não tem nenhuma marca em empresa com o MCP ativo.

- **Erro interno**: Falha do nosso lado. Por segurança, o detalhe não é exposto. Se repetir, fale com o suporte dizendo a tool e o horário.