# Voici le serveur MCP d’Emailit

> Connectez Claude, Cursor et d’autres assistants IA directement à Emailit. Envoyez des e-mails, gérez contacts, domaines, modèles et bien plus, en langage naturel.

2026-05-19 · George (https://x.com/thegeorge, https://www.linkedin.com/in/jiri-zizka/)

Nous lançons le **serveur MCP d’Emailit** (Emailit MCP Server), un serveur [Model Context Protocol](https://modelcontextprotocol.io/) open source qui donne aux assistants IA comme Claude, Cursor et à tout autre client compatible MCP un accès complet à la plateforme Emailit. Envoyez des e-mails, gérez vos contacts, configurez vos domaines, créez des modèles, le tout en langage naturel.

## Ce que cela change

Au lieu de jongler entre votre assistant IA et le tableau de bord Emailit, vous pouvez désormais tout faire depuis une seule conversation :

- **« Envoie un e-mail de bienvenue à **[**sarah@example.com**](mailto:sarah@example.com)** avec le modèle d’onboarding »** : l’IA choisit le bon modèle, remplit les variables et envoie l’e-mail.
- **« Montre-moi tous les e-mails qui ont rebondi cette semaine »** : listez et inspectez vos e-mails sans quitter votre éditeur.
- **« Ajoute mail.example.com comme domaine d’envoi et montre-moi les enregistrements DNS »** : l’IA crée le domaine et vous donne les enregistrements exacts à configurer.
- **« Programme un rappel à l’équipe pour demain à 9 h »** : le serveur accepte une programmation en langage naturel (en anglais), comme « tomorrow at 9am » ou « next Monday at 2pm ».

Le serveur MCP expose **47 outils** répartis en 8 catégories : e-mails, domaines, clés API, listes de contacts, contacts, modèles, adresses bloquées et webhooks. Il couvre l’ensemble de l’API Emailit.

## Comment ça marche

Le [Model Context Protocol](https://modelcontextprotocol.io/) est un standard ouvert qui permet aux assistants IA de se connecter à des services externes via une interface d’outils structurée. Le serveur MCP d’Emailit implémente ce protocole : tout client compatible peut donc découvrir et appeler automatiquement les opérations d’Emailit.

Deux modes de connexion sont possibles :

1. **Stdio** : le client lance le serveur comme sous-processus et communique via stdin/stdout. C’est la configuration la plus simple ; elle fonctionne avec Claude Code, Cursor et Claude Desktop.
2. **HTTP** : le serveur tourne comme service HTTP autonome, avec le transport Streamable HTTP. Pratique pour les configurations distantes, les environnements partagés ou les clients web.

## Premiers pas

Il vous suffit d’un compte Emailit, d’une clé API et de Node.js 18 ou supérieur.

### Claude Code

```bash
claude mcp add emailit -e EMAILIT_API_KEY=your_api_key -- npx -y @emailit/emailit-mcp
```

### Cursor

Ouvrez **Cursor Settings → MCP → Add new global MCP server** et collez :

```json
{
  "mcpServers": {
    "emailit": {
      "command": "npx",
      "args": ["-y", "@emailit/emailit-mcp"],
      "env": {
        "EMAILIT_API_KEY": "your_api_key"
      }
    }
  }
}
```

### Claude Desktop

Ouvrez **Settings → Developer → Edit Config** et collez le même bloc JSON que ci-dessus.

C’est tout. Une fois la connexion établie, l’IA découvre automatiquement les 47 outils et vous pouvez les utiliser immédiatement.

## Exemples

Voici quelques possibilités, prêtes à l’emploi :

### Envoyer des e-mails avec modèles et variables

> « Envoie le modèle welcome-email à [john@example.com](mailto:john@example.com), avec John comme prénom »

L’IA retrouve le modèle par son alias, remplace la variable `{{name}}` et envoie :

```json
{
  "template": "welcome-email",
  "to": "john@example.com",
  "variables": { "name": "John" }
}
```

### Joindre des fichiers depuis une URL

> « Envoie la facture mensuelle à [accounting@company.com](mailto:accounting@company.com) avec le PDF de notre bucket S3 »

```json
{
  "to": "accounting@company.com",
  "subject": "Monthly Invoice",
  "attachments": [
    {
      "filename": "invoice-2026-05.pdf",
      "url": "https://mybucket.s3.amazonaws.com/invoices/2026-05.pdf"
    }
  ]
}
```

### Gérer toute votre infrastructure d’envoi

> « Crée une nouvelle liste appelée “Beta Users”, ajoutes-y [jane@example.com](mailto:jane@example.com), puis crée un webhook qui m’envoie les événements de livraison »

L’IA enchaîne plusieurs outils, `create-audience`, `create-contact` et `create-webhook`, dans une seule conversation.

### Bloquer et débloquer des adresses

> « Bloque [bounced@example.com](mailto:bounced@example.com) à cause de trop nombreux rebonds définitifs, avec une expiration dans 30 jours »

```json
{
  "email": "bounced@example.com",
  "type": "bounce",
  "reason": "too many hard bounces",
  "keep_until": "2026-06-18T00:00:00Z"
}
```

## Conseils

- **Définissez un expéditeur par défaut.** Passez `--sender you@yourdomain.com` ou définissez la variable d’environnement `SENDER_EMAIL_ADDRESS` pour que l’IA ne vous demande pas une adresse d’expéditeur à chaque fois.
- **Utilisez des modèles pour les e-mails récurrents.** Créez des modèles avec des `{{variables}}` et appelez-les par leur alias : c’est plus rapide et plus cohérent que d’écrire du HTML dans le chat.
- **La programmation en langage naturel fonctionne.** Vous pouvez indiquer « tomorrow at 9am », « next Friday at noon » ou un horodatage ISO 8601 : le serveur gère les deux.
- **Les opérations destructives sont protégées.** Les outils de suppression demandent à l’IA de vous demander confirmation avant d’agir : vous ne supprimerez pas un domaine ou un contact par erreur.
- **Le mode HTTP pour les configurations partagées.** Si plusieurs membres de l’équipe ou plusieurs services ont besoin d’un accès, lancez le serveur en mode HTTP : chaque client s’authentifie avec sa propre clé API via un jeton Bearer.

## Open source

Le serveur MCP d’Emailit est sous licence MIT et disponible sur [GitHub](https://github.com/emailit/emailit-mcp). Il est écrit en JavaScript pur (ESM), sans étape de build, et ne dépend que de quatre paquets : `@modelcontextprotocol/sdk`, `fastify`, `minimist` et `zod`.

Contributions et retours sont les bienvenus : ouvrez une issue ou proposez une PR.

## Documentation complète

Nous avons publié un guide complet d’installation et de référence :

- [Guide du serveur MCP d’Emailit](https://emailit.com/docs/guides/emailit-mcp-server) : installation, configuration, les 47 outils, exemples d’utilisation et dépannage

## Pour commencer

Installez le serveur MCP en une seule commande :

```bash
npx -y @emailit/emailit-mcp
```

Lisez le [guide complet](https://emailit.com/docs/guides/emailit-mcp-server) ou consultez le [dépôt GitHub](https://github.com/emailit/emailit-mcp) pour démarrer.

---

Source: https://emailit.com/fr/blog/introduction-serveur-mcp-emailit/
