Passez au contenu principal
Mailera

MCP

Utilisez Mailera dans VS Code

Ajoutez Mailera à .vscode/mcp.json pour que Copilot Chat en mode Agent accède à vos boîtes aux lettres. VS Code demande votre API key à la première utilisation et la stocke comme secret, sans l'inclure dans le fichier de configuration.

Documentation officielle de VS Code

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

  1. Créez .vscode/mcp.json dans votre espace de travail, ou exécutez MCP: Open User Configuration pour l'utiliser dans tous les espaces de travail.
  2. Collez la configuration ci-dessous. Au premier lancement, VS Code demande votre API key Mailera et la stocke comme secret.
  3. Ouvrez Chat en mode Agent et cliquez sur l'icône des outils: les outils de mailera doivent apparaître dans la liste.
.vscode/mcp.json
{  "inputs": [    {      "type": "promptString",      "id": "mailera-api-key",      "description": "Mailera API key",      "password": true    }  ],  "servers": {    "mailera": {      "type": "http",      "url": "https://mailera.app/api/public/v1/mcp",      "headers": {        "Authorization": "Bearer ${input:mailera-api-key}"      }    }  }}

Le fichier ne contient aucune clé: vous pouvez donc le commiter pour toute l’équipe. Chaque personne saisit sa propre clé.

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 VS Code

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