# Emailit-MCP-Server

> Verbinden Sie ChatGPT, Claude, Cursor, Codex, Grok und andere KI-Tools über den gehosteten MCP-Server mit Emailit, mit OAuth-Anmeldung und der vollständigen API v2 als Tools.

Der Emailit-MCP-Server verbindet KI-Assistenten über das [Model Context Protocol](https://modelcontextprotocol.io) mit Ihrem Emailit-Konto. Bitten Sie in natürlicher Sprache darum, eine E-Mail zu senden, eine Domain hinzuzufügen und zu verifizieren, herauszufinden, warum eine Nachricht gebounct ist, eine Kontaktliste aufzubauen oder eine Kampagne zu starten, und der Assistent ruft das passende Emailit-Tool auf.

Emailit hostet den Server. Sie müssen nichts installieren und keinen API-Schlüssel einfügen: Sie melden sich im Browser bei Emailit an, wählen die Workspaces, die der Assistent nutzen darf, und erlauben den Zugriff.

| | |
| --- | --- |
| **Server-URL** | `https://api.emailit.com/mcp` |
| **Transport** | Streamable HTTP (zustandslos, `POST`) |
| **Anmeldung** | OAuth 2.1 mit PKCE oder ein API-Schlüssel als Bearer-Token |
| **Tools** | 109, die die gesamte API v2 abdecken |
| **Discovery** | `https://api.emailit.com/.well-known/oauth-protected-resource/mcp` |

## KI-Tool verbinden

| Client | Verbindung | Anleitung |
| --- | --- | --- |
| ChatGPT | Emailit-Plugin | [ChatGPT](/de/docs/mcp/chatgpt/) |
| Claude (claude.ai, Desktop und mobil) | Emailit-Connector | [Claude](/de/docs/mcp/claude/) |
| Claude Code | Emailit-Plugin oder `claude mcp add` | [Claude Code](/de/docs/mcp/claude/#claude-code) |
| Cursor | Emailit-Plugin oder **Add to Cursor** | [Cursor](/de/docs/mcp/cursor/) |
| Codex | Emailit-Plugin oder `codex mcp add` | [Codex](/de/docs/mcp/codex/) |
| Grok | Connector auf grok.com, Plugin für Grok Build oder die xAI API | [Grok](/de/docs/mcp/grok/) |
| VS Code, Windsurf, Zed und weitere | URL des Remote-MCP-Servers | [Weitere Clients](/de/docs/mcp/other-clients/) |

Fügen Sie in jedem anderen MCP-Client einen Remote-Server (Streamable HTTP) mit der URL `https://api.emailit.com/mcp` hinzu. Clients, die die MCP-Autorisierung unterstützen, finden die Anmeldung über die obige Discovery-URL automatisch; die URL ist also alles, was sie brauchen.

Die [Emailit-Plugins](/de/docs/mcp/plugins-and-skills/) für ChatGPT, Codex, Claude Code, Cursor und Grok ergänzen den Server um Skills: Anleitungen, die dem Assistenten beibringen, wie er Domains einrichtet, Zustellbarkeitsprobleme behebt, Kampagnen durchführt, Webhooks verifiziert und ein SDK auswählt.

## Was beim Verbinden passiert

1. **Anmelden.** Ihr KI-Tool öffnet eine Anmeldeseite von Emailit. Geben Sie Ihre E-Mail-Adresse und Ihr Passwort ein, dazu den Code Ihrer Authenticator-App, falls Sie die Zwei-Faktor-Authentifizierung nutzen.

2. **Workspaces wählen.** Wählen Sie **All my workspaces**, was auch Workspaces einschließt, die Sie später erstellen oder denen Sie später beitreten, oder **Only these workspaces** mit den angehakten Workspaces. Wenn Sie mehr als einen erlauben, wählen Sie den, in dem das Tool startet.

3. **Zugriff erlauben.** Prüfen Sie den Zugriff, den das Tool anfordert (`sending` oder `full`), und wählen Sie **Allow access**.

Das Tool erhält ein Zugriffstoken, das 15 Minuten gültig ist, und ein Refresh-Token, das die Verbindung bis zu 60 Tage Inaktivität aufrechterhält. Refresh-Tokens rotieren bei jeder Verwendung, und die Wiederverwendung eines alten Tokens widerruft die Verbindung. Jede Verbindung erscheint unter **Account → Connected apps**.

## Mehrere Workspaces

Eine Verbindung umfasst alle Workspaces, die Sie erlaubt haben; so können Sie mehrere Marken oder Kundenkonten aus demselben Chat verwalten. Nennen Sie den Workspace in Ihrer Anfrage:

> „In Acme Client die Domains auflisten.“

Der Assistent übergibt `workspace: "Acme Client"` an genau diesen einen Tool-Aufruf. Er akzeptiert eine Workspace-ID oder den exakten Namen des Workspaces und ändert nicht den Standard-Workspace der Verbindung; zwei Chats, die gleichzeitig in verschiedenen Workspaces arbeiten, kommen sich also nicht in die Quere.

- „Welche Emailit-Workspaces stehen zur Verfügung?“ listet die erlaubten Workspaces und Ihre Rolle in jedem davon auf.
- „Zu meinem Workspace Marketing wechseln“ ändert den Standard für spätere Anfragen, die keinen Workspace nennen.
- Um Workspaces hinzuzufügen oder zu entfernen, öffnen Sie **Account → Connected apps** und wählen Sie **Edit access**. Änderungen gelten ab der nächsten Anfrage der App, ohne erneute Verbindung.
- Wenn Sie einen Workspace verlassen oder jemand Sie entfernt, verliert auch die App den Zugriff darauf.

Das Tool arbeitet mit Ihrer Rolle im jeweiligen Workspace, genau wie die Weboberfläche: Mitglieder mit der Rolle Member können keine API-Schlüssel verwalten und keine Domains löschen. Siehe [Workspaces und Berechtigungen](/de/docs/mcp/workspaces-and-permissions/).

## Zugriffsstufen

| Scope | Was das Tool tun kann |
| --- | --- |
| `sending` | E-Mails senden, planen, verschieben, stornieren, erneut senden und weiterleiten. Workspaces prüfen und wechseln. |
| `full` | Alles in der API v2: Domains, DMARC-Berichte, Vorlagen, API-Schlüssel, Kontaktlisten, Kontakte, Sperrungen, Webhooks, Kampagnen, Automatisierungen, Formulare, E-Mail-Verifizierung, Events und das Erstellen von Workspaces. |

Die meisten KI-Tools fordern beide Scopes an. Wenn eine Verbindung ohne `full` ein Tool aufruft, das diesen Scope braucht, gibt das Tool einen Fehler zurück, der Sie auffordert, sich mit Vollzugriff neu zu verbinden. Clients, die Step-up-Autorisierung unterstützen, etwa ChatGPT, zeigen den Freigabebildschirm erneut an.

## Tool-Liste kürzen

Manche Clients begrenzen, wie viele Tools sie laden. Hängen Sie diese Optionen an die Server-URL an oder senden Sie sie als Header, um weniger Tools bereitzustellen:

| Option | Query | Header | Beispiel |
| --- | --- | --- | --- |
| Nur bestimmte Toolsets | `?toolsets=` | `X-MCP-Toolsets` | `emails,domains,events` |
| Schreibende Tools ausblenden | `?read_only=true` | `X-MCP-Readonly` | `true` |

Zum Beispiel gibt `https://api.emailit.com/mcp?toolsets=emails,domains&read_only=true` dem Assistenten nur Lesezugriff auf E-Mails und Domains. Die Workspace-Tools sind immer enthalten. Die vollständige Liste finden Sie unter [Toolsets und Nur-Lesen-Modus](/de/docs/mcp/toolsets/).

## Stattdessen einen API-Schlüssel verwenden

Server, Skripte, CI-Jobs und Headless-Agenten können keinen Browser für die Anmeldung öffnen. [Erstellen Sie einen API-Schlüssel](/de/docs/developers/api-keys/) und senden Sie ihn als Bearer-Token:

```json title="mcp.json"
{
  "mcpServers": {
    "emailit": {
      "url": "https://api.emailit.com/mcp",
      "headers": {
        "Authorization": "Bearer your_api_key"
      }
    }
  }
}
```

Ein API-Schlüssel ist an den Workspace gebunden, in dem er erstellt wurde, und kann keine anderen Workspaces erreichen; der Server listet nur die Tools auf, die der Scope des Schlüssels erlaubt. Verwenden Sie in Desktop- und Chat-Apps bevorzugt OAuth, denn ein in einer Konfigurationsdatei gespeicherter Schlüssel kann nach außen gelangen.

## App trennen

Öffnen Sie **Account → Connected apps**. Die Seite listet alle KI-Tools und Apps auf, die Sie freigegeben haben, mit den Workspaces, die sie nutzen können, ihrer Zugriffsstufe und dem Zeitpunkt der Verbindung. Wählen Sie **Edit access**, um die Workspaces zu ändern, oder **Revoke access**, um den Zugriff zu entziehen: Die Tokens funktionieren dann sofort nicht mehr. Siehe [Verbundene Apps](/de/docs/account/connected-apps/).

> **Achtung:** Wenn Sie den Server aus Ihrem KI-Tool entfernen, wird sein Zugriff in Emailit nicht widerrufen. Verwenden Sie dafür **Connected apps**.

## Sicherheit

- **Gekennzeichnete Tools.** Jedes Tool trägt MCP-Annotationen (read-only, destructive, open-world), damit Clients nachfragen können, bevor sie etwas ausführen, das schreibt, löscht oder nach außen greift.
- **Integrierte Anweisungen.** Der Server weist Assistenten an, vor dem Senden echter E-Mails Empfänger, Absender und Inhalt bestätigen zu lassen, IDs nachzuschlagen statt sie zu raten und vor dem Löschen oder Stornieren nachzufragen.
- **Nicht vertrauenswürdige Inhalte.** E-Mail-Inhalte, Kontaktfelder und Formulareinsendungen können Text enthalten, den andere Personen geschrieben haben. Prüfen Sie, was der Assistent vorhat, bevor Sie einen Versand oder eine Löschung bestätigen.
- **Netzwerkprüfungen.** Webhook-URLs werden geprüft, damit Anfragen keine privaten Netzwerke erreichen.
- **Ihre Rolle gilt.** Assistenten können in keinem Workspace mehr tun als Sie selbst.
- **Schlüssel bleiben aus dem Code.** Checken Sie nie API-Schlüssel ein; die Cursor-Regel im Emailit-Plugin warnt den Agenten davor.

## Nächste Schritte

  - [Tool-Referenz](/de/docs/mcp/tools/): Alle Tools mit Art, Scope und Argumenten.
  - [Plugins und Skills](/de/docs/mcp/plugins-and-skills/): Was die Emailit-Plugins für jeden Client hinzufügen.
  - [Workspaces und Berechtigungen](/de/docs/mcp/workspaces-and-permissions/): Workspace-Zugriff, Rollen, Scopes und Tokens.
  - [Fehlerbehebung](/de/docs/mcp/troubleshooting/): Probleme mit Anmeldung, Scope, Workspaces und dem Laden von Tools beheben.

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