WhatsApp Business mit Meta Muse 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, Muse 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 Muse 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 Meta Muse in Klartext. Kein SDK zu kleben, kein JSON-von-Hand für jeden Nachrichtentyp.

Was du Muse 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).
• Zugang zu Meta Muse (verfügbar in den USA und in Kanada).

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 Muse, 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 Muse 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.

Muse bindet Remote-MCP-Server als Custom Connectors ein und meldet sich per OAuth bei ihnen an.

1. Öffne in Muse Settings → Connectors und wähle Add custom connector.
2. Füge die MCP-Server-URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID ein.
3. Muse öffnet die Anmeldeseite von AnythingMCP: Melde dich an und bestätige den Zugriff.
4. Bitte Muse im Chat um etwas, wofür es die WhatsApp Business-Tools braucht.

Du kannst den Connector auch per Chat einrichten, im Web, in den Apps für iOS und Android oder in WhatsApp. Schick Muse diese Nachricht:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Muse verbindet sich aus der Cloud von Meta, localhost funktioniert deshalb nicht.

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 Muse diese Regel mit, sodass Muse 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 Muse 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.

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 Muse nie gezeigt. AnythingMCP reicht jede Sendeanfrage an Meta weiter und die Antwort zurück an Muse, und jeder Aufruf landet im Audit-Log deines Workspaces. Eingehende Nachrichten erreichen AnythingMCP nie; sie gehen an deinen eigenen Webhook.

Wo ist Muse verfügbar? Meta bietet Muse derzeit in den USA und in Kanada an, im Web, in den Apps für iOS und Android und in WhatsApp.

Prüft Meta diesen Connector? Nein. Meta prüft Custom Connectors nicht. Muse sieht nur die Tools, die du in AnythingMCP für diesen MCP-Server eingeschaltet hast, und du kannst den Connector jederzeit unter Settings → Connectors trennen.

Nächste Schritte

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