Iterable über MCP mit Gemini verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Iterable klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

Iterable + Gemini

Lass deine KI mit Iterable arbeiten: Nutzer mit ihren Events und Nachrichten nachschlagen, Listen, Kampagnen und Kampagnenkennzahlen, Vorlagen und Kataloge auswerten, Profile aktualisieren, Events erfassen, Listenmitgliedschaften verwalten und nach deiner Bestätigung eine getriggerte E-Mail senden.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

ITERABLE_API_URL, ITERABLE_API_KEY

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 3 Minuten. Du brauchst einen Iterable-Benutzer, der im Projekt API-Keys anlegen darf, und musst wissen, ob das Projekt in den USA oder in der EU gehostet ist.

1. Öffne in Iterable in den Projekteinstellungen Integrations → API Keys und klicke auf New API Key. Wähle einen Server-side-Key, wenn die KI lesen und schreiben soll, oder einen Read-only-Key, wenn sie nur lesen soll. JavaScript- und Mobile-Keys funktionieren hier nicht.
2. Kopiere den Key und füge ihn in ITERABLE_API_KEY ein. Ein Key gehört zu genau einem Projekt, ein Connector arbeitet also mit einem Iterable-Projekt. Der Key wird nur an Iterable gesendet, im Header Api-Key.
3. Setze ITERABLE_API_URL auf das Rechenzentrum des Projekts: https://api.iterable.com für Projekte in den USA, https://api.eu.iterable.com für Projekte in der EU (bei denen du dich unter app.eu.iterable.com anmeldest), ohne /api oder einen anderen Pfad.
4. Installiere den Connector und starte mit iterable_list_channels: Es prüft den Key und zeigt die Marketing- und Transaktionskanäle des Projekts.

Ein Key für das ganze Projekt: Der Key handelt für das Projekt, nicht für eine einzelne Person. Wer diesen Connector nutzt, sieht jeden Nutzer und jede Kampagne, die der Key lesen darf. Teile den MCP-Server deshalb nur mit Menschen, die das sehen dürfen.

Was abgedeckt ist: Nutzerprofile per E-Mail oder userId mit allen Feldern, ihre letzten Events (eigene Events, Käufe, Versand, Öffnungen, Klicks, Bounces, Abmeldungen) und die an sie gesendeten Nachrichten; Listen mit ihrer Größe und ihren Mitgliedern; Kampagnen mit Details und Kennzahlen; Vorlagen, Kanäle, Nachrichtentypen, Kataloge und Katalogeinträge. Kampagnenkennzahlen kommen als Tabelle, eine Zeile pro Kampagne, mit Sendungen, Zustellungen, eindeutigen Öffnungen und Klicks, Bounces, Beschwerden, Abmeldungen, Käufen und Umsatz.

Änderungen erst nach deinem Ja: Die KI zeigt, was sie schreiben wird, und wartet vor jeder Änderung auf deine Bestätigung.

• iterable_update_user führt Felder in ein Profil zusammen. Geänderte Felder können den Nutzer in dynamische Listen verschieben und Journeys starten.
• iterable_track_event erfasst ein eigenes Event, etwa eine Anmeldung oder eine Buchung, das ebenfalls eine Journey starten kann.
• iterable_subscribe_to_list und iterable_unsubscribe_from_list ändern die Listenmitgliedschaft. Eine Abmeldung mit der Kanal-Option wirkt wie eine globale Abmeldung von diesem Kanal.
• iterable_send_email sendet eine echte E-Mail aus einer getriggerten Kampagne an eine Person, sofort oder zu einem festen Zeitpunkt. Sendungen an viele Menschen bleiben Kampagnen in Iterable.

Bei der Installation ausgeschaltet: iterable_delete_user_by_email und iterable_delete_user_by_user_id entfernen Profile samt Daten endgültig. Ein Administrator schaltet sie nur bewusst ein. Mit einem Read-only-Key antwortet jeder Schreibvorgang mit 403; schalte für ein reines Lese-Setup die Schreib-Tools aus.

E-Mail oder userId: Je nachdem, ob das Projekt E-Mail-basiert, userID-basiert oder hybrid ist, identifiziert die KI einen Nutzer per E-Mail oder per userId, nie mit beidem im selben Aufruf. Zeiten in Antworten sind Epoch-Millisekunden.

Limits pro Projekt: die meisten Lesezugriffe 100 Aufrufe pro Sekunde, Kampagnenkennzahlen 10 pro Minute, Listengröße und Listenmitglieder 5 pro Minute, gesendete Nachrichten 3 pro Sekunde. Die Mitglieder großer Listen werden bei etwa 100 KB abgeschnitten; die KI prüft vorher die Listengröße.

Häufige Fehler: 401 „Invalid API key“ heißt, der Key ist falsch oder gelöscht, ein JavaScript- oder Mobile-Key oder aus dem anderen Rechenzentrum; prüfe ITERABLE_API_URL. 400 mit einem Code wie BadParams oder RequestFieldsTypesMismatched: Ein Parameter oder ein Feldtyp stimmt nicht, die Meldung sagt welcher. 404 oder NotFound: Nutzer, Liste oder Kampagne gibt es in diesem Projekt nicht. 429: Ein Ratenlimit ist erreicht; warte kurz und versuche es erneut.

Der Connector startet keine Export-Jobs und nutzt keine Bulk-Endpunkte, bearbeitet keine Vorlagen oder Snippets, verwaltet keine Experimente oder Journeys, sendet keine In-App-, Push-, SMS- oder Web-Push-Nachrichten, ändert keine Abos pro Nachrichtentyp und ändert keine Kataloge.

Schritt 2 — Adapter installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — Connector in Gemini hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte gemini neu.
3. Führe in der Gemini CLI /mcp aus (oder gemini mcp list im Terminal): anythingmcp sollte als verbunden erscheinen.
4. Leg los: Gemini CLI kann jetzt die Iterable-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Schlag [email protected] in Iterable nach: ihre Profilfelder, ihre letzten 20 Events und die Kampagnen, die ihr diesen Monat eine E-Mail geschickt haben.“
• „Vergleiche Sendungen, eindeutige Öffnungen, eindeutige Klicks und Abmeldungen unserer letzten fünf Blast-Kampagnen in einer Tabelle.“
• „Wie viele Nutzer sind in der Liste VIP Newsletter, und welche Vorlagen nutzt die Kampagne Welcome?“
• „Füge [email protected] zur Liste Beta testers hinzu und erfasse für ihn ein Event beta_signup, aber zeig mir vorher, was du schreibst.“

FAQ

Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden