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

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 und Sperrungs-Summen — keine individuellen Kontaktdaten. | | find_contacts | contacts:read | | Begrenzte Abfrage (≤25 Zeilen, cursor-paginiert). 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. 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. |

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

Widgets

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