mailinapp
Documentation menu

MCP-Server

MailInApp stellt einen MCP-Server bereit, sodass ein externer KI-Client — Claude Desktop, Claude Code oder ein beliebiges anderes MCP-kompatibles Tool — die E-Mail-Projekte Ihres Kontos direkt bauen und bearbeiten kann, genau wie es der KI-Copilot im Studio tut. Es ist in beiden Fällen derselbe Tool-Use-Kern: Ein MCP-Client und das Studio-Panel sind nur zwei verschiedene Eingänge zu demselben Satz von Bearbeitungen.

Diese Seite behandelt den Entwickler-Pfad: Ihr eigenes Backend oder CLI-Tooling authentifiziert sich mit einem selbst geprägten API-Schlüssel, denselben Zugangsdaten, die auch die Send API verwendet.

Endpunkt & Authentifizierung

https://mailinapp.com/api/mcp

Authentifizieren Sie sich mit demselben Authorization: Bearer <apiKey>-Header wie die Send API — prägen Sie einen Schlüssel unter Entwickler im Dashboard oder nutzen Sie einen bestehenden weiter. Für diesen Pfad gibt es keine separaten, MCP-spezifischen Zugangsdaten zu verwalten; ein Schlüssel steht bereits für „das eigene Backend dieses Kontos", ist also hier auf demselben Vertrauensniveau, wobei jedes unten dokumentierte Tool unabhängig vom Scope verfügbar ist.

Der Endpunkt ist zustandslos: Jede Anfrage ist ein in sich geschlossener MCP-Aufruf, es gibt also nichts, was zwischen Nachrichten am Leben gehalten werden müsste, und keinen separaten Verbindungs-/Trennungsschritt über die normale Einrichtung Ihres MCP-Clients hinaus.

Claude Code verbinden

claude mcp add --transport http mailinapp https://mailinapp.com/api/mcp \
  --header "Authorization: Bearer mia_live_..."

Claude Desktop und andere MCP-Clients, die einen entfernten HTTP-Server unterstützen, verwenden dieselbe URL und denselben Header — schauen Sie in der Dokumentation Ihres Clients nach, wo Sie diese einfügen.

Tools

Ein API-Schlüssel wird auf vollem Kontoinhaber-Niveau vertraut, er sieht also jedes verfügbare Tool — Projektgestaltung, Kontakte und Sperrungen, Kampagnenergebnisse und Bestellungen, Versand (einschließlich echter Kampagnenversände, nicht nur Tests), Postfach- und Ticket-Antworten sowie Tarif-Nutzung.

Baum-bearbeitende Tools (add_block/update_block/remove_block/move_block/set_theme und Verwandte) nehmen alle vorab eine projectId (aus list_projects/create_project) — ein MCP-Client hat keinen offenen Studio-Tab, aus dem er sie ableiten könnte. Jeder gültige Blocktyp, seine akzeptierten Eltern und seine Feldliste werden dem Modell als Teil des Tool-Sets über list_block_types beschrieben, sodass es stets mit den Blocktypen synchron bleibt, die das Studio aktuell ausliefert — Sie müssen ihm nicht mitteilen, was verfügbar ist.

Wie Bearbeitungen angewendet werden

Jeder verändernde Tool-Aufruf ist ein eigener atomarer Schreibvorgang direkt auf das Projekt — es gibt keinen „Anwenden"-Schritt wie im Studio-Panel, da es keine offene Arbeitsfläche gibt, auf die angewendet werden könnte. Falls Sie das Projekt im Studio gleichzeitig geöffnet haben, während ein MCP-Client es bearbeitet, zeigt Ihr nächstes Autosave das normale „Anderswo geändert"-Konfliktbanner, genau als hätte ein Teammitglied es bearbeitet — laden Sie neu, um die MCP-gesteuerte Änderung zu übernehmen, oder speichern Sie als Kopie, um Ihre eigenen laufenden Bearbeitungen zu behalten.

Jede MCP-Bearbeitung wird außerdem in den Copilot-Chat-Thread des Projekts protokolliert (markiert als von MCP stammend, nicht vom Studio-Panel), sodass sie in derselben Verlaufsansicht erscheint, die das In-Studio-KI-Copilot-Panel anzeigt.

Rate Limits & Tarifverfügbarkeit

  • Pro API-Schlüssel: 60 Anfragen/Minute, unabhängig von anderen Schlüsseln desselben Kontos.
  • Pro Konto: Jeder Tool-Aufruf zehrt von einem gemeinsamen monatlichen Zähler (plan.connectorCallsMonthly, getrennt vom eigenen Runden-Kontingent des In-Studio-KI-Copiloten, da ein MCP-Aufruf niemals ein KI-Modell auf MailInApps eigener Seite aufruft). Mit einem echten Kontingent auf jedem Tarif verfügbar, Free eingeschlossen — genaue Zahlen finden Sie unter Preise, oder rufen Sie get_plan_usage auf, um die aktuelle Monats-Nutzung Ihres Kontos abzulesen.
  • Das Senden echter Kampagnen über diesen Pfad wird genauso gemessen wie confirm_send, mit demselben Bestätigungsablauf und derselben Volumengrenze.