Anleitung
MCP-Server lokal ausführen
Führen Sie das Open-Source-Paket @emailit/emailit-mcp per stdio oder lokalem HTTP mit einem API-Schlüssel aus und konfigurieren Sie Claude, Cursor und VS Code dafür.
@emailit/emailit-mcp ist die Open-Source-Version des Emailit-MCP-Servers. Sie läuft auf Ihrem Rechner, kommuniziert mit Ihrem API-Schlüssel mit der Emailit-API und funktioniert mit Clients, die nur lokale Server (stdio) unterstützen. Für die meisten ist stattdessen der gehostete Server die richtige Wahl; diese Seite erklärt, wann das lokale Paket sinnvoll ist und wie Sie es konfigurieren.
- Paket:
@emailit/emailit-mcpauf npm - Quellcode: github.com/emailit/emailit-mcp, MIT-Lizenz
- Runtime: Node.js 18 oder neuer
Lokal oder gehostet
| Lokales Paket | Gehosteter Server | |
|---|---|---|
| Läuft | Auf Ihrem Rechner, gestartet von Ihrem MCP-Client | Unter https://api.emailit.com/mcp |
| Anmeldung | Nur API-Schlüssel | OAuth oder API-Schlüssel |
| Tools | Der ursprüngliche Umfang: E-Mails, Domains, API-Schlüssel, Kontaktlisten, Kontakte, Vorlagen, Sperrungen und Webhooks | 109, die gesamte API v2, einschließlich Kampagnen, Automatisierungen, Formularen, DMARC, Verifizierung und Events |
| Workspaces | Der Workspace des API-Schlüssels | Mit OAuth mehrere Workspaces pro Verbindung, pro Anfrage gewählt |
| Rollen und Scopes | Der Scope des API-Schlüssels | Ihre Rolle im jeweiligen Workspace und der freigegebene Scope |
| Standard-Absender und Reply-To | Konfigurierbar | Nicht verfügbar; der Assistent übergibt from bei jedem Versand |
| Updates | Sie bestimmen, welche Version Sie ausführen | Automatisch |
Wählen Sie das lokale Paket, wenn:
- Ihr Client nur stdio-Server unterstützt oder bei Remote-Servern kein OAuth beherrscht,
- Sie eine Standard-Absenderadresse und Reply-To-Adresse für jeden Versand verwenden möchten oder
- Sie den Servercode lesen, auf eine Version festlegen oder ändern möchten.
Voraussetzungen
- Node.js 18 oder neuer, damit
npxverfügbar ist. - Ein API-Schlüssel. Verwenden Sie einen reinen Sende-Schlüssel, auf eine Domain beschränkt, wenn der Assistent nur senden muss; die übrigen Tools benötigen Vollzugriff.
- Eine verifizierte Versanddomain für die Absenderadresse.
Client konfigurieren
Der Client startet den Server als Unterprozess und kommuniziert mit ihm über stdio. Übergeben Sie den API-Schlüssel über die Umgebungsvariable EMAILIT_API_KEY.
claude mcp add emailit \
-e EMAILIT_API_KEY=secret_•••••••• \
-e SENDER_EMAIL_ADDRESS=hello@acme.com \
-- npx -y @emailit/emailit-mcpÖffnen Sie Settings > Developer > Edit Config, fügen Sie den Server zu claude_desktop_config.json hinzu und starten Sie Claude Desktop neu:
{
"mcpServers": {
"emailit": {
"command": "npx",
"args": ["-y", "@emailit/emailit-mcp"],
"env": {
"EMAILIT_API_KEY": "secret_••••••••",
"SENDER_EMAIL_ADDRESS": "hello@acme.com"
}
}
}
}Fügen Sie den Server zu ~/.cursor/mcp.json oder zur .cursor/mcp.json eines Projekts hinzu:
{
"mcpServers": {
"emailit": {
"command": "npx",
"args": ["-y", "@emailit/emailit-mcp"],
"env": {
"EMAILIT_API_KEY": "secret_••••••••",
"SENDER_EMAIL_ADDRESS": "hello@acme.com"
}
}
}
}Fügen Sie den Server zu .vscode/mcp.json hinzu. VS Code fragt nach dem Schlüssel und speichert ihn sicher:
{
"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"
}
}
}
}Verwenden Sie immer den Paketnamen mit npm-Scope, @emailit/emailit-mcp.
Umgebungsvariablen
| Variable | Erforderlich | Beschreibung |
|---|---|---|
EMAILIT_API_KEY |
Für stdio | Ihr Emailit-API-Schlüssel. Im HTTP-Modus senden die Clients stattdessen ihren eigenen Schlüssel. |
SENDER_EMAIL_ADDRESS |
Nein | Standard-Absenderadresse auf einer verifizierten Versanddomain. |
REPLY_TO_EMAIL_ADDRESSES |
Nein | Durch Kommas getrennte Standard-Reply-To-Adressen. |
MCP_PORT |
Nein | Port für den HTTP-Modus. Standardwert: 3000. |
Wenn Sie keinen Absender festlegen, fragt der Server den Assistenten bei jedem Versand nach einer Absenderadresse.
Befehlszeilenoptionen
Optionen überschreiben die entsprechenden Umgebungsvariablen.
| Option | Beschreibung |
|---|---|
--key <key> |
API-Schlüssel für den stdio-Modus. |
--sender <email> |
Standard-Absenderadresse. |
--reply-to <email> |
Standard-Reply-To-Adresse. Wiederholen Sie die Option für mehrere Adressen. |
--http |
Streamable HTTP statt stdio bereitstellen. |
--port <port> |
Port für --http. Standardwert: 3000 oder MCP_PORT. |
-h, --help |
Hilfe zur Verwendung ausgeben. |
Per HTTP ausführen
Um einen lokalen Server für mehrere Clients zu nutzen, starten Sie ihn im HTTP-Modus:
npx -y @emailit/emailit-mcp --http --port 3000Der Server lauscht auf http://127.0.0.1:3000/mcp und ist nur von Ihrem Rechner aus erreichbar. Jeder Client authentifiziert sich mit seinem eigenen API-Schlüssel als Bearer-Token:
claude mcp add emailit --transport http http://127.0.0.1:3000/mcp \
--header "Authorization: Bearer $EMAILIT_API_KEY"Aus dem Quellcode ausführen
git clone https://github.com/emailit/emailit-mcp.git
cd emailit-mcp
npm install
EMAILIT_API_KEY=secret_•••••••• node src/index.jsHängen Sie für den HTTP-Modus --http --port 3000 an den letzten Befehl an.
Fehlerbehebung
| Problem | Lösung |
|---|---|
API key is required for stdio mode. Use --key or set EMAILIT_API_KEY. |
Fügen Sie EMAILIT_API_KEY dem env-Block Ihrer Client-Konfiguration hinzu. |
Der Client kann npx nicht starten |
Desktop-Apps sehen nicht immer den PATH Ihrer Shell. Verwenden Sie den vollständigen Pfad zu npx (ermitteln Sie ihn mit which npx) als command. |
Domain not verified beim Senden |
Verwenden Sie einen Absender auf einer verifizierten Domain oder setzen Sie SENDER_EMAIL_ADDRESS auf eine solche Adresse. |
| Berechtigungsfehler bei Tools, die nicht senden | Der Schlüssel ist ein reiner Sende-Schlüssel. Verwenden Sie für Domains, Vorlagen, Kontakte und andere Tools einen Schlüssel mit Vollzugriff. |
| Eine geplante E-Mail lässt sich nicht stornieren | Geplante E-Mails lassen sich nur bis 3 Minuten vor ihrem Sendezeitpunkt stornieren oder verschieben. |