Guide d'installation

Brancher Plumail sur Claude Code

Plumail expose un serveur MCP hébergé. Rien à installer, rien à faire tourner : une commande, et la session connaît votre espace.

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.
02
Ajouter le serveur MCP
Dans votre terminal, en remplaçant VOTRE_CLÉ par la clé copiée à l'étape précédente. Ajoutez --scope user pour que le branchement vaille dans tous vos projets, et non seulement le dossier courant.
```
claude mcp add plumail \
  --transport http \
  --url https://plumail.fr/api/mcp \
  --header "Authorization: Bearer VOTRE_CLÉ"
```
03
Contrôler que Claude Code le voit
La commande liste les serveurs branchés et leur état de connexion. « plumail » doit y apparaître comme connecté.
```
claude mcp list
```
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 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.

« plumail » apparaît en « failed » dans claude mcp list	L'en-tête Authorization est mal formé. Il doit contenir le mot Bearer, une espace, puis la clé : « Authorization: Bearer plm_live_… ». Les guillemets autour de la valeur sont obligatoires.
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.