WhatsApp Business MCP: Claude Code, Codex und ChatGPT verbinden

Am 15. September 2026 hat Meta den offiziellen WhatsApp Business Tools MCP-Server veröffentlicht. Er verbindet einen KI-Agenten – Claude Code, Codex, ChatGPT oder Cursor – mit der WhatsApp Business Platform. Statt zwischen Developer Console, Business Manager und API-Dokumentation zu wechseln, beschreiben Sie dem Agenten die Aufgabe. Er fügt eine Nummer hinzu, erstellt eine Nachrichtenvorlage, konfiguriert Webhooks und sendet eine Testnachricht.

Der Server befindet sich noch in der Betaphase: Der Zugriff wird schrittweise freigeschaltet, und die Veröffentlichung ist für Entwicklung und Tests vorgesehen, nicht für den Messaging-Betrieb in großem Maßstab. Im Folgenden finden Sie die Vorbereitungen und Verbindungsschritte für vier Clients. Die Befehle und Einstellungen wurden am 18. September 2026 anhand der offiziellen Dokumentation von Meta überprüft.

Informationen zur Arbeit mit Ailoot finden Sie in der Dokumentation.

Was ist WhatsApp Business Tools MCP?#

MCP (Model Context Protocol) ist ein offener Standard, um externe Systeme mit KI-Agenten zu verbinden. Mehr dazu erfahren Sie im Artikel MCP-Server für Claude Code: 7 sofort nutzbare Integrationen. Überprüfte Verbindungen mit Installationsbefehlen finden Sie im MCP-Katalog.

Vor dieser Veröffentlichung sah die Einrichtung einer WhatsApp-Integration so aus: Developer Console öffnen, eine App erstellen, ein Unternehmen verknüpfen, eine Telefonnummer hinzufügen, sie mit einem Code verifizieren, ein Token generieren, einen Webhook konfigurieren, die API-Dokumentation prüfen – und erst dann die erste Codezeile schreiben.

Meta beschreibt die Idee hinter dem Server so (aus dem Englischen übersetzt):

Meta bietet inzwischen zwei MCP-Server an, die leicht zu verwechseln sind. Meta Social Technologies MCP ist ein allgemeines Entwickler-Tool: Es dient dazu, Dokumentation zu durchsuchen, Graph-API-Endpunkte zu finden und App-Fehler zu diagnostizieren. WhatsApp Business Tools MCP ist für die Arbeit mit WhatsApp-Konten, Telefonnummern, Vorlagen, Webhooks und Testnachrichten gedacht. Die beiden ergänzen einander, und Sie können bei Bedarf beide verbinden.

Was kann der Agent nach dem Verbinden genau tun?#

Die Tools des Servers sind unter dem Präfix whatsapp_biz_ gruppiert. Laut offizieller Dokumentation:

• Übersicht: whatsapp_biz_businesses, whatsapp_biz_accounts, whatsapp_biz_phone_numbers – welche Unternehmen, Konten und Telefonnummern für Sie verfügbar sind.
• Telefonnummer einrichten: whatsapp_biz_add_phone_number, whatsapp_biz_send_verification_code, whatsapp_biz_verify_phone_number, whatsapp_biz_register_phone_number.
• Vorlagen: whatsapp_biz_list_templates, whatsapp_biz_get_template, whatsapp_biz_create_template, whatsapp_biz_update_template, whatsapp_biz_delete_template.
• Nachrichten: whatsapp_biz_send_message – Freitext innerhalb des 24-Stunden-Unterhaltungsfensters oder eine genehmigte Vorlage außerhalb dieses Fensters; der Agent bestätigt den Empfänger vor dem Versand mit Ihnen.
• Webhooks: whatsapp_biz_configure_webhooks, whatsapp_biz_subscribe_webhook.
• Kontoeinrichtung: whatsapp_biz_configure_payments, whatsapp_biz_verify_business, whatsapp_biz_system_user_token – ein Link zum Erstellen eines System-User-Tokens für direkte Cloud-API-Aufrufe.

Wenn ein Kunde dem Unternehmen zuerst schreibt, beginnt ein Kundenservice-Zeitfenster: 24 Stunden lang können Sie mit Freitext antworten. Jede neue Nachricht des Kunden verlängert das Zeitfenster. Nach dessen Ablauf können Sie den Kunden nur noch mit einer genehmigten Vorlage kontaktieren. Der Agent kennt diese Regel und schlägt eine Vorlage statt einer gewöhnlichen Textnachricht vor, wenn der Empfänger außerhalb des Zeitfensters liegt.

Der Server verfügt über integrierte Zugriffskontrollen. Sie melden sich mit Ihrem Meta-Konto an und wählen bestimmte Unternehmen aus; Tokens werden nicht in den Gesprächsverlauf aufgenommen. Jeder Lesezugriff erfolgt in Ihrem Kontext, Aufrufe werden protokolliert und Änderungen erfordern eine authentifizierte Person; ein App-Schlüssel des Servers allein reicht nicht aus.

Was sollten Sie vor dem Verbinden prüfen?#

Der Server handelt in Ihrem Auftrag und greift nur auf Ihre Ressourcen zu. Prüfen Sie daher vor dem ersten Aufruf Folgendes:

1. Sie haben ein Meta-Unternehmen, bei dem Sie Administrator sind (Rolle MANAGE).
2. Sie haben eine Meta-App, in der das Szenario WhatsApp Business Messaging aktiviert ist (oder das WhatsApp-Produkt bei älteren Apps), und Sie sind Administrator genau dieser App; Berechtigungen auf Unternehmensebene allein reichen nicht aus.
3. Die Nutzungsbedingungen für die WhatsApp Business Cloud API wurden für das Unternehmen akzeptiert – andernfalls sind die Registrierung von Telefonnummern und der Versand gesperrt.

Meta zufolge treten Probleme mit Nutzungsbedingungen, Zahlungsmethoden und der Unternehmensverifizierung oft ohne klare Erklärung auf. Der Agent prüft diese Punkte im Voraus und stellt einen direkten Link bereit, über den Sie die Bedingungen akzeptieren, eine Zahlungsmethode angeben oder die Unternehmensverifizierung starten können.

Wie verbinden Sie den Server mit Claude Code?#

Wenn Claude Code noch nicht installiert ist, beginnen Sie mit der Anleitung So installieren Sie Claude Code von der offiziellen Website.

1. Server hinzufügen

   Führen Sie im Terminal Folgendes aus:

   claude mcp add --transport http whatsapp_business_tools https://mcp.facebook.com/whatsapp_business_tools
   

   Der Server ist remote, Sie müssen ihn also nicht lokal installieren.

2. Über Meta anmelden

   Geben Sie in einer Claude-Code-Sitzung /mcp ein und wählen Sie whatsapp_business_tools. Ein Browserfenster zur Anmeldung bei Ihrem Meta-Konto wird geöffnet. Falls sich der Browser nicht öffnet, kopieren Sie den Link aus dem Client und öffnen Sie ihn manuell.

3. Berechtigungen erteilen

   Wählen Sie auf dem Zustimmungsbildschirm die Unternehmen und Apps mit WhatsApp aus, denen Sie Zugriff gewähren möchten. Der Server fordert drei Berechtigungen an: business_management (Unternehmen finden, bei denen Sie Administrator sind), whatsapp_business_management (Konten, Telefonnummern, Vorlagen, Webhooks) und whatsapp_business_messaging (Nachrichten von Ihren Nummern senden).

4. Verbindung prüfen

   Starten Sie Claude Code neu, melden Sie sich erneut über /mcp an und fragen Sie den Agenten, welche Tools er auf dem Server whatsapp_business_tools sehen kann. Führen Sie anschließend eine sichere Leseabfrage aus: „Liste die Unternehmen auf, die ich verwalten kann“ – der Agent ruft whatsapp_biz_businesses auf. Wenn keine Tools angezeigt werden oder ein Anmeldefehler auftritt, prüfen Sie die Serveradresse und melden Sie sich erneut an.

Die OAuth-Anmeldung ist an den Start des Clients gebunden: Nach einem Neustart von Claude Code müssen Sie sich erneut anmelden. Sie können den Zugriff jederzeit in den Einstellungen auf facebook.com unter „Business Integrations“ widerrufen.

Wie verbinden Sie Codex, ChatGPT und Claude Desktop?#

Codex App. Öffnen Sie die Einstellungen (das Zahnrad unten links), gehen Sie zu MCP Servers und wählen Sie Add servers. Wählen Sie Streamable HTTP und geben Sie Folgendes ein:

• Name: WhatsApp Business Tools
• URL: https://mcp.facebook.com/whatsapp_business_tools
• Authentication: OAuth

Klicken Sie auf Authenticate und melden Sie sich im Browser an.

ChatGPT. Settings, Plugins, Browse plugins, das Symbol „+“ oben rechts. Geben Sie einen Namen, dieselbe URL und OAuth als Authentifizierungstyp ein.

Claude Desktop. Settings, Connectors, Add custom connector. Name: WhatsApp Business Tools; URL: dieselbe Serveradresse.

Folgen Sie nach dem Hinzufügen in einem beliebigen Client derselben Prüfsequenz: neu starten, erneut anmelden, die Tool-Liste anzeigen und die Liste der Unternehmen sicher auslesen.

Was passiert in der ersten Sitzung: von der Unternehmensliste bis zur Testnachricht?#

Eine typische erste Sitzung mit dem verbundenen Server:

1. „Liste die Unternehmen auf, die ich verwalte“ – der Agent ruft whatsapp_biz_businesses auf, und Sie wählen das gewünschte Unternehmen aus.
2. „Zeig mir die WhatsApp-Konten und Telefonnummern dieses Unternehmens“ – whatsapp_biz_accounts und whatsapp_biz_phone_numbers, jeweils mit Status.
3. „Füge meine Testtelefonnummer zum Konto hinzu“ – whatsapp_biz_add_phone_number.
4. „Sende einen Bestätigungscode per SMS“ – whatsapp_biz_send_verification_code. Der Code kommt auf Ihrem Telefon an.
5. „Verifiziere die Nummer mit dem Code 123456“ – whatsapp_biz_verify_phone_number, danach registrieren Sie sie mit whatsapp_biz_register_phone_number.
6. „Erstelle eine order_update-Vorlage in der von den Empfängern bevorzugten Sprache für Bestellbenachrichtigungen“ – whatsapp_biz_create_template; der Agent stellt einen Link zum Genehmigungsstatus bereit.
7. „Sende eine Testnachricht an meine Nummer“ – whatsapp_biz_send_message; der Agent bestätigt vor dem Versand den Empfänger.
8. „Konfiguriere einen Webhook unter https://example.com/webhook“ – whatsapp_biz_configure_webhooks und anschließend mit whatsapp_biz_subscribe_webhook abonnieren.

Danach treffen die eingehenden Nachrichten der Kunden an der angegebenen Adresse ein – in der Regel ruft dort ein CRM, ein Kundenservice oder ein Bot sie ab. Die Verarbeitung richten Sie separat an dieser Adresse ein; der Server übernimmt nur die Konfiguration.

Welche Einschränkungen hat die Betaversion?#

Es gibt vier Einschränkungen des Servers, die Sie beachten sollten.

Betastatus. Meta weist darauf hin, dass sich die Schnittstelle und die verfügbaren Tools ändern können und der Zugriff schrittweise freigeschaltet wird. Wenn Sie noch keine Verbindung zum Server herstellen können, wurde er möglicherweise noch nicht für Sie freigegeben.

Zweck. Die Veröffentlichung ist für Entwicklung und Tests vorgesehen, nicht für den Massenversand in der Produktion. Für Messaging in der Produktion benötigen Sie eine vollständige Integration mit der Cloud API – zum Beispiel mit einem System-User-Token, dessen Link das Tool whatsapp_biz_system_user_token bereitstellt.

Limits. Für jedes Tool gelten Anfragelimits pro Benutzer. Wenn Sie das Limit überschreiten, gibt das Tool einen Limitfehler zurück – warten Sie und versuchen Sie es erneut.

Regel zum 24-Stunden-Zeitfenster. Außerhalb des Kunden-Unterhaltungsfensters können Sie nur genehmigte Vorlagen senden.

Warum ist das für ein Unternehmen wichtig?#

Ein typisches Szenario für ein kleines Unternehmen: Kunden schreiben über WhatsApp, und Sie möchten schnell antworten und Benachrichtigungen zum Bestellstatus versenden. Bisher bedeutete die Grundeinrichtung, selbst in mehreren Meta-Dashboards zu arbeiten oder einen Entwickler zu beauftragen. Jetzt können Sie diesen Teil in einem Gespräch mit einem Agenten erledigen. Die Verarbeitung eingehender Nachrichten an Ihrer eigenen Adresse richten Sie weiterhin separat ein – das ist die nächste Aufgabe nach der Konfiguration des Webhooks.

Der Server ist auch nützlich, wenn Ihre Integration bereits läuft. Nachrichtenvorlagen müssen regelmäßig aktualisiert werden: eine neue Aktion, ein neuer Benachrichtigungstext. Über den Server erstellt oder bearbeitet der Agent eine Vorlage und zeigt ihren Genehmigungsstatus an, ohne Sie zum Dashboard zu schicken.

Ein ähnlicher Ansatz – ein Agent verbindet sich mit einem externen System und arbeitet anhand Ihrer Beschreibung damit – wird mit Dokumentation in der Anleitung So verbinden Sie NotebookLM über MCP mit Claude Code gezeigt.

Wie geht es weiter?#

Seit der Ankündigung des Servers sind drei Tage vergangen. Sie können mit einem Befehl beginnen und sich über Meta anmelden, dann den Agenten nach einer Liste Ihrer Unternehmen fragen. Als Nächstes kommen je nach Bedarf Telefonnummern, Vorlagen, Webhooks und Testnachrichten.

Weitere Möglichkeiten, einen Agenten mit externen Systemen zu verbinden, finden Sie in der Sammlung MCP-Server für Claude Code – dort gibt es sieben weitere funktionierende Integrationen für verschiedene Aufgaben.

Lernen Sie Ailoot kennen.