WhatsApp Business Tools MCP

npx add-mcp 'https://mcp.facebook.com/whatsapp_business_tools'

Für Entwickler, die auf der WhatsApp Business Platform (Cloud API) aufbauen – der WhatsApp Business Tools MCP-Server ermöglicht es Ihrem KI-Agenten und IDE-Assistenten, Ihre WhatsApp Business-Integration von einem Ort aus zu verwalten und zu debuggen. Er ermöglicht einem Agenten, die Unternehmen und WhatsApp-Konten zu entdecken, die Sie verwalten, Telefonnummern zu onboarden und zu registrieren, Nachrichtenvorlagen zu erstellen und zu verwalten, Webhooks zu konfigurieren und Nachrichten zu senden – in Ihrem Namen, auf den Apps und Unternehmen, die Sie verwalten.

Hinweis: Der WhatsApp Business Tools MCP-Server wird schrittweise eingeführt und ist möglicherweise noch nicht für alle verfügbar. Die Oberfläche und der Tool-Satz befinden sich in der Beta-Phase und können sich ändern.

Übersicht

Die folgende Tabelle fasst die Serverdetails zusammen:

Attribut	Wert
Servername	WhatsApp Business Tools
Transport	Streamable HTTP
Endpunkt	https://mcp.facebook.com/whatsapp_business_tools
Authentifizierung	Meta-Entwicklerkonto-Anmeldung (OAuth)
Status	Beta – Oberfläche und Tool-Satz können sich ändern

Voraussetzungen

Der Server arbeitet mit Ihren eigenen Assets, daher benötigen Sie, bevor ein Agent die meisten Tools verwenden kann:

• Admin-Zugriff auf ein Unternehmen, das Sie verwalten möchten (die Rolle MANAGE).
• Eine WhatsApp-fähige App, bei der Sie Admin sind, die mit diesem Unternehmen verbunden ist – eine App mit dem Anwendungsfall WhatsApp Business Messaging (oder das WhatsApp-Produkt auf einer älteren App). Sie müssen Admin-Zugriff auf die App haben, nicht nur auf das Unternehmen.
• Akzeptierte WhatsApp Business Cloud API-Nutzungsbedingungen für dieses Unternehmen. Nachrichtenübermittlung und Telefonnummernregistrierung sind blockiert, bis ein Admin sie akzeptiert.

Wenn eine Voraussetzung fehlt, gibt das Tool einen umsetzbaren Fehler zurück, der Ihnen mitteilt, was zu beheben ist, und verlinkt die Seite, auf der Sie es beheben können.

Einrichten Ihres IDE- oder Agenten-Clients

Der WhatsApp Business Tools MCP-Server ist ein Remote-Server. Clients, die Remote-MCP-Server unterstützen, können sich direkt mit dem Endpunkt verbinden. Für Clients, die nur lokale (stdio) Server unterstützen, verwenden Sie die mcp-remote-Brücke, die den Remote-Server über stdio proxyt.

Konfigurieren Sie Ihren Client mit einem der folgenden Abschnitte und schließen Sie dann die OAuth-Anmeldung ab, um sich zu authentifizieren.

Claude Code und Desktop

Claude Code – führen Sie den folgenden Befehl aus, um den Server hinzuzufügen:

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

Führen Sie dann /mcp in einer Sitzung aus und wählen Sie whatsapp_business_tools, um sich zu authentifizieren.

Claude Desktop – öffnen Sie Einstellungen > Connectors > Benutzerdefinierten Connector hinzufügen und legen Sie dann fest:

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

OpenAI Codex App und ChatGPT

Codex App – öffnen Sie Einstellungen (das Zahnradsymbol unten links) > MCP-Server > Server hinzufügen, wählen Sie Streamable HTTP und legen Sie dann fest:

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

Klicken Sie auf Authentifizieren und schließen Sie die OAuth-Anmeldung ab.

ChatGPT – öffnen Sie Einstellungen > Plugins > Plugins durchsuchen, klicken Sie oben rechts auf +, um ein neues Plugin hinzuzufügen, und legen Sie dann fest:

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

Speichern Sie das Plugin und schließen Sie die OAuth-Anmeldung ab.

OAuth-Anmeldung

Der WhatsApp Business Tools MCP-Server authentifiziert sich über OAuth mit Ihrem Meta-Entwicklerkonto, sodass derselbe Anmeldevorgang mit jedem Client funktioniert.

Anmeldevorgang

Nachdem Sie den Server zu Ihrem Client hinzugefügt haben (siehe Einrichten Ihres IDE- oder Agenten-Clients):

1. Starten Sie die Verbindung. Viele Clients beginnen den OAuth-Vorgang automatisch, wenn der Server hinzugefügt wird. Andere erfordern, dass Sie zuerst auf Verbinden oder Authentifizieren klicken.
2. Melden Sie sich an. Ihr Browser öffnet sich, um sich mit Ihrem Meta-Konto anzumelden. Wenn er sich nicht automatisch öffnet, kopieren Sie den Link, den Ihr Client ausgibt, und öffnen Sie ihn manuell.
3. Gewähren Sie Zugriff. Wählen Sie auf dem Zustimmungsbildschirm die Unternehmen und WhatsApp-fähigen Apps aus, auf die der Server zugreifen soll.
4. Bestätigen Sie. Kehren Sie zu Ihrem Client zurück und überprüfen Sie Ihre Verbindung.

Sie müssen den Anmeldevorgang erneut durchführen, wenn Sie den Client neu starten.

Bereiche

Der Server fordert während der Zustimmung die folgenden Berechtigungen an:

Bereich	Zugriff
business_management	Unternehmen entdecken und darauf zugreifen, die Sie verwalten und die Sie während der Zustimmung ausgewählt haben.
whatsapp_business_management	WhatsApp Business-Konten, Telefonnummern, Nachrichtenvorlagen und Webhooks verwalten.
whatsapp_business_messaging	Nachrichten von Ihren registrierten Telefonnummern senden.

Sie können den Zugriff jederzeit unter facebook.com > Einstellungen > Business-Integrationen überprüfen oder widerrufen.

Verbindung überprüfen

Nachdem Sie den Server hinzugefügt haben, bestätigen Sie, dass Ihr Agent die Tools sehen kann:

1. Starten Sie den IDE- oder Agenten-Client neu.
2. Bitten Sie den Agenten, die Tools aufzulisten, die er vom whatsapp_business_tools-Server hat.
3. Führen Sie ein risikoarmes Lese-Tool aus. Bitten Sie ihn beispielsweise, die Unternehmen aufzulisten, die Sie mit whatsapp_biz_businesses verwalten.

Wenn der Agent keine Tools oder einen Authentifizierungsfehler meldet, überprüfen Sie die Endpunkt-URL erneut und bestätigen Sie, dass Sie den Anmeldevorgang abgeschlossen haben.

Tools

Der WhatsApp Business Tools MCP stellt Tools bereit, die mit dem Präfix whatsapp_biz_ versehen sind. Die meisten Tools sind auf ein Unternehmen beschränkt, das Sie verwalten, sodass eine typische Sitzung damit beginnt, Ihre Unternehmen aufzulisten und eines auszuwählen. Der Tool-Satz entwickelt sich während der Beta-Phase weiter.

Entdeckung

• whatsapp_biz_businesses – Listen Sie die Unternehmen auf, die Sie verwalten und die Sie während der Zustimmung gewährt haben. Verwenden Sie dies zuerst, um ein Unternehmen auszuwählen. Beispiel: „Listen Sie die Unternehmen auf, die ich auf WhatsApp verwalten kann.“
• whatsapp_biz_accounts – Listen Sie die WhatsApp-Konten (und Messaging-Konten) unter einem Unternehmen auf. Beispiel: „Zeigen Sie die WhatsApp-Konten für Unternehmen 1234567890 an.“
• whatsapp_biz_phone_numbers – Listen Sie die Telefonnummern eines Unternehmens oder WhatsApp-Kontos mit Status und Onboarding-Zustand auf. Beispiel: „Listen Sie die Telefonnummern und ihren Status für dieses Unternehmen auf.“

Telefonnummern-Onboarding

• whatsapp_biz_add_phone_number – Fügen Sie einem WhatsApp-Konto eine Telefonnummer hinzu. Beispiel: „Fügen Sie die Telefonnummer +1 555 010 1234 zu meinem WhatsApp-Konto hinzu.“
• whatsapp_biz_send_verification_code – Senden Sie einen Verifizierungscode an eine Telefonnummer. Beispiel: „Senden Sie einen Verifizierungscode per SMS an diese Nummer.“
• whatsapp_biz_verify_phone_number – Verifizieren Sie eine Telefonnummer mit dem erhaltenen Code. Beispiel: „Verifizieren Sie diese Nummer mit Code 123456.“
• whatsapp_biz_register_phone_number – Registrieren Sie eine verifizierte Nummer, damit sie senden und empfangen kann. Beispiel: „Registrieren Sie diese Nummer für Messaging.“

Nachrichtenvorlagen

• whatsapp_biz_list_templates / whatsapp_biz_get_template – Listen Sie Nachrichtenvorlagen auf einem Konto auf und prüfen Sie sie. Beispiel: „Listen Sie die genehmigten Vorlagen für dieses Konto auf.“
• whatsapp_biz_create_template / whatsapp_biz_update_template / whatsapp_biz_delete_template – Erstellen, aktualisieren und löschen Sie Nachrichtenvorlagen. Beispiel: „Erstellen Sie eine Marketing-Vorlage namens order_update in en_US.“

Messaging

• whatsapp_biz_send_message – Senden Sie eine Freitext-Nachricht (nur innerhalb des 24-Stunden-Kundenservice-Fensters zustellbar) oder eine genehmigte Vorlagennachricht von einer registrierten Nummer. Bestätigt das Ziel vor dem Senden mit Ihnen. Beispiel: „Senden Sie die order_update-Vorlage an +1 555 010 9999 von dieser Nummer.“

Webhooks

• whatsapp_biz_configure_webhooks – Legen Sie die Callback-URL und das Verifizierungstoken für das WhatsApp-Thema fest und abonnieren Sie die zulässigen Felder. Beispiel: „Konfigurieren Sie Webhooks für dieses Unternehmen mit Callback https://example.com/webhook."
• whatsapp_biz_subscribe_webhook – Abonnieren Sie ein WhatsApp-Konto für die Webhooks Ihrer App, damit deren Ereignisse zugestellt werden. Beispiel: „Abonnieren Sie dieses WhatsApp-Konto für Webhooks.“

Kontoeinrichtung

• whatsapp_biz_configure_payments – Konfigurieren Sie eine Zahlungsmethode, damit das Konto abrechenbare Nachrichten senden kann. Beispiel: „Helfen Sie mir, Zahlungen für dieses Konto einzurichten.“
• whatsapp_biz_verify_business – Prüfen und starten Sie die Unternehmensverifizierung. Beispiel: „Wie ist der Status der Unternehmensverifizierung und wie starte ich sie?“
• whatsapp_biz_system_user_token – Erhalten Sie einen Link zum Generieren eines Systembenutzer-Zugriffstokens für Ihr Unternehmen, damit Sie eine benutzerdefinierte Messaging-Lösung erstellen können, die die WhatsApp Cloud API direkt aufruft. Die Tokengenerierung erfolgt sicher in den Business-Einstellungen – das Tool gibt einen Deep-Link zur Seite Systembenutzer zurück, auf der Sie einen Systembenutzer auswählen und das Token generieren. Weitere Informationen finden Sie unter <a href="/documentation/business-messaging/whatsapp/get-started#step-5-create-a-system-user-and-generate-a-permanent-access-token" target="_blank">Systembenutzer erstellen und permanentes Zugriffstoken generieren</a>. Beispiel: „Geben Sie mir einen Link, um ein Systembenutzer-Zugriffstoken für dieses Unternehmen zu erstellen.“

Ratenbegrenzungen

Anfragen werden pro Benutzer und Tool ratenbegrenzt, um die Plattform zu schützen. Wenn Sie das Limit überschreiten, gibt das Tool einen Ratenbegrenzungsfehler zurück; wiederholen Sie den Vorgang nach einer kurzen Wartezeit.

Feedback

Wenn Sie Feedback haben oder weitere Tools sehen möchten, teilen Sie Ihr Feedback mit.

Verwandte Themen

• MCP-Übersicht
• WhatsApp Business Platform-Dokumentation

---

Vollständiger Dokumentationsindex für dieses Produkt: https://developers.facebook.com/documentation/mcp/llms.txt