WhatsApp Business mit Claude verbinden (MCP)

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → WhatsApp Business klicken, dauerhaftes System-User-Access-Token + WhatsApp Business Account ID einfügen, Claude verbinden — 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 Claude fragen kannst

• "Sende 'Deine Bestellung wurde verschickt — verfolge sie auf https://acme.com/t/12345' an +49 151 5123 4567." Nutzt whatsapp_send_text_message (nur im 24-Stunden-Fenster, siehe unten).
• "Sende die Vorlage bestellbestaetigung (de) an +49 30 12345678, fülle 'Anna' und 'ORD-9912' ein." Nutzt whatsapp_send_template_message.
• "Sende das Rechnungs-PDF von https://acme.com/inv/9912.pdf an meinen Kunden mit Untertitel 'Rechnung 9912'." Nutzt whatsapp_send_document.
• "Liste die genehmigten Vorlagen auf meinem WABA und sende dann die Willkommensvorlage auf Deutsch an diesen neuen Lead." Nutzt whatsapp_list_message_templates, dann whatsapp_send_template_message.
• "Lass den Kunden ein Lieferfenster wählen: vormittags, nachmittags oder abends." Nutzt whatsapp_send_interactive_buttons (bis zu drei Antwort-Buttons).
• "Aktualisiere unser WhatsApp-Unternehmensprofil: neue Adresse und Öffnungszeiten in der Beschreibung." Nutzt whatsapp_update_business_profile.

Was du brauchst

• Ein WhatsApp Business Account (WABA) mit mindestens einer verifizierten Absende-Nummer. Metas Test-Nummer reicht zum Ausprobieren, sendet aber nur an Nummern, die du als Tester eingetragen hast.
• 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).
• Genehmigte Nachrichtenvorlagen für alles, was du außerhalb des 24-Stunden-Fensters sendest. Du legst sie in der Meta Business Suite an; Meta muss sie freigeben, bevor sie versendet werden können.
• AnythingMCP lokal oder auf cloud.anythingmcp.com (3-Minuten-Setup).
• Claude Desktop, Claude Code oder ein claude.ai-Konto.

Meta berechnet WhatsApp-Business-Nachrichten nach seiner eigenen Preisliste, unabhängig von AnythingMCP; die Preise für deine Länder findest du auf Metas WhatsApp-Preisseite.

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

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

Ö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. Das Tool liest die Nummern des eingerichteten WABA und liefert die id jeder Absende-Nummer — diesen Wert fixieren, jedes Send-Tool braucht ihn als phoneNumberId. Eine Standardnummer wählt der Connector nicht für dich.

Empfänger kommen im internationalen Format ins Feld to, Ländervorwahl zuerst und ohne +: 4915151234567 für ein deutsches Handy, 15551234567 für die USA.

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

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.

Empfohlener Weg — funktioniert auf claude.ai web ohne Anfassen einer Konfigurationsdatei, und danach ist der Connector auch in Claude Desktop verfügbar.

1. Öffne claude.ai/customize/connectors.
2. Klicke auf + und dann auf "Add custom connector".
3. Gib als Namen AnythingMCP und als URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID ein.
4. Klicke auf "Add" und dann auf "Connect". Melde dich bei AnythingMCP an und wähle, welche deiner MCP-Server Claude nutzen darf.

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

claude mcp add --transport http anythingmcp https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID

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.

Fehlerbehebung

• Gestern ging alles, heute wird jeder Aufruf abgelehnt. Wahrscheinlich nutzt du noch das temporäre Access-Token aus API Setup, das nach 24 Stunden abläuft. Erzeuge ein dauerhaftes System-User-Token und ersetze WHATSAPP_ACCESS_TOKEN.
• Senden scheitert, Vorlagen lesen klappt. Dem System-User-Token fehlt whatsapp_business_messaging, oder der System User ist diesem WABA nicht zugewiesen. Du brauchst beide Berechtigungen: whatsapp_business_management für Vorlagen und Nummern, whatsapp_business_messaging zum Senden.
• Eine Vorlage wird abgelehnt. Die Vorlage ist noch nicht APPROVED, oder Name oder Sprachcode stimmen nicht exakt. Lass Claude das vorher mit whatsapp_list_message_templates prüfen.
• Ein Bild oder Dokument kommt nie an. Der link muss eine öffentliche HTTPS-URL sein, die Metas Server herunterladen können, innerhalb der WhatsApp-Größenlimits (Bild 5 MB, Audio und Video 16 MB, Dokument 100 MB).
• Die Empfängernummer wird abgelehnt. Nutze das internationale Format ohne +, Leerzeichen oder führende Null, zum Beispiel 4915151234567.

FAQ

Funktioniert das ohne verifizierte Geschäftsnummer? Metas Test-Nummer funktioniert zum Testen (nur Versand an als Tester hinzugefügte Nummern). Für Produktionsversand an beliebige Empfänger muss deine Absende-Nummer verifiziert und auf deinem WABA registriert sein.

Was passiert, wenn ich Freitext außerhalb des 24h-Fensters sende? Meta antwortet mit Fehlercode 131047 ("Re-engagement message"). Nutze whatsapp_send_template_message.

Kann der Adapter eingehende Nachrichten empfangen? Nicht direkt — Meta nutzt Webhooks für Inbound, und die AnythingMCP REST-Engine ist nur outbound. Betreibe einen kleinen Webhook-Receiver neben AnythingMCP und nutze diesen Connector für outbound + whatsapp_mark_message_as_read für Lesebestätigungen.

Funktioniert es mit Claude Code genauso wie mit Claude Desktop? Ja. Ein Custom Connector, den du auf claude.ai hinzufügst, steht auch in Claude Desktop zur Verfügung, und in Claude Code fügst du dieselbe URL mit claude mcp add --transport http hinzu. Custom Connectors gibt es in jedem Claude-Tarif; im Free-Tarif ist einer erlaubt, und das reicht, weil ein einziger AnythingMCP-Connector alle deine Connectoren mitbringt.

Ist das kostenlos? AnythingMCP ist Open Source unter AGPL-3.0: Self-Hosting ist kostenlos, auch für die kommerzielle Nutzung in deinem eigenen Unternehmen; AnythingMCP Cloud kannst du 7 Tage kostenlos testen. Die WhatsApp-Nachrichten selbst rechnet Meta nach seinen Preisen ab.

Speichert AnythingMCP meine Daten? Dein Meta-Access-Token liegt verschlüsselt (AES-256-GCM) in deinem Workspace und wird Claude nie gezeigt. AnythingMCP reicht jede Sendeanfrage an Meta weiter und die Antwort zurück an Claude, und jeder Aufruf landet im Audit-Log deines Workspaces. Eingehende Nachrichten erreichen AnythingMCP nie; sie gehen an deinen eigenen Webhook.

Nächste Schritte

• Connector-Landingpage
• Verbinde mit ChatGPT
• Verbinde mit Cursor
• Verbinde mit Gemini
• Verbinde mit Meta Muse