Serveur MCP Emailit

Le serveur MCP Emailit connecte les assistants IA à votre compte Emailit via le Model Context Protocol. Demandez en langage courant d’envoyer un e-mail, d’ajouter et de vérifier un domaine, de comprendre pourquoi un message a rebondi, de constituer une liste de contacts ou de lancer une campagne : l’assistant appelle l’outil Emailit correspondant.

Emailit héberge le serveur. Il n’y a rien à installer ni aucune clé API à coller : vous vous connectez à Emailit dans votre navigateur, choisissez les espaces de travail que l’assistant peut utiliser et approuvez l’accès.

Connecter votre outil d’IA

Pour tout autre client MCP, ajoutez un serveur distant (Streamable HTTP) avec l’URL https://api.emailit.com/mcp. Les clients qui prennent en charge l’autorisation MCP trouvent automatiquement la connexion à partir de l’URL de découverte ci-dessus : l’URL leur suffit.

Les plugins Emailit pour ChatGPT, Codex, Claude Code, Cursor et Grok ajoutent des skills au serveur : des consignes qui apprennent à l’assistant à configurer des domaines, corriger des problèmes de délivrabilité, lancer des campagnes, vérifier des webhooks et choisir un SDK.

Ce qui se passe à la connexion

1. Connectez-vous. Votre outil d’IA ouvre une page de connexion Emailit. Saisissez votre adresse e-mail et votre mot de passe, ainsi que le code de votre application d’authentification si vous utilisez l’authentification à deux facteurs.

2. Choisissez les espaces de travail. Choisissez All my workspaces, qui inclut ceux que vous créerez ou rejoindrez plus tard, ou Only these workspaces avec ceux que vous cochez. Si vous en autorisez plusieurs, choisissez celui dans lequel l’outil démarre.

3. Autorisez l’accès. Vérifiez l’accès demandé par l’outil (sending ou full) et sélectionnez Allow access.

L’outil reçoit un jeton d’accès valable 15 minutes et un jeton d’actualisation qui le garde connecté jusqu’à 60 jours d’inactivité. Les jetons d’actualisation changent à chaque utilisation, et la réutilisation d’un ancien jeton révoque la connexion. Chaque connexion apparaît sous Account›Connected apps.

Plusieurs espaces de travail

Une connexion couvre tous les espaces de travail que vous avez autorisés : vous pouvez donc gérer plusieurs marques ou comptes clients depuis la même conversation. Nommez l’espace de travail dans votre demande :

« Dans Acme Client, listez les domaines. »

L’assistant transmet workspace: "Acme Client" à cet appel d’outil uniquement. Il accepte un ID d’espace de travail ou le nom exact de l’espace de travail, et ne modifie pas l’espace de travail par défaut de la connexion : deux conversations qui travaillent en même temps dans des espaces de travail différents ne se gênent donc pas.

• « Quels espaces de travail Emailit pouvez-vous utiliser ? » liste les espaces de travail autorisés et votre rôle dans chacun.
• « Passez à mon espace de travail Marketing » modifie l’espace de travail par défaut pour les demandes suivantes qui n’en nomment pas.
• Pour ajouter ou retirer des espaces de travail, ouvrez Account›Connected apps et choisissez Edit access. Les modifications s’appliquent à la requête suivante de l’application, sans reconnexion.
• Si vous quittez un espace de travail ou si quelqu’un vous en retire, l’application perd aussi l’accès à cet espace de travail.

L’outil agit avec votre rôle dans chaque espace de travail, comme dans le tableau de bord : les membres ayant le rôle Member ne peuvent pas gérer les clés API ni supprimer de domaines. Consultez Espaces de travail et droits d’accès.

Niveaux d’accès

La plupart des outils d’IA demandent les deux portées. Si une connexion sans full appelle un outil qui en a besoin, l’outil renvoie une erreur qui vous demande de vous reconnecter avec un accès complet. Les clients qui prennent en charge l’autorisation renforcée (step-up), comme ChatGPT, affichent de nouveau l’écran d’autorisation.

Réduire la liste des outils

Certains clients limitent le nombre d’outils qu’ils chargent. Ajoutez ces options à l’URL du serveur, ou envoyez-les sous forme d’en-têtes, pour exposer moins d’outils :

Par exemple, https://api.emailit.com/mcp?toolsets=emails,domains&read_only=true donne à l’assistant un accès en lecture seule aux e-mails et aux domaines uniquement. Les outils d’espace de travail sont toujours inclus. Pour la liste complète, consultez Groupes d’outils et mode lecture seule.

Utiliser plutôt une clé API

Les serveurs, les scripts, les jobs de CI et les agents sans interface ne peuvent pas ouvrir de navigateur pour se connecter. Créez une clé API et envoyez-la comme jeton bearer :

{
  "mcpServers": {
    "emailit": {
      "url": "https://api.emailit.com/mcp",
      "headers": {
        "Authorization": "Bearer your_api_key"
      }
    }
  }
}

Une clé API est liée à l’espace de travail dans lequel elle a été créée et ne peut pas accéder aux autres espaces de travail, et le serveur ne liste que les outils autorisés par la portée de la clé. Préférez OAuth dans les applications de bureau et de chat, car une clé enregistrée dans un fichier de configuration peut fuiter.

Déconnecter une application

Ouvrez Account›Connected apps. La page liste chaque outil d’IA et chaque application que vous avez approuvés, avec les espaces de travail qu’ils peuvent utiliser, leur niveau d’accès et leur date de connexion. Choisissez Edit access pour modifier les espaces de travail d’une application, ou Revoke access pour lui couper l’accès : ses jetons cessent immédiatement de fonctionner. Consultez Applications connectées.

Sécurité

• Outils annotés. Chaque outil porte des annotations MCP (read-only, destructive, open-world) : les clients peuvent ainsi demander confirmation avant toute action qui écrit, supprime ou atteint le monde extérieur.
• Instructions intégrées. Le serveur demande aux assistants de confirmer les destinataires, l’expéditeur et le contenu avant d’envoyer de vrais e-mails, de rechercher les ID plutôt que de les deviner, et de demander confirmation avant de supprimer ou d’annuler quoi que ce soit.
• Contenu non fiable. Les corps d’e-mails, les champs de contact et les réponses aux formulaires peuvent contenir du texte écrit par d’autres personnes. Vérifiez ce que l’assistant prévoit de faire avant d’approuver un envoi ou une suppression.
• Contrôles réseau. Les URL de webhook sont contrôlées pour que les requêtes ne puissent pas atteindre des réseaux privés.
• Votre rôle s’applique. Les assistants ne peuvent jamais faire plus que vous dans chaque espace de travail.
• Les clés restent hors du code. Ne commitez jamais de clés API ; la règle Cursor du plugin Emailit en avertit l’agent.

Étapes suivantes