Connectez vos agents IA à BroadNet avec MCP.

Qu'est-ce que le serveur MCP

Le Model Context Protocol (MCP) est un standard ouvert qui permet aux assistants IA de découvrir et d'appeler des outils externes. Le serveur MCP BroadNet est un serveur distant : votre client s'y connecte en HTTPS, liste les outils proposés et les appelle pour vous.

Ces outils correspondent à la même API BroadNet que celle décrite dans la référence de l'API et dans la spécification OpenAPI — envoi de messages, modèles WhatsApp, rapports de remise. L'agent agit avec les droits du jeton que vous lui donnez, exactement comme votre propre code.

Deux serveurs MCP : connaissances et messagerie

BroadNet exploite deux serveurs MCP. Le serveur de messagerie décrit sur cette page agit sur votre compte. Le serveur de connaissances est public : un agent peut l'interroger sur la couverture de BroadNet, les règles de Sender ID, les tarifs catalogue publiés, la réglementation et les données de l'entreprise, sans connexion.

Essayez le serveur de connaissances depuis un terminal : la poignée de main initialize, puis un appel d'outil.

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

Point d'accès et authentification

Un seul point d'accès pour tous les comptes : https://mcp.broadnet.me/mcp. Chaque requête doit transmettre votre jeton BroadNet dans un en-tête Authorization.

Le jeton s'obtient depuis votre compte BroadNet. Dans la démo, il est généré dans le portail BroadAdmin, sous Integrations → MCP Integration, avec « Get temporary key » ; le portail précise qu'une clé permanente est délivrée par l'administrateur de votre compte ou le compte principal.

Une requête sans cet en-tête est refusée au niveau du protocole — voici la réponse réelle du serveur à un appel initialize non authentifié :

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

Connecter un client MCP

La plupart des clients MCP acceptent une configuration JSON avec l'URL du serveur et les en-têtes de requête. Une entrée type ressemble à ceci :

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

Pour tester la connexion sans client, envoyez vous-même la requête MCP initialize :

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

Ce que montre la démo

L'enregistrement de l'équipe produit présente le parcours complet en cinq étapes, avec Cursor comme client MCP :

1. 1
   Se connecter

   Connectez-vous au portail BroadAdmin avec votre compte BroadNet.

2. 2
   Obtenir une clé et la configuration

   Ouvrez Integrations → MCP Integration, générez une clé temporaire et copiez la configuration client prête à l'emploi.

3. 3
   Ajouter le serveur au client

   Dans le client MCP, ajoutez un nouveau serveur MCP et collez la configuration dans mcp.json — URL https://mcp.broadnet.me/mcp avec l'en-tête Bearer.

4. 4
   Passer en revue les outils

   Le client se connecte et liste les outils BroadNet, chacun pouvant être activé ou désactivé.

5. 5
   Demander en langage naturel

   L'utilisateur demande à l'agent d'envoyer un message WhatsApp à un numéro. L'agent choisit l'outil d'envoi WhatsApp, l'API répond HTTP 200 avec le message accepté, et le message arrive dans WhatsApp depuis le compte professionnel.

Dans l'enregistrement, le client affiche 380 outils BroadNet, parmi lesquels 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 et get_report_delivery. La liste exacte dépend de la version du serveur et de votre compte.

Une version commentée du même enregistrement ajoute une carte de présentation : un seul point d'accès MCP, les mêmes étapes de copier-coller pour chaque agent.

Consignes de sécurité

• Le jeton est un identifiant d'envoi

  Quiconque le détient peut envoyer des messages depuis votre compte. Conservez-le comme un mot de passe, jamais dans un fichier partagé ou versionné.

• Préférez les clés temporaires pour les essais

  Utilisez une clé temporaire pendant vos tests et ne demandez une clé permanente à l'administrateur de votre compte que pour un agent de production.

• N'activez que les outils nécessaires

  Les clients MCP permettent de désactiver des outils un par un. Un agent qui n'envoie que des SMS n'a pas besoin des outils de modèles, d'onboarding ou de compte.

• Gardez un humain dans la boucle

  Les agents agissent sur des instructions en langage naturel. Faites demander une confirmation au client avant les outils qui envoient des messages, surtout vers de nombreux destinataires.

• Révoquez un jeton compromis

  Si un jeton est exposé, contactez l'administrateur de votre compte ou le support BroadNet pour le révoquer et en émettre un nouveau.

Voir aussi

Questions