Exécuter le serveur MCP en local

@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é ; cette page explique quand le paquet local est pertinent et comment le configurer.

• Paquet : @emailit/emailit-mcp sur npm
• Source : github.com/emailit/emailit-mcp, licence MIT
• Environnement d’exécution : Node.js 18 ou version ultérieure

Local ou hébergé

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 18 ou version ultérieure, pour disposer de npx.
• Une clé API. 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é 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 mcp add emailit \
  -e EMAILIT_API_KEY=secret_•••••••• \
  -e SENDER_EMAIL_ADDRESS=hello@acme.com \
  -- npx -y @emailit/emailit-mcp

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

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

{
  "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

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.

Exécuter en HTTP

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

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 :

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

Exécuter depuis les sources

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

Voir aussi