# Plugins et skills Emailit

> Le plugin Emailit officiel pour ChatGPT, Codex, Claude Code, Cursor et Grok regroupe le serveur MCP hébergé, des skills et une règle qui garde les secrets hors du code.

Le plugin Emailit rassemble tout ce dont un assistant IA a besoin pour travailler avec Emailit : une connexion au [serveur MCP hébergé](/fr/docs/mcp/), des skills qui apprennent à l’assistant comment fonctionne Emailit, et une règle Cursor pour manipuler les secrets en toute sécurité. Il est open source sur [github.com/emailit/emailit-plugins](https://github.com/emailit/emailit-plugins) (MIT).

Vous vous connectez avec votre compte Emailit via OAuth et choisissez les espaces de travail que le plugin peut utiliser : tous, ou seulement ceux que vous sélectionnez. Aucune clé API n’est stockée dans le plugin.

## Contenu

| Élément | Rôle |
| --- | --- |
| Serveur MCP | `https://api.emailit.com/mcp` avec 109 outils couvrant les e-mails, les domaines, DMARC, les modèles, les listes de contacts, les contacts, les adresses bloquées, les campagnes, les automatisations, les formulaires, la vérification, les webhooks, les événements, les clés API et les espaces de travail |
| Skill `emailit` | Choix entre les outils MCP et l’API REST, envoi sécurisé, ID, pagination, erreurs et liste complète des outils |
| Skill `emailit-get-started` | Se connecter, confirmer l’espace de travail, vérifier un domaine et envoyer un premier e-mail de test |
| Skill `emailit-domain-setup` | Ajouter un domaine, publier les enregistrements DNS chez n’importe quel fournisseur, vérifier et corriger les enregistrements en échec |
| Skill `emailit-deliverability` | Rebonds, arrivée dans les spams, adresses bloquées, rapports DMARC et vérification de listes, avec des réponses fondées sur les données de votre compte |
| Skill `emailit-campaigns` | Listes de contacts, contacts, campagnes, automatisations et formulaires d’inscription, avec envoi sécurisé |
| Skill `emailit-webhooks` | Événements, filtres, vérification des signatures, payloads par lots, nouvelles tentatives et débogage |
| Skill `emailit-sdk` | Code de production pour les SDK Node.js, Python, PHP, Laravel, Go, Ruby, Java, .NET et Rust, ainsi que pour le SMTP |
| Règle Cursor | Garde les clés API Emailit (`secret_…`) et les secrets de webhook (`whsec_…`) hors du code source et les lit depuis `EMAILIT_API_KEY` et `EMAILIT_WEBHOOK_SECRET` |

Les skills se chargent à la demande : l’assistant lit une skill quand votre demande y correspond. Par exemple, « pourquoi mon e-mail a-t-il rebondi ? » charge `emailit-deliverability`.

## Installer

**ChatGPT**

  Ouvrez **Plugins**, recherchez **Emailit** et choisissez **Connect**. Connectez-vous, choisissez les espaces de travail à autoriser et approuvez l’accès. Consultez [ChatGPT](/fr/docs/mcp/chatgpt/).

**Codex**

```bash
codex plugin marketplace add emailit/emailit-plugins
```

  Ouvrez `/plugins`, installez **Emailit** et connectez-vous lorsque vous y êtes invité. Consultez [Codex](/fr/docs/mcp/codex/).

**Claude Code**

```bash
claude plugin marketplace add emailit/emailit-plugins
claude plugin install emailit@emailit-plugins
```

  Exécutez `/mcp`, sélectionnez **emailit** et choisissez **Authenticate**. Sur claude.ai, Claude Desktop et mobile, utilisez plutôt le connecteur Emailit. Consultez [Claude](/fr/docs/mcp/claude/).

**Cursor**

  Installez **Emailit** depuis le Cursor Marketplace ou avec `/add-plugin emailit`, puis choisissez **Connect** à côté de **emailit** dans **Settings > MCP**. Consultez [Cursor](/fr/docs/mcp/cursor/).

**Grok**

```bash
grok plugin marketplace add emailit/emailit-plugins
grok plugin install emailit --trust
```

  Sur grok.com, ajoutez un connecteur personnalisé avec `https://api.emailit.com/mcp`. Consultez [Grok](/fr/docs/mcp/grok/).

## Accès et sécurité

- **OAuth 2.1 avec PKCE.** L’assistant ne voit jamais votre mot de passe. Vous approuvez l’accès `sending` (envoyer et gérer les e-mails envoyés) ou l’accès `full` (tout), et choisissez les espaces de travail.
- **Confirmation avant toute action à impact.** Les outils qui envoient des e-mails, suppriment des données ou appellent des URL externes sont annotés pour que le client vous demande d’abord confirmation, et les skills demandent à l’assistant de confirmer.
- **Révocation à tout moment** sous **Account → Connected apps**.
- **Les clients sans interface**, comme l’API xAI et les jobs de CI, peuvent envoyer une clé API Emailit sous la forme `Authorization: Bearer <key>` au même serveur. Utilisez une clé Sending Only quand c’est possible.

## Endpoints utilisés par le plugin

Le plugin ne communique qu’avec Emailit :

| Endpoint | Rôle |
| --- | --- |
| `https://api.emailit.com/mcp` | Serveur MCP hébergé (Streamable HTTP) |
| `https://api.emailit.com/.well-known/oauth-protected-resource/mcp` | Métadonnées de ressource protégée OAuth |
| `https://api.emailit.com/.well-known/oauth-authorization-server` | Métadonnées du serveur d’autorisation OAuth |
| `https://api.emailit.com/oauth/register` | Enregistrement dynamique de client |
| `https://api.emailit.com/oauth/authorize` | Connexion et consentement |
| `https://api.emailit.com/oauth/token` | Échange et actualisation des jetons |
| `https://api.emailit.com/oauth/revoke` | Révocation des jetons |
| `https://api.emailit.com/v2` | API REST, utilisée par le code que la skill SDK écrit dans votre projet |
| `smtp.emailit.com:587` | SMTP, uniquement si votre projet est configuré pour l’utiliser |

## Manifestes

Le dépôt fournit un manifeste par client :

| Fichier | Lu par |
| --- | --- |
| `plugin.json`, `mcp.json` | ChatGPT, Codex et les autres clients Agent Plugins |
| `.cursor-plugin/` | Cursor |
| `.claude-plugin/`, `.mcp.json` | Claude Code, l’annuaire Claude et Grok |
| `.grok-plugin/plugin.json` | Grok |
| `.agents/plugins/marketplace.json` | La marketplace Codex |

La référence des outils des skills est générée à partir du catalogue d’outils du serveur MCP, la même source que la [référence des outils](/fr/docs/mcp/tools/) de cette documentation : les noms d’outils cités dans les skills existent donc toujours sur le serveur.

---
Source: https://emailit.com/fr/docs/mcp/plugins-and-skills/
