# Exécuter le serveur MCP en local

> Exécutez le paquet open source @emailit/emailit-mcp via stdio ou en HTTP local avec une clé API, et configurez Claude, Cursor et VS Code pour l’utiliser.

`@emailit/emailit-mcp` est la version open source du serveur MCP Emailit. Il s’exécute sur votre machine, communique avec l’API Emailit à l’aide de votre clé API et fonctionne avec les clients qui ne prennent en charge que les serveurs locaux (stdio). La plupart des utilisateurs devraient plutôt utiliser le [serveur hébergé](/fr/docs/mcp/) ; cette page explique quand le paquet local est pertinent et comment le configurer.

- **Paquet :** [`@emailit/emailit-mcp`](https://www.npmjs.com/package/@emailit/emailit-mcp) sur npm
- **Source :** [github.com/emailit/emailit-mcp](https://github.com/emailit/emailit-mcp), licence MIT
- **Environnement d’exécution :** Node.js 18 ou version ultérieure

## Local ou hébergé

| | Paquet local | Serveur hébergé |
| --- | --- | --- |
| Exécution | Sur votre machine, démarré par votre client MCP | À l’adresse `https://api.emailit.com/mcp` |
| Connexion | Clé API uniquement | OAuth ou clé API |
| Outils | L’ensemble d’origine : e-mails, domaines, clés API, listes de contacts, contacts, modèles, adresses bloquées et webhooks | 109, toute l’API v2, y compris les campagnes, les automatisations, les formulaires, DMARC, la vérification et les événements |
| Espaces de travail | L’espace de travail de la clé API | Plusieurs espaces de travail par connexion avec OAuth, choisis à chaque requête |
| Rôles et portées | La portée de la clé API | Votre rôle dans chaque espace de travail et la portée approuvée |
| Expéditeur et adresse de réponse par défaut | Configurables | Non disponibles ; l’assistant transmet `from` à chaque envoi |
| Mises à jour | Vous contrôlez la version exécutée | Automatiques |

Choisissez le paquet local si :

- votre client ne prend en charge que les serveurs stdio, ou ne gère pas OAuth pour les serveurs distants,
- vous voulez appliquer une adresse d’expéditeur (From) et une adresse de réponse (Reply-To) par défaut à chaque envoi, ou
- vous voulez lire, figer ou modifier le code du serveur.

## Avant de commencer

- [Node.js](https://nodejs.org) 18 ou version ultérieure, pour disposer de `npx`.
- Une [clé API](/fr/docs/developers/api-keys/). Utilisez une clé Sending Only limitée à un domaine si l’assistant n’a besoin que d’envoyer ; les autres outils nécessitent une clé Full Access.
- Un [domaine d’envoi vérifié](/fr/docs/domains/add-a-domain/) pour l’adresse d’expéditeur.

## Configurer votre client

Le client démarre le serveur comme sous-processus et communique avec lui via stdio. Transmettez la clé API dans la variable d’environnement `EMAILIT_API_KEY`.

**Claude Code**

```bash
claude mcp add emailit \
  -e EMAILIT_API_KEY=secret_•••••••• \
  -e SENDER_EMAIL_ADDRESS=hello@acme.com \
  -- npx -y @emailit/emailit-mcp
```

**Claude Desktop**

  Ouvrez **Settings > Developer > Edit Config** et ajoutez le serveur à `claude_desktop_config.json`, puis redémarrez Claude Desktop :

```json title="claude_desktop_config.json"
{
  "mcpServers": {
    "emailit": {
      "command": "npx",
      "args": ["-y", "@emailit/emailit-mcp"],
      "env": {
        "EMAILIT_API_KEY": "secret_••••••••",
        "SENDER_EMAIL_ADDRESS": "hello@acme.com"
      }
    }
  }
}
```

**Cursor**

  Ajoutez le serveur à `~/.cursor/mcp.json` ou au fichier `.cursor/mcp.json` d’un projet :

```json title="~/.cursor/mcp.json"
{
  "mcpServers": {
    "emailit": {
      "command": "npx",
      "args": ["-y", "@emailit/emailit-mcp"],
      "env": {
        "EMAILIT_API_KEY": "secret_••••••••",
        "SENDER_EMAIL_ADDRESS": "hello@acme.com"
      }
    }
  }
}
```

**VS Code**

  Ajoutez le serveur à `.vscode/mcp.json`. VS Code vous demande la clé et la stocke de façon sécurisée :

```json title=".vscode/mcp.json"
{
  "inputs": [
    { "type": "promptString", "id": "emailit-api-key", "description": "Emailit API key", "password": true }
  ],
  "servers": {
    "emailit": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@emailit/emailit-mcp"],
      "env": {
        "EMAILIT_API_KEY": "${input:emailit-api-key}",
        "SENDER_EMAIL_ADDRESS": "hello@acme.com"
      }
    }
  }
}
```

Utilisez toujours le nom de paquet complet, avec son espace de noms : `@emailit/emailit-mcp`.

## Variables d’environnement

| Variable | Obligatoire | Description |
| --- | --- | --- |
| `EMAILIT_API_KEY` | Pour stdio | Votre clé API Emailit. En mode HTTP, les clients envoient leur propre clé à la place. |
| `SENDER_EMAIL_ADDRESS` | Non | Adresse d’expéditeur par défaut, sur un domaine d’envoi vérifié. |
| `REPLY_TO_EMAIL_ADDRESSES` | Non | Adresses de réponse par défaut, séparées par des virgules. |
| `MCP_PORT` | Non | Port du mode HTTP. Par défaut : `3000`. |

Si vous ne définissez pas d’expéditeur, le serveur demande à l’assistant une adresse d’expéditeur à chaque envoi.

## Options de ligne de commande

Les options remplacent les variables d’environnement correspondantes.

| Option | Description |
| --- | --- |
| `--key <key>` | Clé API pour le mode stdio. |
| `--sender ` | Adresse d’expéditeur par défaut. |
| `--reply-to ` | Adresse de réponse par défaut. Répétez l’option pour indiquer plusieurs adresses. |
| `--http` | Utilise Streamable HTTP au lieu de stdio. |
| `--port ` | Port pour `--http`. Par défaut : `3000` ou `MCP_PORT`. |
| `-h`, `--help` | Affiche l’aide. |

## Exécuter en HTTP

Pour partager un même serveur local entre plusieurs clients, démarrez-le en mode HTTP :

```bash
npx -y @emailit/emailit-mcp --http --port 3000
```

Le serveur écoute sur `http://127.0.0.1:3000/mcp` et n’est accessible que depuis votre machine. Chaque client s’authentifie avec sa propre clé API comme jeton bearer :

```bash
claude mcp add emailit --transport http http://127.0.0.1:3000/mcp \
  --header "Authorization: Bearer $EMAILIT_API_KEY"
```

## Exécuter depuis les sources

```bash
git clone https://github.com/emailit/emailit-mcp.git
cd emailit-mcp
npm install
EMAILIT_API_KEY=secret_•••••••• node src/index.js
```

Ajoutez `--http --port 3000` à la dernière commande pour le mode HTTP.

## Dépannage

| Problème | Solution |
| --- | --- |
| `API key is required for stdio mode. Use --key or set EMAILIT_API_KEY.` | Ajoutez `EMAILIT_API_KEY` au bloc `env` de la configuration de votre client. |
| Le client ne parvient pas à démarrer `npx` | Les applications de bureau ne voient pas toujours le `PATH` de votre shell. Utilisez le chemin complet de `npx` (trouvez-le avec `which npx`) comme `command`. |
| `Domain not verified` à l’envoi | Utilisez un expéditeur sur un [domaine vérifié](/fr/docs/domains/verification/), ou définissez `SENDER_EMAIL_ADDRESS` sur une telle adresse. |
| Erreurs de droits sur les outils autres que l’envoi | La clé est Sending Only. Utilisez une clé Full Access pour les domaines, les modèles, les contacts et les autres outils. |
| Impossible d’annuler un e-mail programmé | Les e-mails programmés ne peuvent être annulés ou reprogrammés que jusqu’à 3 minutes avant leur heure d’envoi. |

## Voir aussi

  - [Vue d’ensemble du serveur MCP](/fr/docs/mcp/): Hébergé ou local, portées et sécurité.
  - [Référence des outils](/fr/docs/mcp/tools/): Tous les outils hébergés et leurs arguments.
  - [Clés API](/fr/docs/developers/api-keys/): Créez une clé pour le serveur.
  - [Autres clients](/fr/docs/mcp/other-clients/): Connectez des éditeurs au serveur hébergé.

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