Apps de IA (MCP)

Erros e limites

Como fica uma tool que falhou, o que significa cada erro de conexão e os limites dentro dos quais todo app de IA trabalha.

Erros de tool

Quando um comando falha (domínio não encontrado, sem créditos, endereço inválido…), a tool retorna um resultado normal com isError: true. O texto é CODE: message, com os mesmos códigos da API, para que o app possa corrigir os argumentos e tentar de novo.

Resultado
{
  "content": [{ "type": "text", "text": "DOMAIN_NOT_FOUND: Domain not found or does not belong to this account." }],
  "structuredContent": { "code": "DOMAIN_NOT_FOUND", "message": "Domain not found or does not belong to this account." },
  "isError": true
}

Erros de conexão

StatusCódigoO que fazer
401MISSING_AUTH_HEADERSem token. Apps com OAuth iniciam o login a partir daqui; com uma key, envie Authorization: Bearer.
401INVALID_TOKENO access token expirou ou foi revogado. O app o renova sozinho ou pede para você conectar de novo.
401INVALID_API_KEYA key está errada, foi excluída ou expirou. Crie uma nova.
401WRONG_CREDENTIAL_TYPEUm token de caixa de email no servidor da conta (ou o contrário). Use a URL certa.
403ACCOUNT_BLOCKEDA conta está bloqueada. Fale com o suporte.
403IP_NOT_ALLOWEDA key está travada em outros IPs. Adicione o IP ou use OAuth.
429RATE_LIMITEDRequisições demais de uma vez. Espere os segundos do Retry-After e tente de novo.

Limites

Os mesmos rate limits da API

Cada conexão conta nos mesmos limites por key ou por caixa de email que as suas chamadas à API.

1 MB por chamada

Os argumentos são limitados a 1 MB por chamada, então anexos enviados por um app de IA precisam ser pequenos.

Créditos e limite diário

Cada email enviado usa seus créditos (um por destinatário) e conta para o seu limite diário.

Confirmação antes de agir

Tools que enviam email ou excluem dados são marcadas como destrutivas, então o app pergunta antes de executá-las.

O envio de email segue as mesmas regras da API de Envio de Email. Voltar para a visão geral do MCP.