Customer.io über MCP mit Gemini verbinden

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

Customer.io + Gemini

Lass deine KI mit Customer.io arbeiten: Personen mit ihren Attributen, Segmenten, Aktivitäten und Nachrichten nachschlagen, Automationen, Broadcasts und einmalige Sendungen mit ihren Kennzahlen auswerten und nach deiner Bestätigung Transaktions-E-Mails senden oder Broadcasts auslösen.

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:

CUSTOMERIO_API_URL, CUSTOMERIO_APP_API_KEY

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 3 Minuten. Du brauchst einen Customer.io-Benutzer, der einen App API Key anlegen darf, und musst wissen, ob dein Konto in den USA oder in der EU gehostet ist.

1. Öffne in Customer.io Settings → Account Settings → API Credentials → App API Keys (fly.customer.io/settings/api_credentials) und klicke auf Create App API Key. Wähle den Workspace und den Zugriff des Keys: vollen Zugriff, oder nur Lesen plus Senden, wenn die KI nur lesen und senden soll.
2. Kopiere den Key sofort: Customer.io zeigt ihn nur einmal an. Füge ihn so in CUSTOMERIO_APP_API_KEY ein, wie er angezeigt wird, ohne Bearer davor. Es ist ein App API Key, kein Track API Key.
3. Setze CUSTOMERIO_API_URL auf das Rechenzentrum deines Kontos: https://api.customer.io für Konten in den USA, https://api-eu.customer.io für Konten in der EU, ohne /v1 oder einen anderen Pfad. Die Region wird beim Anlegen des Kontos festgelegt.
4. Installiere den Connector und starte mit customer_io_list_workspaces: Es prüft den Key und zeigt den Workspace mit der Zahl seiner Personen und Nachrichten.

Ein Key für den ganzen Workspace: Der App API Key handelt für seinen Workspace, nicht für eine einzelne Person. Wer diesen Connector nutzt, sieht jede Person, jedes Segment und jede Nachricht, die der Key lesen darf. Teile den MCP-Server deshalb nur mit Menschen, die das sehen dürfen.

Was abgedeckt ist: Personen (per E-Mail finden oder nach Segmentzugehörigkeit und Attributwerten suchen), ihre Attribute, Segmente, die Aktivitäten der letzten 30 Tage und die an sie gesendeten Nachrichten; Segmente mit ihren Bedingungen, aktueller Größe und Mitgliedern; Automationen, die in der Customer.io-API Campaigns heißen, mit ihren Nachrichtenkennzahlen; per API ausgelöste Broadcasts und einmalige Sendungen (in der API Newsletters) mit ihren Kennzahlen; Zustellungen und Aktivitäten im ganzen Workspace; und die Vorlagen für Transaktionsnachrichten.

Gesendet wird erst nach deinem Ja: Nur zwei Tools senden, alle anderen lesen.

• customer_io_send_transactional_email sendet eine echte E-Mail (Belege, Passwort-Resets, Benachrichtigungen) an bis zu 15 Adressen in to, cc und bcc, aus einer Transaktionsvorlage oder mit eigenem Betreff und Text. Die KI zeigt dir vorher Empfänger, Betreff und Inhalt.
• customer_io_trigger_broadcast sendet an viele Menschen auf einmal. Die KI zeigt zuerst den Broadcast, die Größe der Zielgruppe (customer_io_get_segment_customer_count) und die Daten und löst ihn erst nach einem ausdrücklichen „yes, send“ aus. Danach verfolgt sie den Fortschritt mit customer_io_get_broadcast_trigger.

Track API nicht enthalten: Personen identifizieren, Events erfassen und Personen löschen läuft über die Track API von Customer.io, die andere Zugangsdaten nutzt (Site ID und Track API Key). Dieser Connector nutzt sie nicht und kann deshalb weder Profile ändern noch jemanden löschen.

Limits: Die App API erlaubt etwa 10 Anfragen pro Sekunde. Transaktionssendungen teilen sich ein weiches Limit von 3.000 Anfragen pro 3 Sekunden, und ein Broadcast lässt sich höchstens alle 10 Sekunden auslösen. Lange Listen kommen seitenweise, die KI liest weiter bis zur letzten Seite. Zeitstempel sind Unix-Sekunden.

Häufige Fehler: 401 heißt, der App API Key ist falsch oder wurde gelöscht, oder das Konto liegt in der anderen Region; prüfe CUSTOMERIO_API_URL. 403: Der Zugriff des Keys umfasst diese Aktion nicht, zum Beispiel ein Lese-Key, mit dem gesendet werden soll. 404: Die ID gibt es in diesem Workspace nicht. 400 oder 422: Ein Parameter oder der Suchfilter ist ungültig; die Fehlermeldung nennt ihn. 429: Ein Ratenlimit ist erreicht; warte kurz und versuche es erneut.

Der Connector nutzt weder die Track API noch die Pipelines API, startet keine Exporte oder Importe, verwaltet keine Collections, Snippets, Reporting-Webhooks oder ESP-Sperrlisten und ändert keine Inhalte von Automationen und Broadcasts.

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 Customer.io-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Finde [email protected] in Customer.io und zeig mir ihre Attribute, ihre Segmente und die letzten E-Mails, die wir ihr geschickt haben.“
• „Wie hat unsere Onboarding-Automation in den letzten 30 Tagen abgeschnitten: gesendet, zugestellt, geöffnet, geklickt und abgemeldet?“
• „Wie viele Personen sind gerade im Segment Trial ending, und welche davon haben den Pro-Plan?“
• „Löse den Broadcast Product update aus, aber zeig mir vor dem Senden, wer ihn bekommt und wie viele Personen das sind.“

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