Guide d'installation

Brancher Plumail sur ChatGPT

ChatGPT lit les serveurs MCP comme connecteurs. Le serveur de Plumail est hébergé : il n'y a rien à faire tourner chez vous.

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 connecteur
Dans ChatGPT : Réglages → Connecteurs → Ajouter. Renseignez l'adresse du serveur et l'en-tête d'authentification. Le mode développeur doit être activé pour ajouter un connecteur personnalisé.
```
Adresse   : https://plumail.fr/api/mcp
Transport : HTTP (Streamable HTTP)
En-tête   : Authorization: Bearer VOTRE_CLÉ
```
03
Ou, pour les outils à fichier de configuration
Cursor, Codex, Claude Desktop, Windsurf et la plupart des autres lisent la même fiche. Collez-la dans leur fichier de configuration MCP.
```
{
  "mcpServers": {
    "plumail": {
      "type": "http",
      "url": "https://plumail.fr/api/mcp",
      "headers": {
        "Authorization": "Bearer VOTRE_CLÉ"
      }
    }
  }
}
```
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 conversation : « 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.

Le connecteur reste « en attente » ou ne répond pas	Le transport doit être HTTP, pas SSE : ce serveur ne tient pas de flux ouvert. Un GET sur l'adresse répond 405, ce qui est normal — les requêtes se font en POST.
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.