# KI-Agenten per MCP mit BroadNet verbinden. - Kanonische URL: https://www.broadnet.me/de/developers/mcp - Sprache: de - Zuletzt aktualisiert: 2026-10-21 - Herausgeber: BroadNet (https://www.broadnet.me) - Markdown-Fassung der Seite, aus der ausgelieferten Seite erzeugt. Model Context Protocol· /developers/mcp Der BroadNet MCP-Server stellt die BroadNet Messaging-API als Tools bereit, die ein KI-Agent aufrufen kann. Richten Sie einen beliebigen MCP-Client, der Remote-Server unterstützt, auf einen einzigen Endpunkt, authentifizieren Sie sich mit Ihrem BroadNet-Token – und der Agent kann über Ihr Konto Nachrichten senden und verfolgen. **Endpunkt** https://mcp.broadnet.me/mcp **Transport** MCP Streamable HTTP **Authentifizierung** Authorization: Bearer **Kanäle** WhatsApp, SMS, RCS, Telegram, Push, E-Mail, Messenger, Instagram ## Was der MCP-Server ist Das Model Context Protocol (MCP) ist ein offener Standard, mit dem KI-Assistenten externe Tools finden und aufrufen können. Der BroadNet MCP-Server ist ein Remote-Server: Ihr Client verbindet sich per HTTPS, listet die angebotenen Tools auf und ruft sie für Sie auf. Die Tools entsprechen derselben BroadNet-API, die in der API-Referenz und in der OpenAPI-Spezifikation dokumentiert ist – Nachrichten senden, mit WhatsApp-Vorlagen arbeiten, Zustellberichte lesen. Der Agent handelt mit den Rechten des Tokens, das Sie ihm geben, genau wie Ihr eigener Code. ## Zwei MCP-Server: Wissen und Messaging BroadNet betreibt zwei MCP-Server. Der auf dieser Seite beschriebene Messaging-Server handelt in Ihrem Konto. Der Wissensserver ist öffentlich: Ein Agent kann ihn ohne Anmeldung zu BroadNets Abdeckung, Sender-ID-Regeln, veröffentlichten Listenpreisen, Regulierung und Unternehmensdaten befragen. Wissensserver (öffentlich) Nur-Lese-Antworten aus denselben Daten wie diese Website. Kein Konto, kein Token, keine personenbezogenen Daten. **Endpunkt** https://www.broadnet.me/mcp **Authentifizierung** Keine **Zugriff** Nur Lesen **Tools** search_site, get_facts, check_coverage, sender_id_rules, estimate_price, count_sms_segments, get_regulation, list_answers, get_answer, list_case_studies, get_case_study, get_changelog, get_status **Ratenlimit** 60 Anfragen pro Minute und IP Messaging-Server (Ihr Konto) Sendet und verfolgt Nachrichten mit den Berechtigungen Ihres BroadNet-Tokens. **Endpunkt** https://mcp.broadnet.me/mcp **Authentifizierung** Authorization: Bearer **Zugriff** Handelt in Ihrem Konto Testen Sie den Wissensserver im Terminal: zuerst der initialize-Handshake, dann ein Tool-Aufruf. initialize (Wissensserver) ``` curl -X POST https://www.broadnet.me/mcp \ -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"}}}' ``` tools/call (Wissensserver) ``` curl -X POST https://www.broadnet.me/mcp \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -H "MCP-Protocol-Version: 2025-06-18" \ -d '{"jsonrpc":"2.0","id":2,"method":"tools/call", "params":{"name":"sender_id_rules","arguments":{"country":"ae"}}}' ``` Der Wissensserver unterstützt MCP 2026-07-28 (Metadaten pro Anfrage, server/discover) und die früheren initialize-basierten Revisionen bis 2024-11-05. Die zurückgegebenen Preise sind indikative Listenpreise, keine Angebote; Antworten zur Regulierung sind Planungshilfen, keine Rechtsberatung. ## Endpunkt und Authentifizierung Es gibt einen Endpunkt für alle Konten: https://mcp.broadnet.me/mcp. Jede Anfrage muss Ihr BroadNet-Token in einem Authorization-Header mitsenden. Das Token erhalten Sie über Ihr BroadNet-Konto. In der Demo wird es im BroadAdmin-Portal unter Integrations → MCP Integration mit „Get temporary key“ erzeugt; das Portal weist darauf hin, dass ein dauerhafter Schlüssel vom Administrator Ihres Kontos oder vom Hauptkonto ausgestellt wird. Eine Anfrage ohne den Header wird auf Protokollebene abgewiesen – das ist die tatsächliche Antwort des Servers auf einen nicht authentifizierten initialize-Aufruf: Antwort ohne Token ``` event: message data: {"jsonrpc":"2.0","id":1,"error":{"code":-32001, "message":"Authorization bearer token is required. Connect with an 'Authorization: Bearer ' header."}} ``` ## Einen MCP-Client verbinden Die meisten MCP-Clients erwarten eine JSON-Konfiguration mit Server-URL und Request-Headern. Ein typischer Eintrag sieht so aus: mcp.json ``` { "mcpServers": { "broadnet": { "type": "http", "url": "https://mcp.broadnet.me/mcp", "headers": { "Authorization": "Bearer ${BROADNET_TOKEN}" } } } } ``` Die Feldnamen unterscheiden sich je nach Client leicht (manche erwarten einen type "http" oder "streamable-http", manche lesen Header aus einer separaten Einstellung). Prüfen Sie die MCP-Dokumentation Ihres Clients und halten Sie das Token aus eingecheckten Dateien heraus – nutzen Sie Umgebungsvariablen, wo Ihr Client sie unterstützt. Um die Verbindung ohne Client zu testen, senden Sie die MCP-initialize-Anfrage selbst: initialize-Handshake ``` 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"}}}' ``` ## Was die Demo zeigt Die Aufzeichnung des Produktteams zeigt den gesamten Ablauf in fünf Schritten, mit Cursor als MCP-Client: 1. 1 Anmelden Melden Sie sich mit Ihrem BroadNet-Konto im BroadAdmin-Portal an. 2. 2 Schlüssel und Konfiguration holen Öffnen Sie Integrations → MCP Integration, erzeugen Sie einen temporären Schlüssel und kopieren Sie die fertige Client-Konfiguration. 3. 3 Server im Client hinzufügen Fügen Sie im MCP-Client einen neuen MCP-Server hinzu und fügen Sie die Konfiguration in mcp.json ein – URL https://mcp.broadnet.me/mcp mit dem Bearer-Header. 4. 4 Tools prüfen Der Client verbindet sich und listet die BroadNet-Tools auf; jedes lässt sich einzeln ein- oder ausschalten. 5. 5 In natürlicher Sprache fragen Der Nutzer bittet den Agenten, eine WhatsApp-Nachricht an eine Nummer zu senden. Der Agent wählt das WhatsApp-Sende-Tool, die API antwortet mit HTTP 200 und akzeptierter Nachricht, und die Nachricht kommt in WhatsApp vom Business-Konto an. In der Aufzeichnung meldet der Client 380 BroadNet-Tools, darunter send_message, post_sms_send, post_whatsapp_message_send, get_whatsapp_template_list, post_whatsapp_template_send, post_rcs_message_send, post_telegram_message_send, post_instagram_message_send, post_messenger_message_send, post_push_message_send und get_report_delivery. Die genaue Liste hängt von der Serverversion und Ihrem Konto ab. Eine kommentierte Fassung derselben Aufzeichnung ergänzt eine Übersichtskarte: ein MCP-Endpunkt, dieselben Kopieren-und-Einfügen-Schritte für jeden Agenten. Demoaufnahme (1 Minute 10 Sekunden, kein Ton): Melden Sie sich bei BroadAdmin an, verbinden Sie Cursor mit dem BroadNet-MCP-Server und senden Sie eine WhatsApp-Nachricht in natürlicher Sprache. Vertonte Version (1 Minute 20 Sekunden, mit Voice-over) desselben Ablaufs, mit einer Übersichtsfolie am Anfang. ## Sicherheitshinweise - Das Token ist eine Sende-Berechtigung Wer es besitzt, kann Nachrichten über Ihr Konto senden. Bewahren Sie es wie ein Passwort auf, niemals in einer geteilten oder eingecheckten Datei. - Für Experimente temporäre Schlüssel nutzen Verwenden Sie beim Ausprobieren einen temporären Schlüssel und fordern Sie einen dauerhaften Schlüssel beim Administrator Ihres Kontos nur für einen Produktiv-Agenten an. - Nur benötigte Tools aktivieren MCP-Clients erlauben es, einzelne Tools abzuschalten. Ein Agent, der nur SMS sendet, braucht keine Vorlagen-, Onboarding- oder Konto-Tools. - Einen Menschen einbinden Agenten handeln auf Anweisungen in natürlicher Sprache. Lassen Sie den Client vor Tools, die Nachrichten senden, eine Bestätigung einholen – besonders bei vielen Empfängern. - Ein kompromittiertes Token widerrufen Wird ein Token offengelegt, wenden Sie sich an den Administrator Ihres Kontos oder den BroadNet-Support, um es zu widerrufen und ein neues auszustellen. ## Weiterführend [API-Referenz Die REST-Endpunkte hinter den MCP-Tools, mit Bearer-Authentifizierung.](https://www.broadnet.me/de/developers/api) [OpenAPI-3.1-Spezifikation Die vollständige, maschinenlesbare API-Beschreibung.](https://www.broadnet.me/developers/openapi.yaml) [Schnellstart Senden Sie Ihre erste SMS mit curl oder dem TypeScript SDK.](https://www.broadnet.me/de/developers/quickstart) [Leitfaden: sichere KI-Agenten Wie Agenten über MCP SMS und WhatsApp senden und welche Schutzmechanismen Sie zuerst einrichten.](https://www.broadnet.me/de/blog/mcp-server-sms-whatsapp-ai-agents) ## Fragen ### Wie lautet die URL des BroadNet MCP-Servers? https://mcp.broadnet.me/mcp. Er nutzt den MCP-Transport Streamable HTTP und verlangt einen Authorization: Bearer-Header mit Ihrem BroadNet-Token. ### Welche KI-Clients können sich verbinden? Jeder MCP-Client, der sich per Streamable HTTP mit einem Remote-Server verbinden und einen eigenen Authorization-Header senden kann. Die Demo-Aufzeichnung verwendet Cursor. ### Woher bekomme ich das Token? Aus Ihrem BroadNet-Konto. Im BroadAdmin-Portal stellt Integrations → MCP Integration einen temporären Schlüssel aus; einen dauerhaften Schlüssel erhalten Sie vom Administrator Ihres Kontos oder vom Hauptkonto. ### Kann der Agent echte Nachrichten senden? Ja. In der Demoaufzeichnung liefert der WhatsApp-Versand des Agenten HTTP 200, und die Nachricht kommt auf dem Telefon an. Die Tools arbeiten mit den Berechtigungen Ihres Tokens, genau wie Ihre eigenen API Aufrufe. Behandeln Sie daher jede Sendung als echt: Aktivieren Sie nur die Tools, die der Agent benötigt, und fordern Sie eine Bestätigung für das Senden an. ## Mit BroadNet entwickeln Holen Sie sich ein Konto und ein Token, dann verbinden Sie Ihren Agenten oder rufen die API direkt auf. [Kontakt aufnehmen](https://www.broadnet.me/de/contact) [Entwicklerbereich](https://www.broadnet.me/de/developers)