# Connectez vos agents IA à BroadNet avec MCP.

- URL canonique: https://www.broadnet.me/fr/developers/mcp
- Langue: fr
- Dernière mise à jour: 2026-10-21
- Éditeur: BroadNet (https://www.broadnet.me)
- Version Markdown de la page, générée à partir de la page affichée.

Model Context Protocol· /developers/mcp

Le serveur MCP BroadNet expose l'API de messagerie BroadNet sous forme d'outils qu'un agent IA peut appeler. Pointez n'importe quel client MCP compatible avec les serveurs distants vers un seul point d'accès, authentifiez-vous avec votre jeton BroadNet, et l'agent peut envoyer et suivre des messages sur votre compte.

**Point d'accès**

https://mcp.broadnet.me/mcp

**Transport**

MCP Streamable HTTP

**Authentification**

Authorization: Bearer <token>

**Canaux**

WhatsApp, SMS, RCS, Telegram, Push, e-mail, Messenger, Instagram

## 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.

Serveur de connaissances (public)

Des réponses en lecture seule, issues des mêmes données que ce site. Pas de compte, pas de jeton, pas de données personnelles.

**Point de terminaison**

https://www.broadnet.me/mcp

**Authentification**

Aucune

**Accès**

Lecture seule

**Outils**

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

**Limite de débit**

60 requêtes par minute et par IP

Serveur de messagerie (votre compte)

Envoie et suit des messages avec les autorisations de votre jeton BroadNet.

**Point de terminaison**

https://mcp.broadnet.me/mcp

**Authentification**

Authorization: Bearer <token>

**Accès**

Agit sur votre compte

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

initialize (serveur de connaissances)

```
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 (serveur de connaissances)

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

Le serveur de connaissances prend en charge MCP 2026-07-28 (métadonnées par requête, server/discover) et les révisions antérieures fondées sur initialize jusqu'à 2024-11-05. Les prix renvoyés sont des tarifs catalogue indicatifs, pas des devis ; les réponses réglementaires sont une aide à la planification, pas un avis juridique.

## 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é :

réponse sans jeton

```
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 :

mcp.json

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

Les noms de champs varient légèrement d'un client à l'autre (certains attendent un type "http" ou "streamable-http", d'autres lisent les en-têtes dans un réglage séparé). Consultez la documentation MCP de votre client et gardez le jeton hors des fichiers versionnés — utilisez les variables d'environnement si votre client les prend en charge.

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

poignée de main 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.

Enregistrement de démonstration (1 min 10 s, sans son) : connectez-vous à BroadAdmin, connectez Cursor au serveur BroadNet MCP et envoyez un message WhatsApp en langage clair.

Version commentée (1 min 20 s, avec voix off) du même parcours, avec une carte de présentation au début.

## 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

[Référence de l'API Les points d'accès REST derrière les outils MCP, avec authentification Bearer.](https://www.broadnet.me/fr/developers/api) [Spécification OpenAPI 3.1 La description complète de l'API, lisible par machine.](https://www.broadnet.me/developers/openapi.yaml) [Démarrage rapide Envoyez votre premier SMS avec curl ou le SDK TypeScript.](https://www.broadnet.me/fr/developers/quickstart) [Guide : des agents IA sûrs Comment les agents envoient des SMS et des messages WhatsApp via MCP, et les garde-fous à mettre en place d'abord.](https://www.broadnet.me/fr/blog/mcp-server-sms-whatsapp-ai-agents)

## Questions

### Quelle est l'URL du serveur MCP BroadNet ?

https://mcp.broadnet.me/mcp. Il utilise le transport MCP Streamable HTTP et exige un en-tête Authorization: Bearer contenant votre jeton BroadNet.

### Quels clients IA peuvent se connecter ?

Tout client MCP capable de se connecter à un serveur distant en Streamable HTTP et d'envoyer un en-tête Authorization personnalisé. L'enregistrement de démonstration utilise Cursor.

### Où obtenir le jeton ?

Depuis votre compte BroadNet. Dans le portail BroadAdmin, Integrations → MCP Integration délivre une clé temporaire ; une clé permanente est fournie par l'administrateur de votre compte ou le compte principal.

### L'agent peut-il envoyer de vrais messages ?

Oui. Dans l'enregistrement de démonstration, l'envoi WhatsApp de l'agent renvoie un HTTP 200 et le message arrive sur le téléphone. Les outils fonctionnent avec les autorisations de votre jeton, exactement comme le feraient vos propres appels API. Par conséquent, considérez chaque envoi comme réel : activez uniquement les outils dont l'agent a besoin et exigez une confirmation pour chaque envoi.

## Développez avec BroadNet

Obtenez un compte et un jeton, puis connectez votre agent ou appelez directement l'API.

[Nous contacter](https://www.broadnet.me/fr/contact) [Espace développeurs](https://www.broadnet.me/fr/developers)