# Serveur MCP Emailit

> Connectez ChatGPT, Claude, Cursor, Codex, Grok et d’autres outils d’IA à Emailit avec le serveur MCP hébergé, la connexion OAuth et toute l’API v2 sous forme d’outils.

Le serveur MCP Emailit connecte les assistants IA à votre compte Emailit via le [Model Context Protocol](https://modelcontextprotocol.io). 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.

| | |
| --- | --- |
| **URL du serveur** | `https://api.emailit.com/mcp` |
| **Transport** | Streamable HTTP (sans état, `POST`) |
| **Connexion** | OAuth 2.1 avec PKCE, ou une clé API comme jeton bearer |
| **Outils** | 109, couvrant toute l’API v2 |
| **Découverte** | `https://api.emailit.com/.well-known/oauth-protected-resource/mcp` |

## Connecter votre outil d’IA

| Client | Mode de connexion | Guide |
| --- | --- | --- |
| ChatGPT | Plugin Emailit | [ChatGPT](/fr/docs/mcp/chatgpt/) |
| Claude (claude.ai, Desktop et mobile) | Connecteur Emailit | [Claude](/fr/docs/mcp/claude/) |
| Claude Code | Plugin Emailit ou `claude mcp add` | [Claude Code](/fr/docs/mcp/claude/#claude-code) |
| Cursor | Plugin Emailit ou **Add to Cursor** | [Cursor](/fr/docs/mcp/cursor/) |
| Codex | Plugin Emailit ou `codex mcp add` | [Codex](/fr/docs/mcp/codex/) |
| Grok | Connecteur grok.com, plugin Grok Build ou API xAI | [Grok](/fr/docs/mcp/grok/) |
| VS Code, Windsurf, Zed et autres | URL de serveur MCP distant | [Autres clients](/fr/docs/mcp/other-clients/) |

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](/fr/docs/mcp/plugins-and-skills/) 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](/fr/docs/mcp/workspaces-and-permissions/).

## Niveaux d’accès

| Portée | Ce que l’outil peut faire |
| --- | --- |
| `sending` | Envoyer, programmer, reprogrammer, annuler, relancer et transférer des e-mails. Consulter l’espace de travail actif et en changer. |
| `full` | Tout ce que permet l’API v2 : domaines, rapports DMARC, modèles, clés API, listes de contacts, contacts, adresses bloquées, webhooks, campagnes, automatisations, formulaires, vérification d’e-mails, événements et création d’espaces de travail. |

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 :

| Option | Chaîne de requête | En-tête | Exemple |
| --- | --- | --- | --- |
| Seulement certains groupes d’outils | `?toolsets=` | `X-MCP-Toolsets` | `emails,domains,events` |
| Masquer les outils d’écriture | `?read_only=true` | `X-MCP-Readonly` | `true` |

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](/fr/docs/mcp/toolsets/).

## 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](/fr/docs/developers/api-keys/) et envoyez-la comme jeton bearer :

```json title="mcp.json"
{
  "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](/fr/docs/account/connected-apps/).

> **Attention:** Retirer le serveur de votre outil d’IA ne révoque pas son accès dans Emailit. Utilisez pour cela **Connected apps**.

## 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

  - [Référence des outils](/fr/docs/mcp/tools/): Tous les outils avec leur type, leur portée et leurs arguments.
  - [Plugins et skills](/fr/docs/mcp/plugins-and-skills/): Ce que les plugins Emailit ajoutent pour chaque client.
  - [Espaces de travail et droits d’accès](/fr/docs/mcp/workspaces-and-permissions/): Accès aux espaces de travail, rôles, portées et jetons.
  - [Dépannage](/fr/docs/mcp/troubleshooting/): Corrigez les problèmes de connexion, de portée, d’espace de travail et de chargement des outils.

---
Source: https://emailit.com/fr/docs/mcp/