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.

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
}

Errores de conexión

EstadoCódigoQué hacer
401MISSING_AUTH_HEADERSin token. Las apps con OAuth inician el login desde aquí; con una key, envía Authorization: Bearer.
401INVALID_TOKENEl access token expiró o fue revocado. La app lo renueva por su cuenta o te pide que vuelvas a conectar.
401INVALID_API_KEYLa key es incorrecta, se eliminó o expiró. Crea una nueva.
401WRONG_CREDENTIAL_TYPEUn token de buzón en el servidor de la cuenta (o al revés). Usa la URL correcta.
403ACCOUNT_BLOCKEDLa cuenta está bloqueada. Contacta con soporte.
403IP_NOT_ALLOWEDLa key está limitada a otras IP. Añade la IP o usa OAuth.
429RATE_LIMITEDDemasiadas 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.