Interakt über MCP mit Gemini verbinden

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

Interakt + Gemini

Lass deine KI mit deinem Interakt-Konto für WhatsApp Business arbeiten: freigegebene Vorlagen auflisten, Kunden mit ihren Merkmalen und Tags finden und auflisten, Kunden anlegen oder aktualisieren, Ereignisse erfassen und Chats zuweisen. Das Senden von Vorlagen- und Textnachrichten ist bei der Installation deaktiviert.

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:

INTERAKT_API_KEY

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 2 Minuten. Du brauchst ein Interakt-Konto mit dem Tarif Growth oder höher: Erst dort gibt es API-Zugriff.

1. Öffne in Interakt Settings → Developer Setting.
2. Kopiere den Secret Key genau so, wie er angezeigt wird, in INTERAKT_API_KEY, ohne das Wort Basic davor. Der Schlüssel ist schon codiert, und der Connector schickt ihn nur an api.interakt.ai.
3. Installiere den Connector und rufe interakt_list_templates auf: Es listet deine WhatsApp-Vorlagen und zeigt, dass Schlüssel und Tarif funktionieren.

Telefonnummern: Die meisten Tools nehmen die Nummer ohne Ländervorwahl und die Vorwahl getrennt, zum Beispiel 9876543210 und +91 (Indien ist voreingestellt). Das Tool für freien Text nimmt die ganze Nummer ohne +, zum Beispiel 919876543210.

Was sie liest: deine WhatsApp-Vorlagen mit Code-Name, Anzeigename, Sprache, Kategorie, Freigabestatus, Kopfzeile, Text mit Platzhaltern, Fußzeile und Buttons; Kunden per Telefonnummer oder Interakt-ID mit Merkmalen wie Name, E-Mail, WhatsApp-Opt-in und deinen eigenen Merkmalen, dazu Tags und wann sie angelegt und zuletzt geändert wurden; und Kunden, die in einem Zeitraum angelegt oder geändert wurden, 100 auf einmal.

Kein Nachrichtenverlauf: Die Interakt-API liefert keine früheren Nachrichten und keinen Zustellstatus, die gehen nur an Interakt-Webhooks. Die KI kann dir also nicht sagen, ob ein Kunde eine Nachricht gelesen hat.

Fragt vor jeder Änderung: interakt_upsert_customer legt einen Kunden an oder ändert den mit derselben Nummer (Merkmale werden zusammengeführt, Tags werden ergänzt und nie entfernt), interakt_track_event erfasst ein Ereignis wie Order Placed in der Timeline eines Kunden, was Interakt-Automationen auslösen kann, die dem Kunden schreiben, und interakt_assign_chat weist den Chat eines Kunden im gemeinsamen Posteingang per E-Mail einem Teammitglied zu. Die KI zeigt dir den Kunden und die genaue Änderung und wartet auf dein Ja.

Bei der Installation deaktiviert: interakt_send_template und interakt_send_text. Sie erreichen den Kunden sofort, und für Vorlagen berechnet Meta die Unterhaltung. Freier Text geht nur innerhalb von 24 Stunden nach der letzten Nachricht des Kunden; außerhalb davon lehnt Interakt ihn ab, und nur eine freigegebene Vorlage funktioniert. Eine Vorlage braucht genau einen Wert pro Platzhalter ({{1}}, {{2}} und so weiter), in der richtigen Reihenfolge, deshalb liest die KI die Vorlage zuerst und zählt sie; Vorlagen mit Bild- oder Dokument-Kopfzeile brauchen außerdem einen öffentlichen Link zur Datei. Ein Administrator schaltet diese Tools bewusst ein, und auch dann zeigt dir die KI Vorlage oder Text, Nummer und Werte und wartet auf dein Ja. Eine erfolgreiche Antwort heißt, dass Interakt die Nachricht angenommen hat, nicht, dass sie zugestellt wurde.

Limits: Interakt erlaubt 300 Anfragen pro Minute mit Growth und 600 mit Advanced, und eine einzelne Anfrage darf höchstens 32 KB groß sein. Nach einem 429 wartet die KI eine Minute, bevor sie es erneut versucht.

Häufige Fehler: 401 bedeutet, dass der Schlüssel falsch ist oder dein Tarif keinen API-Zugriff hat: Kopiere den Secret Key noch einmal ohne Basic und prüf, ob du Growth oder höher hast. 400 heißt, dass ein Feld fehlt oder falsch ist, und die Meldung von Interakt sagt, welches, etwa „Missing variable values for template's body“, wenn ein Vorlagenwert fehlt. 429 heißt, dass das Anfragelimit erreicht ist.

Der Connector legt keine Vorlagen an, startet keine Kampagnen, lädt keine Medien hoch, weicht nicht auf RCS oder SMS aus und verwaltet keine Webhooks.

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 Interakt-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Such die Kundin +91 98765 43210 und zeig mir ihren Namen, ihre Tags und ob sie WhatsApp zugestimmt hat.“
• „Welche unserer freigegebenen Vorlagen sind Marketing-Vorlagen, und wie viele Platzhalter braucht jede?“
• „Liste die Kunden auf, die gestern in Interakt angelegt oder geändert wurden.“
• „Erfasse für +91 98765 43210 ein Ereignis Order Placed mit Bestellnummer 1042 und Summe Rs 1,499. Zeig es mir vorher.“
• „Weise den Chat von Rahul Sharma (+91 99887 76655) [email protected] zu. Frag mich, bevor du es machst.“

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