WhatsApp Business Tools MCP

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

WhatsApp Business Tools MCP

Für Entwickler, die auf der WhatsApp Business Platform (Cloud API) aufbauen: Mit dem WhatsApp Business Tools MCP-Server kann dein KI-Agent und IDE-Assistent deine WhatsApp-Business-Integration zentral verwalten und debuggen. Der Server ermöglicht einem Agenten, die Unternehmen und WhatsApp-Konten zu finden, die du verwaltest, Telefonnummern einzurichten und zu registrieren, Nachrichtenvorlagen zu erstellen und zu verwalten, Webhooks zu konfigurieren und Nachrichten zu senden – in deinem Namen und für die Apps und Unternehmen, die du verwaltest.

Hinweis: Hinweis: Die Schnittstelle und die Tools des WhatsApp Business Tools MCP-Servers 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	Anmeldung mit Meta-Entwicklerkonto (OAuth)
Client-ID	Nicht erforderlich. Der Server erkennt unterstützte Clients automatisch.
Redirect-URI	Nicht erforderlich. Du musst für diesen Server keine Meta-App erstellen oder konfigurieren.
Unterstützte Clients	Claude Code, Claude Desktop, ChatGPT, Codex CLI, Codex app
Status	Beta – Schnittstelle und Tools können sich ändern

Bevor du beginnst

Um einen Client zu verbinden, benötigst du einen der oben aufgeführten unterstützten Clients in einer aktuellen Version.

Der Server wird schrittweise bereitgestellt und ist möglicherweise noch nicht für dein Konto verfügbar, selbst wenn dein Client eine Verbindung herstellt.

Der Server greift auf deine eigenen Assets zu. Bevor ein Agent die meisten Tools verwenden kann, benötigst du außerdem:

• Administratorzugriff auf ein Unternehmen, das du verwalten möchtest (die Rolle MANAGE).
• Eine WhatsApp-fähige App, bei der du Administrator bist, die mit diesem Unternehmen verbunden ist – eine App mit dem Anwendungsfall WhatsApp Business Messaging (oder dem WhatsApp-Produkt bei einer älteren App). Du musst Administratorzugriff auf die App haben, nicht nur auf das Unternehmen.
• Akzeptierte Nutzungsbedingungen für die WhatsApp Business Cloud API für dieses Unternehmen. Nachrichtenversand und Telefonnummernregistrierung sind gesperrt, bis ein Administrator die Bedingungen akzeptiert.

Fehlt eine Voraussetzung, gibt das Tool einen umsetzbaren Fehler zurück, der dir mitteilt, was du beheben musst, und auf die Seite verweist, auf der du das Problem beheben kannst.

Client verbinden

Um einen unterstützten Client zu verbinden und die OAuth-Autorisierung abzuschließen, folge MCP-Client mit Meta verbinden. Verwende den Servernamen und Endpunkt aus der Übersicht. Für diesen Server ist keine Client-ID erforderlich. Verwende daher die automatische Registrierung.

Berechtigungen

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

Berechtigung	Zugriff
business_management	Unternehmen finden und verwalten, für die du Administrator bist und die du während der Einwilligung ausgewählt hast.
whatsapp_business_management	WhatsApp-Business-Konten, Telefonnummern, Nachrichtenvorlagen und Webhooks verwalten.
whatsapp_business_messaging	Nachrichten von deinen registrierten Telefonnummern senden.

Du kannst diese Berechtigungen auf Facebook unter Einstellungen > Deine Aktivitäten > Business-Integrationen überprüfen und den Zugriff widerrufen.

Verbindung überprüfen

Bitte den Agenten, die Tools aufzulisten, die er von diesem Server verwenden kann. Verwende dazu den Namen, den du ihm beim Verbinden gegeben hast. Führe anschließend ein schreibgeschütztes Tool aus, zum Beispiel whatsapp_biz_businesses, um die Unternehmen aufzulisten, für die du Administrator bist. Die Verbindung funktioniert, wenn dieser Aufruf deine Unternehmen statt eines Authentifizierungs- oder Berechtigungsfehlers zurückgibt.

Ratenbegrenzungen

Anfragen werden pro Benutzer und Tool begrenzt, um die Plattform zu schützen. Wenn du das Limit überschreitest, gibt das Tool einen Ratenbegrenzungsfehler zurück. Versuche es nach kurzer Wartezeit erneut.

Tools

Der WhatsApp Business Tools MCP stellt Tools mit dem Namenspräfix whatsapp_biz_ bereit. Die meisten Tools sind auf ein Unternehmen beschränkt, für das du Administrator bist. Eine typische Sitzung beginnt daher damit, deine Unternehmen aufzulisten und eines auszuwählen. Die verfügbaren Tools werden während der Beta-Phase weiterentwickelt.

Entdecken

• whatsapp_biz_businesses — Liste die Unternehmen auf, für die du Administrator bist und die du während der Einwilligung freigegeben hast. Verwende dieses Tool zuerst, um ein Unternehmen auszuwählen. Beispiel: "Liste die Unternehmen auf, die ich auf WhatsApp verwalten kann."
• whatsapp_biz_accounts — Liste die WhatsApp-Konten (und Messaging-Konten) eines Unternehmens auf. Beispiel: "Zeige die WhatsApp-Konten für Unternehmen 1234567890."
• whatsapp_biz_phone_numbers — Liste die Telefonnummern eines Unternehmens oder WhatsApp-Kontos mit Status und Einrichtungsstatus auf. Beispiel: "Liste die Telefonnummern und ihren Status für dieses Unternehmen auf."

Telefonnummern einrichten

• whatsapp_biz_add_phone_number — Füge einem WhatsApp-Konto eine Telefonnummer hinzu. Beispiel: "Füge meinem WhatsApp-Konto die Telefonnummer +1 555 010 1234 hinzu."
• whatsapp_biz_send_verification_code — Sende einen Bestätigungscode an eine Telefonnummer. Beispiel: "Sende per SMS einen Bestätigungscode an diese Nummer."
• whatsapp_biz_verify_phone_number — Bestätige eine Telefonnummer mit dem erhaltenen Code. Beispiel: "Bestätige diese Nummer mit dem Code 123456."
• whatsapp_biz_register_phone_number — Registriere eine bestätigte Nummer, damit sie Nachrichten senden und empfangen kann. Beispiel: "Registriere diese Nummer für den Nachrichtenversand."

Nachrichtenvorlagen

• whatsapp_biz_list_templates / whatsapp_biz_get_template — Liste die Nachrichtenvorlagen eines Kontos auf und zeige Details dazu an. Beispiel: "Liste die genehmigten Vorlagen für dieses Konto auf."
• whatsapp_biz_create_template / whatsapp_biz_update_template / whatsapp_biz_delete_template — Erstelle, aktualisiere und lösche Nachrichtenvorlagen. Beispiel: "Erstelle eine Marketingvorlage mit dem Namen order_update in en_US."

Nachrichtenversand

• whatsapp_biz_send_message — Sende von einer registrierten Nummer einen frei formulierten Text (wird nur innerhalb des 24-stündigen Kundenservice-Zeitfensters zugestellt) oder eine genehmigte Vorlagennachricht. Bevor die Nachricht gesendet wird, bestätigt das Tool mit dir den Empfänger. Beispiel: "Sende die Vorlage order_update von dieser Nummer an +1 555 010 9999."

Webhooks

• whatsapp_biz_configure_webhooks — Lege die Callback-URL und das Verifizierungstoken für das WhatsApp-Thema fest und abonniere die zulässigen Felder. Beispiel: "Konfiguriere Webhooks für dieses Unternehmen mit dem Callback https://example.com/webhook."
• whatsapp_biz_subscribe_webhook — Abonniere mit einem WhatsApp-Konto die Webhooks deiner App, damit dessen Ereignisse zugestellt werden. Beispiel: "Abonniere mit diesem WhatsApp-Konto die Webhooks."

Kontoeinrichtung

• whatsapp_biz_configure_payments — Richte eine Zahlungsmethode ein, damit das Konto kostenpflichtige Nachrichten senden kann. Beispiel: "Hilf mir, Zahlungen für dieses Konto einzurichten."
• whatsapp_biz_verify_business — Prüfe den Status der Unternehmensverifizierung und starte die Verifizierung. Beispiel: "Wie ist der Status der Unternehmensverifizierung, und wie kann ich sie starten?"
• whatsapp_biz_system_user_token — Rufe einen Link auf, über den du ein Systembenutzer-Zugriffstoken für dein Unternehmen erstellen kannst. Damit kannst du eine eigene Messaging-Lösung entwickeln, die die WhatsApp Cloud API direkt aufruft. Die Token-Erstellung erfolgt sicher in den Unternehmenseinstellungen. Das Tool gibt einen Deeplink zur Seite Systembenutzer zurück, auf der du einen Systembenutzer auswählst und das Token erstellst. Weitere Informationen findest du unter Systembenutzer erstellen und ein dauerhaftes Zugriffstoken generieren. Beispiel: "Gib mir einen Link, über den ich ein Systembenutzer-Zugriffstoken für dieses Unternehmen erstellen kann."

Feedback

Wenn du Feedback hast oder dir weitere Tools wünschst, teile uns dein Feedback mit.

Verwandte Themen

• MCP-Übersicht
• MCP-Client mit Meta verbinden
• Dokumentation zur WhatsApp Business Platform

---

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