# 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](/de/docs/mcp/) die richtige Wahl; diese Seite erklärt, wann das lokale Paket sinnvoll ist und wie Sie es konfigurieren.

- **Paket:** [`@emailit/emailit-mcp`](https://www.npmjs.com/package/@emailit/emailit-mcp) auf npm
- **Quellcode:** [github.com/emailit/emailit-mcp](https://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](https://nodejs.org) 18 oder neuer, damit `npx` verfügbar ist.
- Ein [API-Schlüssel](/de/docs/developers/api-keys/). 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](/de/docs/domains/add-a-domain/) 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 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**

  Öffnen Sie **Settings > Developer > Edit Config**, fügen Sie den Server zu `claude_desktop_config.json` hinzu und starten Sie Claude Desktop neu:

```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**

  Fügen Sie den Server zu `~/.cursor/mcp.json` oder zur `.cursor/mcp.json` eines Projekts hinzu:

```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**

  Fügen Sie den Server zu `.vscode/mcp.json` hinzu. VS Code fragt nach dem Schlüssel und speichert ihn sicher:

```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"
      }
    }
  }
}
```

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 ` | Standard-Absenderadresse. |
| `--reply-to ` | Standard-Reply-To-Adresse. Wiederholen Sie die Option für mehrere Adressen. |
| `--http` | Streamable HTTP statt stdio bereitstellen. |
| `--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:

```bash
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:

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

## Aus dem Quellcode ausführen

```bash
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](/de/docs/domains/verification/) 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. |

## Siehe auch

  - [Übersicht zum MCP-Server](/de/docs/mcp/): Gehostet oder lokal, Scopes und Sicherheit.
  - [Tool-Referenz](/de/docs/mcp/tools/): Alle gehosteten Tools und ihre Argumente.
  - [API-Schlüssel](/de/docs/developers/api-keys/): Einen Schlüssel für den Server erstellen.
  - [Weitere Clients](/de/docs/mcp/other-clients/): Editoren mit dem gehosteten Server verbinden.

---
Quelle: https://emailit.com/de/docs/mcp/local-server/