Emailit-MCP-Server

Der Emailit-MCP-Server verbindet KI-Assistenten über das Model Context Protocol 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.

KI-Tool verbinden

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

Zugriffsstufen

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:

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.

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 und senden Sie ihn als Bearer-Token:

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

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