Brancher Plumail sur Codex
Codex lit les serveurs MCP depuis son fichier de configuration, ou par sa ligne de commande.
Créer une clé d'API
Dans votre espace Plumail : Réglages → API → Nouvelle clé. Nommez-la, cochez les droits, validez. La clé s'affiche UNE seule fois — copiez-la tout de suite. Elle ressemble à « plm_live_ » suivi de trente-deux caractères.
Par la ligne de commande
En remplaçant VOTRE_CLÉ. C'est la voie la plus rapide, et elle écrit elle-même dans la configuration.
codex mcp add plumail \ --transport http \ --url https://plumail.fr/api/mcp \ --header "Authorization: Bearer VOTRE_CLÉ"Ou à la main, dans ~/.codex/config.toml
Si votre version de Codex ne connaît pas la sous-commande mcp, la même chose s'écrit dans le fichier de configuration.
[mcp_servers.plumail] url = "https://plumail.fr/api/mcp" [mcp_servers.plumail.headers] Authorization = "Bearer VOTRE_CLÉ"Vérifier que c'est branché
Demandez l'état du compte. C'est une lecture seule : rien n'est modifié, rien n'est envoyé. La réponse nomme votre espace et liste vos domaines d'envoi vérifiés — ce sont eux qui décident des adresses depuis lesquelles vous pourrez écrire.
Dans la session : « Quel espace Plumail vois-tu, et quels domaines d'envoi sont vérifiés ? »
Si quelque chose coince
Les erreurs de l'API portent toutes un code lisible. Voici ceux qu'on rencontre au branchement.
| 401 invalid_api_key | La clé est incomplète (un retour à la ligne s'est glissé au copier-coller) ou elle a été remplacée. Créez-en une neuve. |
|---|---|
| 401 revoked_api_key | La clé a été coupée dans Réglages → API. Créez-en une autre. |
| 403 insufficient_scope | La clé n'a pas le droit demandé. Les droits se choisissent à la création et ne se modifient plus : créez une clé avec le bon périmètre. |
| 422 unverified_from_domain | L'adresse d'expédition n'est pas sur un domaine vérifié de l'espace. Le message d'erreur liste ceux qui le sont. Pour en ajouter un : Domaines → Ajouter un domaine, puis poser les enregistrements DNS. |
| 429 rate_limit_exceeded | Plus de 600 requêtes par minute pour cette clé. L'en-tête Retry-After dit combien de secondes attendre. |