Tool-Referenz
Jedes Tool, das ein verbundener Assistent aufrufen kann, gruppiert genauso, wie der Server sie registriert. Ein Tool wird dem Assistenten nur dann angeboten, wenn Ihre Verbindung den dafür benötigten Scope besitzt — es gibt kein Schreib-Tool, das zwar vorhanden ist, aber immer einen Fehler liefert; wenn Sie contacts:write nicht gewährt haben, sieht der Assistent upsert_contacts schlicht überhaupt nicht. Was jeder Scope bedeutet, steht unter Scopes & Berechtigungen.
Destructive in den Tabellen unten ist dieselbe MCP-Annotation, die Claudes eigener Review-Prozess verlangt — sie markiert ein Tool, dessen Wirkung sich nicht trivial rückgängig machen lässt (ein Projekt löschen, einen Baum überschreiben, einen Kontakt entfernen), nicht „gefährlich“ im vageren Sinne. Jedes Schreib-Tool nimmt weiterhin nur die Felder entgegen, die Sie erwarten würden; keines davon akzeptiert eine rohe Payload, über die das Modell beliebige Änderungen einschmuggeln könnte.
Discovery
| Tool | Scope | Hinweise |
|---|
search | einer von projects:read / templates:read / contacts:read | Durchsucht Projekte, Vorlagen und Kontaktlisten nach Namen. Liefert opake IDs für fetch. Dies ist das Tool, das ein Deep-Research-fähiger Client automatisch aufruft. |
fetch | wie search | Löst eine ID aus search in ihren vollständigen Inhalt auf. |
E-Mail-Design
| Tool | Scope | Destructive | Hinweise |
|---|
list_projects | projects:read | | ID, Name, Zweck für jedes Projekt. |
get_email | projects:read | | Der aktuelle Blockbaum und das Theme eines Projekts. |
preview_email | projects:read | | Rendert über die echte Mailed-HTML-Pipeline — genau das Dokument, das ein Versand erzeugen würde. Mit Widget verknüpft (siehe unten). |
list_block_types | projects:read | | Der vollständige 44-Block-Katalog, generiert aus dem Live-Register — immer aktuell, nie von Hand gepflegt. |
list_templates | projects:read | | Ihre gespeicherten Vorlagen oder die genehmigte Community-Galerie. |
create_project | projects:write | | Optional aus einer integrierten Zweck-Vorlage vorbefüllt. |
add_block / update_block / move_block | projects:write | | Baumbearbeitungen, canPlace-/feldvalidiert genauso wie die Bearbeitungen des Copiloten im Studio. |
remove_block | projects:write | ✓ | Löscht einen Block und seine Kinder. |
set_theme | projects:write | | Markenfarben, Schriftart, Schaltflächenradius. |
rename_project | projects:write | | |
delete_project | projects:write | ✓ | Endgültig. |
apply_template | projects:write | ✓ | Überschreibt den gesamten Baum und das Theme des Projekts. |
save_as_template | templates:write | | Erstellt einen Snapshot des aktuellen Projekts als wiederverwendbare Vorlage. |
publish_landing_page | projects:write | | Veröffentlicht eine E-Mail als öffentliche Webseite unter /lp/<slug> und liefert ihre URL. Der Assistent ist angewiesen, Ihnen die E-Mail zuerst zu zeigen und Ihre Zustimmung einzuholen, wie beim Versand. |
unpublish_landing_page | projects:write | | Nimmt die Seite offline. Die Adresse bleibt für Sie reserviert. |
Zielgruppe
| Tool | Scope | Destructive | Hinweise |
|---|
list_data_sources | contacts:read | | Jede Datenquelle, Kontaktlisten eingeschlossen. Zugangsdaten-Werte werden nie zurückgegeben. |
list_contact_lists | contacts:read | | Speziell Kontaktlisten — ID, Name, Felder, Zeilenanzahl. |
get_contact_list_summary | contacts:read | | Anzahlen, Sperrungs-Summen und die Aufschlüsselung der E-Mail-Prüfung, dazu der Status der letzten erneuten Prüfung — keine individuellen Kontaktdaten. |
find_contacts | contacts:read | | Begrenzte Abfrage (≤25 Zeilen, cursor-paginiert). sortBy: "engagementScore" liefert die wärmsten Kontakte der Liste zuerst, mit Score und Veränderung dieser Woche. Jeder Aufruf wird ins Datenzugriffsprotokoll geschrieben, genau wie ein Kontaktzugriff im Dashboard. |
upsert_contacts | contacts:write | | Zeilen hinzufügen oder aktualisieren; setzt die Kontakt-Obergrenze Ihres Tarifs durch. |
remove_contact | contacts:write | ✓ | Entfernt eine Zeile endgültig. |
add_suppression / remove_suppression | contacts:write | | Blockiert oder entblockt eine Adresse kontoweit, mit demselben Effekt wie der eigene Abmeldelink eines Empfängers. |
Ergebnisse
| Tool | Scope | Destructive | Hinweise |
|---|
get_campaign_results | analytics:read | | Öffnungen/Klicks/Antworten/Umsatz, A/B-Varianten-Vergleich, Klick-Heatmap. Nur zusammengefasst — nie rohe Ereignisse pro Empfänger. Mit Widget verknüpft. |
get_form_responses | analytics:read | | Zusammenfassungen pro Frage; Freitextantworten sind eine begrenzte, eingegrenzte Stichprobe. |
list_orders | analytics:read | | Checkout-Bestellungen aus dem Produkt-Block. |
list_campaign_sends | analytics:read | | Vergangene Massenversände, neueste zuerst. |
list_schedules | analytics:read | | Auf einem Projekt konfigurierte wiederkehrende Versände. |
mark_order_fulfilled | commerce:write | | Markiert eine physische Bestellung als versandt und mailt dem Käufer. |
create_schedule | campaigns:send | | Konfiguriert einen neuen wiederkehrenden Versand. |
set_schedule_enabled | campaigns:send | ✓ | Als destructive markiert, weil das Deaktivieren eines laufenden Zeitplans zukünftige Versände stillschweigend stoppt. |
Versand
| Tool | Scope | Destructive | Hinweise |
|---|
send_test_email | campaigns:read | | Eine einzelne, mit [Test] präfixierte Kopie an eine von Ihnen angegebene Adresse — betrifft nicht Ihre echte Zielgruppe und benötigt kein campaigns:send. |
prepare_send | campaigns:send | | Laut Annotation rein lesend — löst die Zielgruppe auf und rendert eine Vorschau, versendet nichts. Liefert ein confirmationToken und wie viele Kontakte wegen ungültiger Adresse oder fehlender Einwilligung übersprungen werden. Mit Widget verknüpft (Sende-Bestätigungskarte). |
confirm_send | campaigns:send | ✓ | Benötigt genau das von prepare_send zurückgegebene confirmationToken, unverändert, innerhalb von 10 Minuten. Warum, steht unter Sicherheit. |
Postfach & Tickets
| Tool | Scope | Hinweise |
|---|
list_mailbox_threads / get_mailbox_thread | mailbox:read | Eingehende Mail an Ihrer verifizierten Domain. Nachrichtentexte werden als nicht vertrauenswürdiger, von Empfängern verfasster Inhalt eingegrenzt. |
reply_to_mailbox_thread | mailbox:write | Sendet von genau der Postfach-Adresse, an der die ursprüngliche Mail einging, korrekt in den Thread eingeordnet. |
list_tickets / get_ticket | mailbox:read | Support-Ticket-Unterhaltungen. Dieselbe Eingrenzung nicht vertrauenswürdiger Inhalte. |
reply_to_ticket | mailbox:write | Fügt eine Owner-Nachricht hinzu und mailt dem Empfänger einen Link zurück. |
Journeys & Segmente
| Tool | Scope | Destructive | Hinweise |
|---|
list_journeys | journeys:read | | Id, Name, ein/aus, Trigger-Art und Anzahl der Schritte jeder Journey. |
get_journey | journeys:read | | Der vollständige Ablauf einer Journey mit den Namen Ihrer E-Mails, Listen und Segmente sowie allem, was ihre Ausführung verhindern würde. Für eine ausgeschaltete, lauffähige Journey zusätzlich ein enableToken. |
list_segments | journeys:read | | Gespeicherte Segmente mit ihrer Kontaktliste und ihren Regeln. |
create_segment | journeys:write | | Speichert ein Segment auf einer Kontaktliste. Beachtet das Segment-Limit Ihres Tarifs. |
build_journey | journeys:write | | Erstellt eine neue Journey oder bearbeitet eine ausgeschaltete anhand einer Anfrage in normaler Sprache, mit dem KI-Copiloten des Journey-Builders. Verbraucht einen KI-Copilot-Durchlauf. Das Ergebnis wird immer ausgeschaltet gespeichert, und eine eingeschaltete Journey wird nie geändert. |
set_journey_enabled | journeys:write (+ campaigns:send zum Einschalten) | ✓ | Zum Einschalten ist das enableToken aus get_journey nötig, unverändert, innerhalb von 10 Minuten und ohne zwischenzeitliche Bearbeitung. Dasselbe Zwei-Schritt-Prinzip wie prepare_send/confirm_send. Zum Pausieren ist beides nicht nötig. |
Konto
| Tool | Scope | Hinweise |
|---|
get_plan_usage | keiner — immer verfügbar | Tarif, Kontingente und die Nutzung des laufenden Monats. Rein lesend und keine sensiblen Kontodaten wie Projekte/Kontakte/Postfach, daher unabhängig davon verfügbar, welche Scopes Sie gewährt haben. |
Drei Tools hängen auf Hosts, die MCP Apps unterstützen (Claude — Gemini hat keine Widget-Ebene und erhält stattdessen immer das reine Text-/JSON-Ergebnis), ein interaktives Widget an: preview_email (Live-Desktop-/Mobil-E-Mail-Vorschau), get_campaign_results (Ergebnis-Dashboard) und prepare_send (die Sende-Bestätigungskarte, deren eigene Confirm & Send-Schaltfläche tatsächlich confirm_send aufruft).
