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.
{
"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
| Status | Código | O que fazer |
|---|---|---|
| 401 | MISSING_AUTH_HEADER | Sem token. Apps com OAuth iniciam o login a partir daqui; com uma key, envie Authorization: Bearer. |
| 401 | INVALID_TOKEN | O access token expirou ou foi revogado. O app o renova sozinho ou pede para você conectar de novo. |
| 401 | INVALID_API_KEY | A key está errada, foi excluída ou expirou. Crie uma nova. |
| 401 | WRONG_CREDENTIAL_TYPE | Um token de caixa de email no servidor da conta (ou o contrário). Use a URL certa. |
| 403 | ACCOUNT_BLOCKED | A conta está bloqueada. Fale com o suporte. |
| 403 | IP_NOT_ALLOWED | A key está travada em outros IPs. Adicione o IP ou use OAuth. |
| 429 | RATE_LIMITED | Requisiçõ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.