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.
{
"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
| Statut | Code | Que faire |
|---|---|---|
| 401 | MISSING_AUTH_HEADER | Pas de token. Les apps OAuth lancent la connexion à partir de là ; avec une key, envoyez Authorization: Bearer. |
| 401 | INVALID_TOKEN | L'access token a expiré ou a été révoqué. L'app le renouvelle toute seule ou vous demande de vous reconnecter. |
| 401 | INVALID_API_KEY | La key est erronée, supprimée ou expirée. Créez-en une nouvelle. |
| 401 | WRONG_CREDENTIAL_TYPE | Un token de boîte mail sur le serveur du compte (ou l'inverse). Utilisez la bonne URL. |
| 403 | ACCOUNT_BLOCKED | Le compte est bloqué. Contactez le support. |
| 403 | IP_NOT_ALLOWED | La key est limitée à d'autres IP. Ajoutez l'IP ou utilisez OAuth. |
| 429 | RATE_LIMITED | Trop 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.