BroadNet
Das JournalEngineering
Engineering

MCP für Messaging: Wie KI-Agenten SMS und WhatsApp sicher versenden

Ein MCP-Server macht eine Messaging-API zu Werkzeugen für KI-Agenten. Das ist mächtig, aber riskant: Ein Agent mit Sende-Tool kann echte Kunden kontaktieren. Erfahren Sie, wie MCP für SMS und WhatsApp funktioniert, wie man sich mit dem BroadNet-Server verbindet und welche Schutzmaßnahmen zuerst implementiert werden sollten.

BroadNet Engineering
11 Min. Lesezeit
Engineering · Ausgabe 47
11 Min. Lesezeit

in MCP-Server für Messaging stellt eine Messaging-API als Tools bereit, die ein KI-Agent über Model Context Protocol entdecken und aufrufen kann, sodass ein Assistent auf Anfrage eine SMS oder eine WhatsApp-Nachricht senden kann. BroadNet läuft bei https://mcp.broadnet.me/mcp unter Verwendung des Streamable HTTP-Transports und eines Bearer-Tokens über denselben API, der WhatsApp, SMS, RCS, Telegram, Push, E-Mail, Messenger und Instagram bedient. Dieser Leitfaden erklärt, wie es funktioniert und, was noch wichtiger ist, wie man verhindert, dass ein Agent die falschen Personen kontaktiert.

Wichtigste Erkenntnisse

  • MCP ist ein offenes Protokoll, das auf JSON-RPC 2.0 basiert und es KI-Anwendungen ermöglicht, externe Tools zu entdecken und aufzurufen. Ein Messaging-MCP-Server wandelt Send-, Vorlagen- und Bericht-Endpunkte in Tools um.
  • Remote-Server nutzen den Streamable HTTP-Transport: einen HTTPS-Endpunkt, wobei jede Client-Nachricht ein HTTP-POST ist. Lokale Server nutzen üblicherweise stdio.
  • Der BroadNet MCP-Server befindet sich unter https://mcp.broadnet.me/mcp und lehnt jede Anfrage ohne einen Authorization: Bearer-Header ab.
  • Ein Token ist eine Send-Berechtigung. Der Agent handelt mit seinen Berechtigungen, genau so, wie es Ihr eigener Code tun würde.
  • Die MCP-Spezifikation besagt, dass es immer einen Menschen im Prozess geben sollte (SHOULD), der Tool-Aufrufe ablehnen kann, und dass Server Tool-Aufrufe mit einem Rate-Limit begrenzen müssen (MUST). Bauen Sie Zustimmungen, Ruhezeiten, Limits und Genehmigungen um jedes Send-Tool herum.

Was ist Model Context Protocol?

Die MCP Spezifikation beschreibt MCP als „ein offenes Protokoll, das eine nahtlose Integration zwischen LLM-Anwendungen und externen Datenquellen und Werkzeugen ermöglicht“. Es verwendet JSON-RPC 2.0 Nachrichten zwischen drei Rollen: Hosts (die KI-Anwendung), Clients (Konnektoren innerhalb des Hosts) und Server (Dienste, die Werkzeuge, Ressourcen und Prompts bereitstellen). Stand 26. September 2026 ist die neueste Revision der Spezifikation auf den 2026-07-28 datiert.

Tools sind der Teil, der für das Messaging entscheidend ist. Ein Client listet sie mit tools/list auf, das Modell wählt eines aus und der Client ruft es mit tools/call auf. Die Spezifikation bezeichnet Tools als "modellgesteuert": das Modell entscheidet, wann es sie nutzt. Genau deshalb benötigt ein Send-Tool Schutzmaßnahmen, die das Modell nicht durch bloße Kommunikation umgehen kann.

Wie funktioniert ein MCP-Server für SMS und WhatsApp?

Der Anforderungspfad umfasst fünf Hops. Der entscheidende Punkt ist, dass der MCP-Server keine neue Sendeleistung hinzufügt; er stellt die API bereit, die Sie bereits besitzen, unter demselben Token und unter denselben Kontrollen.

  1. Ein Benutzer fragt den KI-Host, zum Beispiel: "Sende das Lieferupdate an diesen Kunden am WhatsApp".
  2. Das Modell wählt ein Werkzeug aus der Liste aus, die der MCP-Client abgerufen hat, wie zum Beispiel ein WhatsApp-Sende-Werkzeug, und füllt dessen Argumente aus.
  3. Der MCP-Client sendet eine tools/call-Anfrage als HTTP-POST an https://mcp.broadnet.me/mcp mit dem Bearer-Token.
  4. Der BroadNet MCP-Server validiert den Token und ruft den entsprechenden BroadNet API-Endpunkt auf.
  5. Der API leitet die Nachricht an WhatsApp oder an das Mobilfunknetz weiter und gibt ein Ergebnis zurück, das als Werkzeug-Ergebnis an das Modell zurückfließt.

In der Demo-Aufzeichnung des Produktteams listet der Client 380 BroadNet-Werkzeuge auf, darunter send_message, post_sms_send, post_whatsapp_message_send, get_whatsapp_template_list, post_whatsapp_template_send, post_rcs_message_send und get_report_delivery. Die genaue Liste hängt von der Serverversion und Ihrem Konto ab; siehe die MCP Server-Dokumentation.

Streamable HTTP oder stdio: welcher Transport?

Die Spezifikation definiert zwei Standardtransporte. Welchen Sie verwenden, hängt davon ab, wo der Server läuft, und es entscheidet darüber, wie Sie sich authentifizieren.

stdioStreamable HTTP
Wo der Server läuftAls Unterprozess, der vom Client gestartet wird, auf derselben MaschineAls unabhängiger Dienst wurde über HTTPS erreicht
Wie Nachrichten übertragen werdenZeilengetrennte JSON-RPC über Standardein- und -ausgabeJede Client-Nachricht ist ein HTTP POST an einen einzelnen MCP-Endpunkt; Antworten kommen als JSON oder als Server-Sent-Events-Stream zurück
Wie Anmeldedaten funktionierenDie Spezifikation besagt, dass stdio Server Anmeldedaten aus der Umgebung lesen solltenEin Authorization: Bearer-Header bei jeder Anfrage; Token dürfen niemals in der Query-Zeichenfolge enthalten sein
Typische VerwendungLokale EntwicklerwerkzeugeGehostete Dienste, die von vielen Clients geteilt werden, wie etwa ein Messaging-API
BroadNetNicht angebotenhttps://mcp.broadnet.me/mcp

Für HTTP Server erfordert die Revision der Spezifikation vom 2025-06-18 zudem, dass Server den Origin Header validieren, und empfiehlt, dass sie jede Verbindung authentifizieren. Die neueste Revision (2026-07-28) macht jede Anfrage in sich geschlossen, wobei die Protokollversion und die Client-Fähigkeiten in ihren eigenen Metadaten mitgeführt werden; frühere Revisionen öffneten eine Sitzung mit einem Initialize-Handshake, und Clients erkennen, welche Revision ein Server spricht, und nutzen im Bedarfsfall eine ältere Version.

Wie verbindet man einen KI-Agenten mit dem MCP-Server von BroadNet?

  1. Holen Sie sich einen Token von Ihrem BroadNet-Konto. Im BroadAdmin-Portal unter Integrations und dann MCP Integration wird ein temporärer Schlüssel ausgegeben; ein permanenter Schlüssel wird von Ihrem Kontoadministrator oder dem Master-Konto bereitgestellt.
  2. Fügen Sie den Server Ihrem MCP-Client hinzu. Die meisten Clients verwenden eine JSON-Konfiguration wie die untenstehende. Die Feldnamen variieren leicht zwischen den Clients, prüfen Sie daher die Dokumentation Ihres Clients.
  3. Behalten Sie den Token außerhalb der Dateien, die Sie committen. Nutzen Sie die Unterstützung für Umgebungsvariablen Ihres Clients, so wie es die untenstehende Konfiguration tut.
  4. Öffnen Sie die Tool-Liste und schalten Sie jedes Tool aus, das der Agent nicht benötigt.
  5. Testen Sie mit einer Nachricht an eine Nummer, die Ihnen gehört, bevor Sie den Agenten an Kundendaten heranlassen.
snippet
{
"mcpServers": {
"broadnet": {
"type": "http",
"url": "https://mcp.broadnet.me/mcp",
"headers": {
"Authorization": "Bearer ${BROADNET_TOKEN}"
}
}
}
}

Um die Verbindung ohne einen Client zu testen, senden Sie die Initialisierungsanfrage selbst:

snippet
curl -X POST https://mcp.broadnet.me/mcp \
-H "Authorization: Bearer $BROADNET_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize",
"params":{"protocolVersion":"2025-06-18","capabilities":{},
"clientInfo":{"name":"curl","version":"1.0"}}}'

Ohne den Header lehnt der Server den Aufruf auf Protokollebene ab. Dies ist seine tatsächliche Antwort auf eine nicht authentifizierte Initialisierungsanfrage, geprüft am 26. September 2026:

snippet
event: message
data: {"jsonrpc":"2.0","id":1,"error":{"code":-32001,
"message":"Authorization bearer token is required. Connect with an
'Authorization: Bearer <BroadNet token>' header."}}

Ist es sicher, einem KI-Agenten einen Messaging-API-Schlüssel zu geben?

Nur mit entsprechenden Einschränkungen. Der Token ist eine Sende-Anmeldeinformation: Jeder oder jeder Agent, der ihn besitzt, kann Nachrichten von Ihrem Konto aus senden, und jeder Versand kostet Geld und erreicht eine echte Person. Agenten agieren zudem auf Anweisungen in natürlicher Sprache, und ein Teil dieses Textes stammt von außerhalb: Eine eingehende Kundennachricht oder eine Webseite kann Anweisungen enthalten, denen das Modell möglicherweise zu folgen versucht. Die MCP-Spezifikation spricht dies direkt an. Sie besagt, dass Hosts vor dem Aufrufen eines Tools die ausdrückliche Zustimmung des Nutzers einholen müssen, dass immer ein Mensch im Prozess (human in the loop) mit der Fähigkeit zur Ablehnung von Tool-Aufrufen vorhanden sein sollte (SHOULD), und dass Clients Tool-Annotationen als nicht vertrauenswürdig behandeln müssen, es sei denn, sie stammen von einem vertrauenswürdigen Server.

Welche Leitplanken verhindern, dass ein Agent Kunden mit Spam belästigt?

Platzieren Sie die Kontrollen dort, wo das Modell sie nicht umgehen kann: in der Client-Konfiguration, in Ihrer eigenen Middleware oder in den Kontoeinstellungen, nicht im Prompt.

RisikoKontrolleOrt der Implementierung
Nachricht an jemanden senden, der nicht eingewilligt hatPrüfen Sie den Zustimmungs- und Opt-out-Status, bevor ein Sendevorgang-Tool ausgeführt wirdIhre Middleware oder Ihr CRM
Versand in der Nacht oder am falschen TagRuhezeiten pro Empfänger-Zeitzone und MarktregelnIhre Middleware
Verwendung von Tools, die für die Aufgabe nicht benötigt werdenAktivieren Sie nur die erforderlichen Tools; deaktivieren Sie Template-, Onboarding- und Account-ToolsMCP Client-Tool-Einstellungen
Unkontrollierte Schleifen und MassenversandSende-Limits pro Agent und Ratenbegrenzungen; die Spezifikation erfordert, dass Server die Tool-Aufrufe ratenlimitierenIhre Middleware und der Server
Duplizierte Nachrichten nach einem RetryBehalten Sie die zurückgegebene Nachrichten-ID bei und prüfen Sie deren Status, bevor Sie erneut sendenIhre Agenten-Logik (siehe Idempotenz-Leitfaden)
Marketing ohne Überprüfung versendetMenschliche Genehmigung für jeden Marketing- oder Multi-Empfänger-VersandMCP Client-Bestätigungsaufforderungen
In eingehenden Nachrichten verborgene AnweisungenBehandeln Sie eingehende Texte als Daten; lassen Sie sie niemals ohne eine Benutzeranfrage einen Versand auslösenPrompt-Design und Genehmigungsregeln im KI-Host
Durchgesickerter TokenTemporäre Schlüssel für Experimente, Umgebungsvariablen, bei Offenlegung widerrufen und neu ausstellenBroadNet Konto-Admin
Kein Audit-TrailProtokollieren Sie jeden Tool-Aufruf mit Eingaben und ErgebnissenMCP Client; die Spezifikation besagt, dass Clients die Tool-Nutzung protokollieren sollten

Der BroadNet API verfügt über keinen Idempotenz-Header, daher kann ein erneuter Versuch nach einem Timeout doppelt senden. Das sichere Muster besteht darin, die Nachrichten-ID zu speichern, die der API zurückgibt, und den Lieferstatus vor einem erneuten Senden zu prüfen; unsere Leitfäden zu Idempotenz und Wiederholungsversuchen zeigen, wie dies geschieht.

Welche Messaging-Aktionen sollten eine menschliche Genehmigung erfordern?

AktionVorgeschlagener StandardWarum
Zustellberichte lesen, Vorlagen auflistenAutomatischNur Lesezugriff; nichts erreicht einen Kunden
Eine transaktionale Nachricht an einen bekannten Kunden, der sie angefordert hatAutomatisch innerhalb einer Sendeobergrenze oder per Ein-Klick-BestätigungGeringes Risiko, hoher Wert, einfach zu prüfen
Jede Marketing-NachrichtImmer menschliche GenehmigungZustimmungs-, Inhalts- und Kostenrisiko
Jeder Versand an mehr als einen EmpfängerImmer menschliche GenehmigungEin Fehler vervielfacht sich
Erstellen oder Einreichen von WhatsApp VorlagenMenschliche GenehmigungVorlagen werden von Meta überprüft und repräsentieren Ihre Marke
Konto-, Abrechnungs- oder Onboarding-ToolsDeaktiviertEin Agent sollte das Konto, auf dem er läuft, nicht ändern

MCP oder ein einfacher REST API: Welchen sollte ein Agent verwenden?

Beide erreichen dieselbe Plattform. Der Unterschied liegt darin, wer entscheidet, welchen Aufruf getätigt wird.

BroadNet MCP ServerBroadNet REST API
Wer wählt den Aufruf ausDas Modell aus der Tool-ListeIhr Code
Endpunkthttps://mcp.broadnet.me/mcphttps://api.broadnet.me, zum Beispiel POST /sms/sendSms
AuthentifizierungAuthorization: Bearer <Token>Authorization: Bearer <Token>
Client-BibliothekJeder MCP-Client, der Remote-Server und einen benutzerdefinierten Authorization-Header unterstütztEin offizieller SDK, @broadnet/cpaas-sdk (TypeScript/Node.js); generieren Sie andere Clients aus der OpenAPI-Spezifikation
Am besten geeignet fürAssistenten, Operations-Copilots, Ad-hoc-Aufgaben in natürlicher SpracheProduktionsabläufe mit fester Logik: OTP, Alarme, Kampagnen

Eine sinnvolle Aufteilung: Verwenden Sie MCP, wenn eine Person den Agenten steuert und eine Bestätigungsaufforderung akzeptabel ist, und verwenden Sie die REST API, mit dem Quickstart und dem curl-Generator, für Abläufe, die jedes Mal auf die gleiche Weise ausgeführt werden müssen. Unsere API Referenz dokumentiert die Endpunkte hinter den MCP Tools.

Häufig gestellte Fragen

Was ist ein MCP-Server für Messaging?

Ein Server, der Messaging-API-Funktionen, wie z. B. Senden von SMS, Senden von WhatsApp Nachrichten oder Abrufen von Zustellberichten, als Tools bereitstellt, die ein KI-Agent über die Model Context Protocol entdecken und aufrufen kann.

Wie lautet die BroadNet MCP Server-URL?

https://mcp.broadnet.me/mcp. Er nutzt den MCP Streamable HTTP Transport und erfordert bei jeder Anfrage einen Authorization: Bearer Header mit Ihrem BroadNet Token.

Welche KI-Clients können sich damit verbinden?

Jeder MCP Client, der sich über Streamable HTTP mit einem Remote-Server verbinden und einen benutzerdefinierten Authorization Header senden kann. Die BroadNet Demo-Aufnahme verwendet Cursor.

Kann der Agent echte Nachrichten senden?

Ja. Die Tools agieren mit den Berechtigungen Ihres Tokens, genau so, wie es Ihre eigenen API Aufrufe tun würden. Behandeln Sie jedes Senden als echt: Aktivieren Sie nur die Tools, die der Agent benötigt, und fordern Sie eine Bestätigung vor dem Senden an.

Wie funktioniert die Bearer-Authentifizierung mit MCP?

Für HTTP sendet der Client bei jeder Anfrage Authorization: Bearer gefolgt von dem Token, selbst innerhalb derselben Sitzung, und niemals in der URL-Abfragezeichenfolge. Der Server von BroadNet lehnt Anfragen ohne dieses ab.

Was ist der Unterschied zwischen stdio und Streamable HTTP?

stdio führt den Server als lokalen Unterprozess aus und tauscht zeilengetrennte JSON-RPC über die Standardeingabe und -ausgabe aus. Streamable HTTP führt den Server als Webdienst aus, bei dem jede Client-Nachricht ein HTTP POST an einen Endpunkt ist.

Wie verhindere ich, dass ein KI-Agent Kunden mit Spam belästigt?

Erzwingen Sie Zustimmungsprüfungen, Ruhezeiten und Sende-Limits außerhalb des Modells, aktivieren Sie nur die Werkzeuge, die Sie benötigen, fordern Sie eine menschliche Genehmigung für Marketing-Nachrichten und Nachrichten an mehrere Empfänger an und protokollieren Sie jeden Werkzeugaufruf.

Sollte ich MCP oder den REST API verwenden?

Verwenden Sie MCP, wenn eine Person einen Agenten in natürlicher Sprache steuert. Verwenden Sie den REST API oder den TypeScript SDK für feste Produktionsabläufe wie OTP und Warnmeldungen, bei denen Ihr Code und nicht ein Modell entscheidet, was gesendet wird.

Quellen

Weiterführende Lektüre: KI-Agenten im Customer Messaging und Wahl einer agentenbasierten KI-Plattform für Unternehmen.

War das hilfreich?

Wie wir Inhalte erstellen und prüfen

Verfasst von

BroadNet Engineering

Die Ingenieure betreiben die Netzwerkinfrastruktur: SMPP Bindungen, SS7 Stacks, Routing-Engines – die im Grunde unscheinbare Infrastruktur, die den Versand von einer Milliarde Nachrichten pro Monat ermöglicht. Hier schreiben sie, wenn etwas erwähnenswert ist.

Das Journal, per E-Mail

Ein Aufsatz pro Monat. Sonst nichts.

Abonnieren Sie unseren Newsletter und wir senden Ihnen den nächsten Beitrag – ob zu Technik, Regulierung oder Industrie – direkt am Erscheinungstag. Keine E-Mail-Kampagnen, keine Produktpräsentationen, keine Weitergabe an Dritte. Abmeldung mit einem Klick.

Wir senden eine E-Mail pro Monat. Abmeldung jederzeit möglich. Siehe unsere Datenschutzerklärung.

Was Sie erhalten
  • Ausführlicher Text, kein Linkköder
    Sechs bis elf Minuten konzentriertes Schreiben zu einem einzigen Thema.
  • Verfasst von Bedienern
    Ingenieure, Zulassungsbeauftragte und Produktentwickler sind im eigenen Haus tätig.
  • Regionsabhängig
    MENA-zentrierte Sicht auf Regulierungsbehörden, Betreiber und Vertriebskanalmix.
  • Einmal im Monat
    Keine tröpfchenweise Kampagne. Nur ein Essay, wenn es einen zu teilen gibt.
Hör auf zu lesen. Fang an zu versenden.

Das meiste von dem, was wir schreiben, haben wir in der Produktion gelernt.

Wenn Ihnen dieser Artikel zusagte, sollten wir uns unterhalten. Schildern Sie uns Ihren Anwendungsfall, die Volumina und die Märkte – wir melden uns dann mit Routing, Preisen und einem Referenzkunden, den Sie kontaktieren können.

$ curl -X POST https://api.broadnet.me/sms/sendSms