Passez au contenu principal
Mailera

MCP

Utilisez Mailera dans Claude

Ajoutez le serveur MCP de Mailera à Claude Code en une commande ou à Claude Desktop via la passerelle mcp-remote. Claude peut lire, rechercher et répondre aux messages dans vos boîtes aux lettres connectées.

Documentation officielle de Claude

Avant de commencer

  1. Créez un espace de travail gratuit et connectez au moins une boîte aux lettres.
  2. Accédez à Paramètres → API key, créez une clé et choisissez les autorisations. L’autorisation read suffit pour commencer.
  3. Copiez la clé dès sa création: Mailera n’affiche la clé complète qu’une seule fois.

Configuration

Claude Code

  1. Ouvrez un terminal dans le dossier de votre projet et exécutez la commande ci-dessous en y insérant votre propre clé.
  2. Dans Claude Code, saisissez /mcp: mailera doit afficher un statut connecté et la liste de ses outils.

Remplacez mh_live_xxx par votre API key.

Terminal
claude mcp add --transport http mailera https://mailera.app/api/public/v1/mcp \  --header "Authorization: Bearer mh_live_xxx"

Claude Desktop

  1. Installez Node.js 18 ou une version ultérieure: la passerelle mcp-remote s'exécute via npx.
  2. Dans Claude Desktop, ouvrez Settings → Developer → Edit Config, collez le bloc mailera dans mcpServers, puis enregistrez.
  3. Quittez complètement Claude Desktop, puis rouvrez-le. Les outils de Mailera apparaissent sous le bouton des outils dans le volet de discussion.

Remplacez mh_live_xxx par votre API key.

claude_desktop_config.json
{  "mcpServers": {    "mailera": {      "command": "npx",      "args": [        "-y",        "mcp-remote",        "https://mailera.app/api/public/v1/mcp",        "--header",        "Authorization:${AUTH_HEADER}"      ],      "env": {        "AUTH_HEADER": "Bearer mh_live_xxx"      }    }  }}

Les connecteurs (custom connector) sur claude.ai et Claude Desktop ne fonctionnent pas encore avec Mailera: ils ne prennent en charge que les serveurs utilisant OAuth ou sans authentification, alors que Mailera utilise une API key.

Vérifiez la connexion

Demandez à l’agent: « Liste mes boîtes aux lettres Mailera ». L’agent appelle list_mailboxes et renvoie vos boîtes aux lettres avec leur état de synchronisation. Essayez ensuite: « Trouve le dernier e-mail de noreply@… et extrais l’OTP ».

Liste des outils et consignes de sécurité

Erreurs fréquentes

401 unauthorized
La clé est invalide, a été révoquée ou n’est pas précédée de Bearer. L’en-tête doit être Authorization: Bearer mh_live_…
send_email ou rescue_spam introuvable
La clé ne dispose pas des autorisations requises (send, move). Mailera n’affiche que les outils correspondant à ses autorisations. Créez une nouvelle clé avec les autorisations nécessaires.
L’agent ne trouve aucune boîte aux lettres
La clé est limitée à un groupe sans boîte aux lettres, ou aucune boîte aux lettres n’est connectée à l’espace de travail.
429 rate_limited
Cette clé a dépassé 300 requêtes par minute. Attendez le nombre de secondes indiqué dans Retry-After, puis réessayez.

Autres applications

Utilisez Mailera dans Claude

Accédez à Paramètres → API key, créez une clé et choisissez les autorisations. L’autorisation read suffit pour commencer.

Créez un espace de travail gratuit