WhatsApp-MCP-Server: KI-Agenten mit WhatsApp und SMS verbinden
Wie ein WhatsApp-MCP-Server Claude, Cursor und andere KI-Agenten sicher WhatsApp und SMS senden lässt: Einrichtung, Leitplanken, Einwilligung, Anwendungsfälle.
Von OmniChannels.ai Editorial Team · Geprüft von BroadNet Messaging Solutions Team
Integration
Kurze Antwort
Ein WhatsApp-MCP-Server stellt Messaging-Operationen als Tools bereit, die ein KI-Agent über das Model Context Protocol entdecken und aufrufen kann. Mit dem MCP-Server von OmniChannels.ai unter https://mcp.broadnet.me/mcp authentifiziert sich ein Client wie Claude Code oder Cursor mit einem Bearer-Token und kann SMS- und WhatsApp-Nachrichten senden, Vorlagen auflisten und Zustellberichte lesen. Der Agent handelt mit den Berechtigungen Ihres Accounts, daher sind Leitplanken wichtig.
Auf dieser Seite
- Was ist ein WhatsApp-MCP-Server?
- Wie funktioniert der MCP-Server von OmniChannels.ai?
- Wie verbinde ich Claude, Cursor oder einen anderen Client?
- Was kann ein KI-Agent mit WhatsApp und SMS tun?
- Wie verhindere ich, dass ein KI-Agent die falschen Personen anschreibt?
- Welche Regeln für WhatsApp und SMS gelten weiterhin?
- Praxisbeispiel: ein Support-Team ergänzt einen Zustellstatus-Assistenten
- Wann ist MCP die falsche Wahl?
- So unterstützt OmniChannels.ai
Das Wichtigste
- MCP (Model Context Protocol) ist ein offener Standard, mit dem ein KI-Client Tools auf einem Remote-Server auflisten und aufrufen kann; der Server von OmniChannels.ai bildet seine Tools auf dieselbe REST-API ab, die auch Ihr Code nutzen würde.
- Ein Endpunkt, https://mcp.broadnet.me/mcp über Streamable HTTP, und ein Header, Authorization: Bearer <token>, verbinden Claude Code, Cursor, VS Code, Claude Desktop und weitere Clients.
- Ein Agent mit Sende-Tools kann echte Personen anschreiben und echtes Guthaben ausgeben, aktivieren Sie daher nur die benötigten Tools und verlangen Sie vor jedem Versand eine menschliche Bestätigung.
- Die WhatsApp-Regeln gelten auch für Agenten: Opt-in, freigegebene Vorlagen außerhalb des Kundenservice-Fensters und Sender-ID-Regeln für SMS.
- Nutzen Sie beim Experimentieren einen temporären Schlüssel und einen dauerhaften nur für einen geprüften Produktivagenten.
Dieser Leitfaden richtet sich an Entwickler und technische Leiter, die einen KI-Agenten WhatsApp- und SMS-Nachrichten senden oder verfolgen lassen möchten, ohne jede Integration von Hand zu schreiben. Er erklärt, was ein WhatsApp-MCP-Server ist, wie Sie einen verbinden, welche Leitplanken Sie setzen sollten, bevor der Agent echte Kunden berührt, und wo MCP das falsche Werkzeug ist.
Was ist ein WhatsApp-MCP-Server?
Ein WhatsApp-MCP-Server ist ein Dienst, der Messaging-Operationen, etwa das Senden einer Vorlage oder das Lesen eines Zustellberichts, als Tools bereitstellt, die ein KI-Client entdecken und aufrufen kann. Er spricht das Model Context Protocol (MCP), einen offenen Standard zur Anbindung von KI-Assistenten an externe Tools und Daten.
Ohne MCP bedeutet es, einem Assistenten das Senden einer Nachricht zu ermöglichen, für jedes Modell oder Framework eine eigene Funktion zu schreiben. Mit MCP verbindet sich der Client mit einer URL, fragt den Server, welche Tools es gibt, und ruft sie auf, wenn die Anfrage eines Nutzers sie braucht. Unser Glossareintrag zu MCP-Servern gibt die kurze Definition.
Zwei Punkte übersieht man leicht:
- MCP umgeht die Regeln von WhatsApp nicht. Der Server ruft dieselben Operationen der WhatsApp Business Platform auf wie jede andere Integration, daher gelten Vorlagen, Opt-in und das Kundenservice-Fenster weiterhin.
- Der Agent ist nur so sicher wie sein Token. Die Tools handeln mit den Berechtigungen, Sender IDs und dem Guthaben des von Ihnen bereitgestellten Schlüssels.
Wie funktioniert der MCP-Server von OmniChannels.ai?
Es ist ein Remote-MCP-Server auf einem einzigen Endpunkt, authentifiziert mit einem Bearer-Token. Seine Tools werden auf dieselbe REST-API abgebildet, die in den Entwicklerdokumenten dokumentiert ist, daher kann ein Agent das tun, was Ihr eigener Code mit diesem Token könnte.
| Einstellung | Wert |
|---|---|
| Endpunkt | https://mcp.broadnet.me/mcp |
| Transport | MCP Streamable HTTP |
| Authentifizierung | Authorization: Bearer <token> bei jeder Anfrage |
| Wirkt auf | Ihren Account: Kanäle, Sender IDs, Vorlagen und Guthaben |
| Typische Tool-Bereiche | Senden auf jedem Kanal (SMS, WhatsApp, RCS, Telegram, Messenger, Instagram, Push), Auflisten und Senden von WhatsApp-Vorlagen, Lesen von Zustellberichten |
Die genaue Tool-Liste hängt von Serverversion und Account ab, lesen Sie sie daher aus Ihrem Client statt aus einem Blogbeitrag. Eine Anfrage ohne Token wird auf Protokollebene abgelehnt, was ein nützlicher Smoke-Test ist.
Wie verbinde ich Claude, Cursor oder einen anderen Client?
Sie tragen Endpunkt und Header in die MCP-Konfiguration Ihres Clients ein und halten das Token in einer Umgebungsvariable oder einer geheimen Eingabe, damit es nie in einem Repository landet.
In fünf Schritten verbinden
- Schlüssel anfordern. Öffnen Sie im Admin-Portal Integrationen, dann MCP-Integration, und wählen Sie „Temporären Schlüssel anfordern“. Einen dauerhaften Schlüssel für einen Produktivagenten erhalten Sie von Ihrem Account-Admin oder Master-Account.
- Als Secret speichern. Exportieren Sie ihn zum Beispiel in Ihrer Shell als
BROADNET_TOKEN. - Server zu Ihrem Client hinzufügen. Für Claude Code:
claude mcp add --transport http omnichannels https://mcp.broadnet.me/mcp \
--header "Authorization: Bearer $BROADNET_TOKEN"
- Tools prüfen. In Claude Code zeigt der Befehl
/mcpden Server und seine Tools. In Cursor, VS Code und Claude Desktop liegt die Konfiguration in der eigenen MCP-Einstellungsdatei des Clients. - Schalten Sie ab, was der Agent nicht braucht, vor dem ersten echten Prompt.
Die Formate der Clients ändern sich zwischen Versionen, daher stehen die genauen Snippets für Cursor, VS Code und Claude Desktop in den Dokumenten, mit Schritt-für-Schritt-Seiten für Claude Code, Cursor und n8n. Die eigene MCP-Dokumentation von Claude Code ist die Referenz für seine Befehle.
Um ohne Client zu testen, senden Sie die MCP-Anfrage initialize mit Ihrem Token an den Endpunkt. Die Dokumente zeigen den vollständigen curl-Befehl.
Was kann ein KI-Agent mit WhatsApp und SMS tun?
Alles, was die verbundenen Tools erlauben: senden, nachschlagen und berichten. Der praktische Wert liegt in den flexiblen, sprachlichen Aufgaben rund um Messaging, nicht in den volumenstarken Abläufen, die Sie im Code halten sollten.
Beispiel-Prompts, die zu einem Agenten passen:
- „Sende eine SMS von OmniDemo an 447700900123 mit dem Hinweis, dass der Techniker um 15 Uhr eintrifft.“
- „Liste meine freigegebenen WhatsApp-Vorlagen auf Arabisch auf.“
- „Sende die WhatsApp-Vorlage
order_updatean 971500000000 mit der Bestellnummer INV-400.“ - „Wie viele Nachrichten der Kontoauszugs-Kampagne von gestern sind fehlgeschlagen, und warum?“
- „Entwirf eine RCS-Karte für unseren Herbststart und zeige sie mir, bevor etwas gesendet wird.“
Gute Anwendungsfälle, grob nach Sicherheit geordnet:
| Anwendungsfall | Benötigte Tools | Risiko |
|---|---|---|
| Zustellfragen von Support-Mitarbeitern („Hat dieser Kunde die SMS erhalten?“) | Nur lesende Berichts-Tools | Gering |
| Entwickler-Assistent, der beim Bau einer Integration Testnachrichten an Ihre eigenen Nummern sendet | Sende-Tools, nur Testnummern | Gering bis mittel |
| Vorlagen nachschlagen und Texte zur Prüfung entwerfen | Tools zum Auflisten von Vorlagen | Gering |
| Betriebsassistent, der nach menschlicher Freigabe einzelne Hinweise sendet | Sende-Tools plus Bestätigung | Mittel |
| Autonomer Agent, der an Kunden sendet | Sende-Tools, keine Bestätigung | Hoch; braucht ein geprüftes Design |
Ein interner Assistent, der Zustellfragen beantwortet, braucht gar keine Sende-Tools. Entfernen Sie sie.
Wie verhindere ich, dass ein KI-Agent die falschen Personen anschreibt?
Behandeln Sie den Agenten wie einen neuen Mitarbeiter mit Firmenhandy: begrenzte Berechtigungen, anfangs Aufsicht und ein Protokoll dessen, was er getan hat. Die Dokumente listen die Schutzmaßnahmen auf; hier sind sie mit der Begründung.
- Geringste Berechtigung. Aktivieren Sie nur die Tools, die die Aufgabe braucht. Ein Agent, der Zustellfragen beantwortet, braucht keine Sende-Tools; einer, der OTPs sendet, braucht keine Vorlagen- oder Account-Tools.
- Mensch in der Schleife. Konfigurieren Sie den Client so, dass er vor jedem sendenden Tool um Bestätigung bittet, und immer vor Sendungen an viele Empfänger. In Claude Code bezeichnen Berechtigungsregeln MCP-Tools als
mcp__<server>__<tool>, sodass Sie lesende Tools frei laufen lassen können, während sendende Tools weiter nachfragen. - Temporäre Schlüssel für Experimente. Nutzen Sie zum Testen einen temporären Schlüssel und einen dauerhaften nur für einen geprüften Produktivagenten.
- Zuerst Testnummern. Richten Sie neue Agenten auf Ihre eigenen verifizierten Nummern, bis Sie ihrem Verhalten vertrauen.
- Logs beobachten. Prüfen Sie in Ihren Zustellberichten, was der Agent gesendet hat, besonders in den ersten Wochen.
- Schnell widerrufen. Wird ein Schlüssel offengelegt, bitten Sie Ihren Account-Admin oder unseren Support, ihn zu widerrufen und einen neuen auszustellen.
- Einwilligung beachten. Agenten müssen dieselben Regeln zu Opt-in, Sender ID und Kanälen befolgen wie jeder andere Absender.
Prompt-Injection verdient eine besondere Erwähnung. Liest ein Agent nicht vertrauenswürdigen Text, etwa eine eingehende Kundennachricht oder eine Webseite, kann dieser Text Anweisungen enthalten. Geben Sie einem Agenten, der nicht vertrauenswürdige Inhalte liest, keinen unbeaufsichtigten Zugriff auf Sende-Tools. Halten Sie Lesen und Senden in getrennten Schritten, mit einer Person, die den Versand freigibt.
Welche Regeln für WhatsApp und SMS gelten weiterhin?
Alle. Der Agent ist nur ein weiterer Absender.
- Opt-in. Metas WhatsApp Business Messaging Policy verlangt, dass Personen eingewilligt haben, von Ihnen zu hören. Ein Agent, der jeden in einer Tabelle anschreiben kann, ändert das nicht.
- Vorlagen und das Fenster. Freitext-WhatsApp-Nachrichten sind nur innerhalb des Kundenservice-Fensters möglich; außerhalb brauchen Sie eine freigegebene Vorlage. Siehe unseren Leitfaden zum 24-Stunden-Kundenservice-Fenster und die WhatsApp-API-Dokumentation.
- Kosten. Meta berechnet pro zugestellter Nachricht nach Kategorie, und ein Agent kann schnell Volumen erzeugen. Deckeln Sie, was er senden darf, und modellieren Sie Kosten mit unserem WhatsApp-Preisrechner.
- SMS-Sender-IDs. SMS braucht in vielen Ländern eine registrierte Sender ID. Der Agent nutzt die in Ihrem Account freigegebenen Sender IDs.
Praxisbeispiel: ein Support-Team ergänzt einen Zustellstatus-Assistenten
„Souq Rafiq“ (fiktiv), ein Onlinehändler in den VAE, möchte, dass seine Support-Mitarbeiter die Frage „Hat der Kunde unsere Nachricht erhalten?“ beantworten, ohne Dashboards zu öffnen.
- Einrichtung: Ein Admin erzeugt einen temporären Schlüssel und verbindet Claude Desktop für zwei Support-Leiter mit dem MCP-Server.
- Tools: Nur lesende Berichts-Tools sind aktiviert. Sende-Tools sind abgeschaltet.
- Nutzung: Ein Leiter fragt: „Wie viele Nachrichten der Kontoauszugs-Kampagne von gestern sind fehlgeschlagen, und warum?“ Der Agent liest den Zustellbericht und fasst die Gründe nach Status zusammen.
- Prüfung: Nach zwei Wochen prüft der Admin die Zustellberichte, bestätigt, dass nichts gesendet wurde, und beantragt einen dauerhaften Schlüssel für einen kleinen Produktivassistenten.
- Nächster Schritt: Damit der Assistent eine verpasste Benachrichtigung erneut senden kann, aktiviert das Team ein Sende-Tool mit Bestätigung und beschränkt es zunächst auf eine Gruppe von Testnummern.
Wann ist MCP die falsche Wahl?
Nutzen Sie für alles Deterministische und Volumenstarke die REST-API, die OpenAPI-Spezifikation oder das SDK.
- OTP- und Transaktionsabläufe. Ein Login-Code sollte aus Code kommen, den Sie kontrollieren, nicht von einem Modell, das ihn umformulieren könnte. Siehe den REST-Quickstart.
- Massenkampagnen. Nutzen Sie die Kampagnen-Tools oder die Bulk-Endpunkte mit einer geprüften Datei, keinen Gesprächs-Prompt.
- Unbeaufsichtigter Kundenchat. Ein kundenseitiger Agent braucht einen gestalteten Gesprächsablauf, Wissen, Übergabe an Menschen und Überwachung. Das ist ein KI-Agenten-Produkt, keine MCP-Sitzung eines Entwicklers.
- Grenzen dieses Leitfadens. Konfigurationsformate der Clients und die Tool-Liste ändern sich zwischen Versionen. Bestätigen Sie beides in den Dokumenten und in Ihrem Client.
So unterstützt OmniChannels.ai
OmniChannels.ai stellt den MCP-Server unter https://mcp.broadnet.me/mcp neben der REST-API unter https://api.broadnet.me bereit, mit einem Bearer-Token-Modell über SMS, WhatsApp, RCS, Messenger, Instagram, Telegram, E-Mail und Push. BroadNet ist ein offizieller Meta Business Solution Provider, und sein KI-Agenten-Produkt unterstützt Englisch und Arabisch mit Übergabe an einen menschlichen Mitarbeiter und Tool-Nutzung über MCP; siehe KI-Agenten. Der Testzugang geht an Ihre eigenen verifizierten Nummern. Beginnen Sie mit dem MCP-Leitfaden und der Entwicklerübersicht.
Häufige Fragen
Was ist ein MCP-Server?
Ein MCP-Server ist ein Programm, das KI-Clients über das Model Context Protocol, einen offenen Standard, Tools anbietet. Der Client verbindet sich, listet die Tools auf und ruft sie auf, wenn die Anfrage eines Nutzers sie braucht. Ein Remote-MCP-Server läuft auf der Infrastruktur des Anbieters, sodass Sie sich mit einer URL verbinden und authentifizieren, statt Code zu installieren.
Kann Claude WhatsApp-Nachrichten senden?
Claude erreicht WhatsApp nicht von selbst, aber ein Claude-Client mit MCP-Unterstützung kann die Tools eines Messaging-MCP-Servers aufrufen. Ist der MCP-Server von OmniChannels.ai verbunden, können Claude Code oder Claude Desktop eine freigegebene WhatsApp-Vorlage oder eine SMS aus Ihrem Account senden, vorbehaltlich Ihrer Tool-Einstellungen und Metas Regeln.
Ist es sicher, einen KI-Agenten Nachrichten senden zu lassen?
Nur mit Leitplanken. Aktivieren Sie die kleinstmögliche Menge an Tools, verlangen Sie eine menschliche Bestätigung für Sendungen, testen Sie zuerst mit Ihren eigenen verifizierten Nummern, nutzen Sie beim Experimentieren temporäre Schlüssel und prüfen Sie Zustellberichte. Der Agent handelt mit den Berechtigungen Ihres Tokens und kann daher Guthaben ausgeben und echte Personen erreichen, wenn Sie es erlauben.
Brauche ich eine WhatsApp-Vorlage, damit ein Agent jemanden anschreiben kann?
Ja, außerhalb des Kundenservice-Fensters. Meta erlaubt Freitextnachrichten nur, solange ein vom Kunden geöffnetes Fenster aktiv ist; andernfalls muss das Unternehmen eine freigegebene Vorlage senden. Ein Agent kann Ihre freigegebenen Vorlagen auflisten und eine per Name senden, aber nicht spontan eine neue freigegebene Vorlage erfinden.
Ersetzt der MCP-Server die REST-API?
Nein. Die Tools werden auf dieselbe REST-API abgebildet, mit demselben Token und denselben Berechtigungen. Nutzen Sie MCP, wenn ein KI-Client Operationen selbst entdecken und aufrufen soll, und die REST-API, die OpenAPI-Spezifikation oder das SDK für deterministischen Produktivcode wie OTP-Abläufe und Bestellbenachrichtigungen.
Wie erhalte ich einen MCP-Schlüssel?
Melden Sie sich im Admin-Portal an, öffnen Sie Integrationen und dann MCP-Integration und wählen Sie „Temporären Schlüssel anfordern“. Einen dauerhaften Schlüssel für einen Produktivagenten stellt Ihr Account-Admin oder Ihr Master-Account aus. Der Testzugang geht an Ihre eigenen verifizierten Nummern, eine sofortige Self-Service-Anmeldung gibt es nicht.
Quellen
Weiterlesen
Weitere LeitfädenIntegration
WhatsApp-Nachricht per API senden: cURL, Node, Python, PHP
WhatsApp-Nachrichten per API senden: Beispiele in cURL, Node.js, Python und PHP für Vorlagen und Session-Nachrichten, plus Statusverfolgung und Fehler.
10 Min. Lesezeit
Integration
WhatsApp-Webhooks: Ereignisse, Sicherheit und Wiederholungen
WhatsApp-Webhooks verstehen: Nachrichten- und Statusereignisse, zuverlässiger Handler, Metas Signaturprüfung, Wiederholungen, Idempotenz, fehlende Ereignisse.
10 Min. Lesezeit
Kundenservice
WhatsApp KI-Agent im Kundenservice: Design und Meta-Regeln
WhatsApp-KI-Agent für den Kundenservice gestalten: Wissensbasis, Leitplanken, Übergabe an Menschen, Arabisch und Englisch und Metas Bedingungen 2026 zu KI.
10 Min. Lesezeit
