Guide d'installation

Brancher Mailcheer 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 Mailcheer : 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 à « mch_live_ » suivi de trente-deux caractères.
02
Par la ligne de commande
Codex lit la clé dans une variable d'environnement et l'envoie lui-même dans l'en-tête Authorization. En remplaçant VOTRE_CLÉ ; ajoutez la ligne export à votre fichier de profil pour qu'elle survive à la fermeture du terminal. La commande écrit elle-même dans ~/.codex/config.toml.
```
export MAILCHEER_API_KEY="VOTRE_CLÉ"
codex mcp add mailcheer \
  --url https://mailcheer.com/api/mcp \
  --bearer-token-env-var MAILCHEER_API_KEY
```
03
Ou à la main, dans ~/.codex/config.toml
La même chose, écrite dans le fichier de configuration. La variable d'environnement reste nécessaire : la clé n'est jamais écrite dans le fichier.
```
[mcp_servers.mailcheer]
url = "https://mailcheer.com/api/mcp"
bearer_token_env_var = "MAILCHEER_API_KEY"
```
04
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 Mailcheer 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.