Apps de IA (MCP)
Errores y límites
Cómo se ve una tool que falló, qué significa cada error de conexión y los límites dentro de los que trabaja toda app de IA.
Errores de tool
Cuando un comando falla (dominio no encontrado, sin créditos, dirección no válida…), la tool devuelve un resultado normal con isError: true. El texto es CODE: message, con los mismos códigos que la API, para que la app pueda corregir los argumentos y volver a intentarlo.
{
"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
}Errores de conexión
| Estado | Código | Qué hacer |
|---|---|---|
| 401 | MISSING_AUTH_HEADER | Sin token. Las apps con OAuth inician el login desde aquí; con una key, envía Authorization: Bearer. |
| 401 | INVALID_TOKEN | El access token expiró o fue revocado. La app lo renueva por su cuenta o te pide que vuelvas a conectar. |
| 401 | INVALID_API_KEY | La key es incorrecta, se eliminó o expiró. Crea una nueva. |
| 401 | WRONG_CREDENTIAL_TYPE | Un token de buzón en el servidor de la cuenta (o al revés). Usa la URL correcta. |
| 403 | ACCOUNT_BLOCKED | La cuenta está bloqueada. Contacta con soporte. |
| 403 | IP_NOT_ALLOWED | La key está limitada a otras IP. Añade la IP o usa OAuth. |
| 429 | RATE_LIMITED | Demasiadas solicitudes a la vez. Espera los segundos de Retry-After y vuelve a intentarlo. |
Límites
Los mismos rate limits que la API
Cada conexión cuenta en los mismos límites por key o por buzón que tus llamadas a la API.
1 MB por llamada
Los argumentos están limitados a 1 MB por llamada, así que los adjuntos enviados desde una app de IA deben ser pequeños.
Créditos y límite diario
Cada email enviado usa tus créditos (uno por destinatario) y cuenta para tu límite diario.
Confirmación antes de actuar
Las tools que envían email o eliminan datos están marcadas como destructivas, así que la app te pregunta antes de ejecutarlas.
El envío de email sigue las mismas reglas que la API de Envío de Email. Volver a la descripción general de MCP.