Zum Inhalt springen
Doku

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.

Aktualisiert am 2. Okt. 2026

@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.

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 npx verfü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.

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

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:

Terminal
npx -y @emailit/emailit-mcp --http --port 3000

Der 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:

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

Aus dem Quellcode ausführen

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

Hä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.
Gehostet oder lokal, Scopes und Sicherheit.
Alle gehosteten Tools und ihre Argumente.
Einen Schlüssel für den Server erstellen.
Editoren mit dem gehosteten Server verbinden.

War diese Seite hilfreich?

Danke für Ihr Feedback.

Danke, wir lesen jede Nachricht.