KI-Agenten per MCP mit BroadNet verbinden.

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.

Testen Sie den Wissensserver im Terminal: zuerst der initialize-Handshake, dann ein Tool-Aufruf.

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"}}}'

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"}}}'

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:

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."}}

Einen MCP-Client verbinden

Die meisten MCP-Clients erwarten eine JSON-Konfiguration mit Server-URL und Request-Headern. Ein typischer Eintrag sieht so aus:

{
  "mcpServers": {
    "broadnet": {
      "type": "http",
      "url": "https://mcp.broadnet.me/mcp",
      "headers": {
        "Authorization": "Bearer ${BROADNET_TOKEN}"
      }
    }
  }
}

Um die Verbindung ohne Client zu testen, senden Sie die MCP-initialize-Anfrage selbst:

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.

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

Fragen