Apps IA (MCP)

Erreurs et limites

À quoi ressemble un tool en échec, ce que signifie chaque erreur de connexion, et les limites dans lesquelles toute app IA fonctionne.

Erreurs de tool

Lorsqu'une commande échoue (domaine introuvable, plus de crédits, adresse invalide…), le tool renvoie un résultat normal avec isError: true. Le texte est CODE: message, avec les mêmes codes que l'API, pour que l'app puisse corriger les arguments et réessayer.

Résultat
{
  "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
}

Erreurs de connexion

StatutCodeQue faire
401MISSING_AUTH_HEADERPas de token. Les apps OAuth lancent la connexion à partir de là ; avec une key, envoyez Authorization: Bearer.
401INVALID_TOKENL'access token a expiré ou a été révoqué. L'app le renouvelle toute seule ou vous demande de vous reconnecter.
401INVALID_API_KEYLa key est erronée, supprimée ou expirée. Créez-en une nouvelle.
401WRONG_CREDENTIAL_TYPEUn token de boîte mail sur le serveur du compte (ou l'inverse). Utilisez la bonne URL.
403ACCOUNT_BLOCKEDLe compte est bloqué. Contactez le support.
403IP_NOT_ALLOWEDLa key est limitée à d'autres IP. Ajoutez l'IP ou utilisez OAuth.
429RATE_LIMITEDTrop de requêtes à la fois. Attendez le nombre de secondes indiqué par Retry-After et réessayez.

Limites

Mêmes rate limits que l'API

Chaque connexion est décomptée des mêmes limites par key ou par boîte mail que vos appels à l'API.

1 Mo par appel

Les arguments sont limités à 1 Mo par appel : les pièces jointes envoyées via une app IA doivent donc être petites.

Crédits et limite quotidienne

Chaque e-mail envoyé consomme vos crédits (un par destinataire) et compte dans votre limite quotidienne.

Confirmation avant d'agir

Les tools qui envoient des e-mails ou suppriment des données sont marqués comme destructifs : l'app vous demande donc avant de les exécuter.

L'envoi d'e-mails suit les mêmes règles que l'API Send Email. Retour à la vue d'ensemble MCP.