Whatsapp Business mit Gemini verbinden — über MCP

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → WhatsApp Business klicken, dauerhaftes System-User-Access-Token + WhatsApp Business Account ID einfügen, MCP-API-Key erzeugen — fertig. Kein Docker, kein git clone, kein lokaler Server. Du kannst die lokalen Installationsschritte unten überspringen und direkt zur Client-Konfiguration weitergehen.

WhatsApp Business mit Claude verbinden

Die WhatsApp Business Cloud API ist Metas gehostetes Gateway zum programmatischen Versenden von WhatsApp-Nachrichten — Text, Vorlagen, Medien, Sprachnachrichten, interaktive Buttons, Standorte. Mit AnythingMCP steuerst du alles aus Claude Desktop, Claude Code oder claude.ai in Klartext. Kein SDK zu kleben, kein JSON-von-Hand für jeden Nachrichtentyp.

Was du tun kannst

• "Sende 'Deine Bestellung wurde verschickt — verfolge sie auf https://acme.com/t/12345' an +49 151 5123 4567."
• "Sende die Vorlage bestellbestaetigung (de) an +49 30 12345678, fülle 'Anna' und 'ORD-9912' ein."
• "Sende das Rechnungs-PDF von https://acme.com/inv/9912.pdf an meinen Kunden mit Untertitel 'Rechnung 9912'."
• "Liste die genehmigten Vorlagen auf meinem WABA und sende dann die Willkommensvorlage auf Deutsch an diesen neuen Lead."

Voraussetzungen

• Ein WhatsApp Business Account (WABA) mit mindestens einer verifizierten Absende-Nummer.
• Ein dauerhaftes System-User-Access-Token mit whatsapp_business_messaging + whatsapp_business_management-Berechtigungen (das temporäre 24h-Dev-Token taugt zum Testen, läuft aber aus).
• AnythingMCP lokal oder auf cloud.anythingmcp.com (3-Minuten-Setup).
• Claude Desktop, Claude Code oder ein claude.ai-Konto.

Schritt 1 — WhatsApp-Business-Zugangsdaten holen

1. Öffne https://developers.facebook.com/ → deine App → WhatsApp → API Setup. Notiere die WhatsApp Business Account ID (WABA ID).
2. Gehe zu Meta Business Suite → Unternehmenseinstellungen → System Users, erstelle einen System User, weise dein WABA zu und Generiere ein neues Token mit whatsapp_business_messaging + whatsapp_business_management. Kopiere es — du siehst es nicht noch einmal.
3. Stelle sicher, dass deine Absende-Nummer in API Setup verifiziert ist (die Test-Nummer funktioniert sofort; für Produktion eigene Nummer hinzufügen und verifizieren).

Schritt 2 — WhatsApp-Business-Adapter installieren

git clone https://github.com/HelpCode-ai/anythingmcp.git
cd anythingmcp && docker compose up -d

Öffne http://localhost:3000/connectors/store, klicke WhatsApp Business und trage ein:

Klicke Install — der Adapter ist nun mit 14 Tools in deinem Katalog.

Schritt 3 — phoneNumberId einmalig ermitteln

Bitte Claude, whatsapp_list_phone_numbers aufzurufen (mit deiner WABA ID als businessAccountId). Du erhältst die id jeder Absende-Nummer zurück — diesen Wert fixieren, jedes Send-Tool braucht ihn als phoneNumberId.

Schritt 4 — Connector in Claude hinzufügen (kein Code, 4 Klicks)

Empfohlener Weg — funktioniert auf claude.ai web ohne Anfassen einer Konfigurationsdatei.

1. Öffne claude.ai/customize/connectors.
2. Klicke "Add custom connector".
3. Trage ein:
   • Name: WhatsApp Business
   • URL: https://cloud.anythingmcp.com/mcp
   • Authentication: Bearer Token → MCP-API-Key einfügen (aus AnythingMCP → Profile → MCP API Keys → New Key)
4. Klicke Connect zum Autorisieren.

Fertig. Alle 14 WhatsApp-Tools erscheinen in deinem Chat — leg los mit Prompts.

{
  "mcpServers": {
    "whatsapp-business": {
      "url": "https://cloud.anythingmcp.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_API_KEY"
      }
    }
  }
}

claude mcp add whatsapp-business \
  --transport http \
  --url https://cloud.anythingmcp.com/mcp \
  --header "Authorization: Bearer YOUR_MCP_API_KEY"

Verfügbare Tools (14 insgesamt)

Das 24-Stunden-Fenster — was dein Agent wissen muss

WhatsApp erlaubt Freitext-Nachrichten (Text, Medien, interaktiv, Standort) nur in den 24 Stunden nach der letzten eingehenden Nachricht des Nutzers an deine Nummer. Außerhalb dieses Fensters sind nur vorab genehmigte Vorlagen erlaubt — rufe whatsapp_send_template_message mit Name und Sprache der Vorlage auf.

Das instructions-Feld des Adapters teilt Claude diese Regel mit, sodass Claude bei "sende ein Follow-up an diesen Kunden" Tage nach der letzten Antwort whatsapp_send_template_message statt Freitext nutzt.

Sprachnachrichten

Nutze whatsapp_send_audio mit link auf eine OGG-Opus-Datei auf einer öffentlichen HTTPS-URL. WhatsApp rendert OGG-Opus als echte Sprachnachricht (Wellenform + Play-Button). MP3 und AMR funktionieren, erscheinen aber als reine Audio-Anhänge.

FAQ

Unterstützen Gemini 1.5 Pro oder 2.x MCP? Ja — Gemini CLI ≥ 0.4 und die Vertex AI Tools API akzeptieren MCP httpUrl-Connectors mit Bearer-Header.

Nächste Schritte

• Connector-Landingpage
• Verbinde mit Claude
• Verbinde mit ChatGPT
• Verbinde mit Cursor