Aller au contenu
OmniChannels.ai

Serveur MCP WhatsApp : connecter des agents IA au SMS

Comment un serveur MCP WhatsApp permet à Claude, Cursor et d'autres agents IA d'envoyer des messages WhatsApp et SMS en sécurité : mise en place, garde-fous.

Mis à jour le 9 min de lecture

Par OmniChannels.ai Editorial Team · Relu par BroadNet Messaging Solutions Team

Intégration

Réponse courte

Un serveur MCP WhatsApp expose des opérations de messagerie sous forme d'outils qu'un agent IA peut découvrir et appeler via le Model Context Protocol. Avec le serveur MCP d'OmniChannels.ai à l'adresse https://mcp.broadnet.me/mcp, un client comme Claude Code ou Cursor s'authentifie avec un jeton Bearer et peut envoyer des SMS et des messages WhatsApp, lister les modèles et lire les rapports de livraison. L'agent agit avec les permissions de votre compte : les garde-fous sont donc essentiels.

Sur cette page
  1. Qu'est-ce qu'un serveur MCP WhatsApp ?
  2. Comment fonctionne le serveur MCP d'OmniChannels.ai ?
  3. Comment connecter Claude, Cursor ou un autre client ?
  4. Que peut faire un agent IA avec WhatsApp et le SMS ?
  5. Comment empêcher un agent IA d'écrire aux mauvaises personnes ?
  6. Quelles règles WhatsApp et SMS s'appliquent toujours ?
  7. Exemple concret : une équipe de support ajoute un assistant de statut de livraison
  8. Quand MCP est-il le mauvais choix ?
  9. Comment OmniChannels.ai vous aide

Points clés

  • MCP (Model Context Protocol) est un standard ouvert qui permet à un client IA de lister et d'appeler les outils d'un serveur distant ; le serveur OmniChannels.ai associe ses outils à la même API REST que celle utilisée par votre code.
  • Un seul point de terminaison, https://mcp.broadnet.me/mcp en Streamable HTTP, et un seul en-tête, Authorization: Bearer <token>, connectent Claude Code, Cursor, VS Code, Claude Desktop et d'autres clients.
  • Un agent disposant d'outils d'envoi peut écrire à de vraies personnes et dépenser un vrai solde : n'activez que les outils nécessaires et exigez une confirmation humaine avant tout envoi.
  • Les règles WhatsApp s'appliquent toujours aux agents : opt-in, modèles approuvés hors fenêtre de service client et règles de sender ID pour le SMS.
  • Utilisez une clé temporaire pour expérimenter et une clé permanente uniquement pour un agent de production relu.

Ce guide s'adresse aux développeurs et responsables techniques qui veulent qu'un agent IA envoie ou suive des messages WhatsApp et SMS sans écrire à la main chaque intégration. Il explique ce qu'est un serveur MCP WhatsApp, comment en connecter un, quels garde-fous mettre en place avant que l'agent ne touche de vrais clients, et dans quels cas MCP n'est pas le bon outil.

Qu'est-ce qu'un serveur MCP WhatsApp ?

Un serveur MCP WhatsApp est un service qui expose des opérations de messagerie, comme l'envoi d'un modèle ou la lecture d'un rapport de livraison, sous forme d'outils qu'un client IA peut découvrir et appeler. Il parle le Model Context Protocol (MCP), un standard ouvert pour connecter les assistants IA à des outils et des données externes.

Sans MCP, donner à un assistant la capacité d'envoyer un message oblige à écrire une fonction personnalisée pour chaque modèle ou framework. Avec MCP, le client se connecte à une seule URL, demande au serveur quels outils existent et les appelle quand la demande d'un utilisateur en a besoin. Notre entrée de glossaire sur les serveurs MCP en donne la définition courte.

Deux points sont faciles à manquer :

  • MCP ne contourne pas les règles de WhatsApp. Le serveur appelle les mêmes opérations de la plateforme WhatsApp Business que n'importe quelle autre intégration : modèles, opt-in et fenêtre de service client s'appliquent donc toujours.
  • L'agent n'est aussi sûr que son jeton. Les outils agissent avec les permissions, sender ID et solde de la clé que vous fournissez.

Comment fonctionne le serveur MCP d'OmniChannels.ai ?

C'est un serveur MCP distant sur un point de terminaison unique, authentifié par un jeton Bearer. Ses outils correspondent à la même API REST que celle documentée dans la documentation développeur : ce qu'un agent peut faire, c'est ce que votre propre code pourrait faire avec ce jeton.

Paramètre Valeur
Point de terminaison https://mcp.broadnet.me/mcp
Transport MCP Streamable HTTP
Authentification Authorization: Bearer <token> à chaque requête
Agit sur Votre compte : canaux, sender ID, modèles et solde
Domaines d'outils typiques Envoi sur chaque canal (SMS, WhatsApp, RCS, Telegram, Messenger, Instagram, Push), liste et envoi de modèles WhatsApp, lecture des rapports de livraison

La liste exacte des outils dépend de la version du serveur et de votre compte : lisez-la depuis votre client plutôt que dans un article de blog. Une requête sans jeton est refusée au niveau du protocole, ce qui constitue un bon test rapide.

Comment connecter Claude, Cursor ou un autre client ?

Vous ajoutez le point de terminaison et l'en-tête à la configuration MCP de votre client, et gardez le jeton dans une variable d'environnement ou une saisie secrète pour qu'il n'atterrisse jamais dans un dépôt.

Se connecter en cinq étapes

  1. Obtenez une clé. Dans le portail d'administration, ouvrez Intégrations, puis Intégration MCP, et choisissez Obtenir une clé temporaire. Une clé permanente pour un agent de production vient de l'administrateur de votre compte ou du compte maître.
  2. Stockez-la comme secret. Par exemple, exportez-la sous le nom BROADNET_TOKEN dans votre shell.
  3. Ajoutez le serveur à votre client. Pour Claude Code :
claude mcp add --transport http omnichannels https://mcp.broadnet.me/mcp \
  --header "Authorization: Bearer $BROADNET_TOKEN"
  1. Vérifiez les outils. Dans Claude Code, la commande /mcp affiche le serveur et ses outils. Dans Cursor, VS Code et Claude Desktop, la configuration se trouve dans le fichier de paramètres MCP propre au client.
  2. Désactivez ce dont l'agent n'a pas besoin, avant le premier vrai prompt.

Les formats des clients changent d'une version à l'autre : les extraits exacts pour Cursor, VS Code et Claude Desktop figurent dans la documentation, avec des pages pas à pas pour Claude Code, Cursor et n8n. La documentation MCP de Claude Code est la référence pour ses commandes.

Pour tester sans aucun client, envoyez la requête MCP initialize au point de terminaison avec votre jeton. La documentation montre la commande curl complète.

Que peut faire un agent IA avec WhatsApp et le SMS ?

Tout ce que les outils connectés permettent : envoyer, consulter et rendre compte. L'intérêt pratique se situe dans les tâches souples, en langage naturel, autour de la messagerie, plutôt que dans les parcours à fort volume que vous devez garder dans du code.

Exemples de prompts adaptés à un agent :

  • « Envoie un SMS depuis OmniDemo au 447700900123 indiquant que le technicien arrive à 15 h. »
  • « Liste mes modèles WhatsApp approuvés en arabe. »
  • « Envoie le modèle WhatsApp order_update au 971500000000 avec le numéro de commande INV-400. »
  • « Combien de messages de la campagne de relevés d'hier ont échoué, et pourquoi ? »
  • « Prépare une carte RCS pour notre lancement d'automne et montre-la-moi avant d'envoyer quoi que ce soit. »

Bons cas d'usage, par ordre approximatif de sécurité :

Cas d'usage Outils nécessaires Risque
Questions de livraison du personnel de support (« ce client a-t-il reçu le SMS ? ») Outils de rapports en lecture seule Faible
Assistant développeur qui envoie des messages de test à vos propres numéros pendant la construction d'une intégration Outils d'envoi, numéros de test uniquement Faible à moyen
Recherche de modèles et rédaction de textes à relire Outils de liste des modèles Faible
Assistant d'exploitation qui envoie des avis ponctuels après validation humaine Outils d'envoi avec confirmation Moyen
Agent autonome qui écrit aux clients Outils d'envoi, sans confirmation Élevé ; nécessite une conception relue

Un assistant interne qui répond aux questions de livraison n'a besoin d'aucun outil d'envoi. Retirez-les.

Comment empêcher un agent IA d'écrire aux mauvaises personnes ?

Traitez l'agent comme un nouvel employé muni d'un téléphone professionnel : permissions limitées, supervision au début et trace de ce qu'il a fait. La documentation liste les protections ; les voici avec leur raisonnement.

  1. Moindre privilège. N'activez que les outils nécessaires à la tâche. Un agent qui répond aux questions de livraison n'a pas besoin d'outils d'envoi ; celui qui envoie des OTP n'a pas besoin d'outils de modèles ou de compte.
  2. Humain dans la boucle. Configurez le client pour demander une confirmation avant tout outil qui envoie, et toujours avant les envois à de nombreux destinataires. Dans Claude Code, les règles de permission désignent les outils MCP par mcp__<server>__<tool> : vous pouvez ainsi laisser les outils de lecture s'exécuter librement tandis que les outils d'envoi demandent toujours confirmation.
  3. Clés temporaires pour les expériences. Utilisez une clé temporaire pour les tests et une clé permanente uniquement pour un agent de production relu.
  4. D'abord des numéros de test. Orientez les nouveaux agents vers vos propres numéros vérifiés tant que vous ne faites pas confiance à leur comportement.
  5. Surveillez les journaux. Examinez ce que l'agent a envoyé dans vos rapports de livraison, surtout les premières semaines.
  6. Révoquez vite. Si une clé est exposée, demandez à l'administrateur de votre compte ou à notre support de la révoquer et d'en émettre une nouvelle.
  7. Respectez le consentement. Les agents doivent suivre les mêmes règles d'opt-in, de sender ID et de canal que tout autre expéditeur.

L'injection de prompt mérite une mention particulière. Si un agent lit du texte non fiable, comme un message entrant d'un client ou une page web, ce texte peut contenir des instructions. Ne donnez pas à un agent qui lit du contenu non fiable un accès non supervisé aux outils d'envoi. Séparez lecture et envoi en étapes distinctes, avec une personne qui valide l'envoi.

Quelles règles WhatsApp et SMS s'appliquent toujours ?

Toutes. L'agent n'est qu'un expéditeur de plus.

  • Opt-in. La Business Messaging Policy de WhatsApp exige que les personnes aient donné leur opt-in pour recevoir vos messages. Un agent capable d'écrire à n'importe qui dans un tableur n'y change rien.
  • Modèles et fenêtre. Les messages WhatsApp libres ne sont possibles que dans la fenêtre de service client ; en dehors, il faut un modèle approuvé. Voir notre guide de la fenêtre de service client de 24 heures et la documentation de l'API WhatsApp.
  • Coût. Meta facture chaque message délivré selon la catégorie, et un agent peut générer du volume très vite. Plafonnez ce qu'il peut envoyer et chiffrez les coûts avec notre calculateur de tarifs WhatsApp.
  • Sender ID SMS. Le SMS exige un sender ID enregistré dans de nombreux pays. L'agent utilise les sender ID approuvés sur votre compte.

Exemple concret : une équipe de support ajoute un assistant de statut de livraison

« Souq Rafiq » (société fictive), enseigne de e-commerce aux Émirats arabes unis, veut que son personnel de support puisse répondre à « le client a-t-il reçu notre message ? » sans ouvrir de tableaux de bord.

  • Mise en place : un administrateur génère une clé temporaire et connecte Claude Desktop au serveur MCP pour deux responsables de support.
  • Outils : seuls les outils de lecture de rapports sont activés. Les outils d'envoi sont désactivés.
  • Usage : un responsable demande : « Combien de messages de la campagne de relevés d'hier ont échoué, et pourquoi ? » L'agent lit le rapport de livraison et résume les motifs par statut.
  • Revue : au bout de deux semaines, l'administrateur vérifie les rapports de livraison, confirme que rien n'a été envoyé et demande une clé permanente pour un petit assistant de production.
  • Étape suivante : pour permettre à l'assistant de renvoyer un avis manqué, l'équipe active un outil d'envoi avec confirmation et le limite d'abord à un groupe de numéros de test.

Quand MCP est-il le mauvais choix ?

Utilisez l'API REST, la spécification OpenAPI ou le SDK pour tout ce qui est déterministe et à fort volume.

  • OTP et parcours transactionnels. Un code de connexion doit venir d'un code que vous maîtrisez, pas d'un modèle qui pourrait le paraphraser. Voir le démarrage rapide REST.
  • Campagnes en masse. Utilisez les outils de campagne ou les points de terminaison d'envoi en masse avec un fichier relu, pas un prompt conversationnel.
  • Chat client sans surveillance. Un agent en contact avec les clients exige un parcours conversationnel conçu, des connaissances, une passation à des humains et une supervision. C'est un produit d'agent IA, pas une session MCP de développeur.
  • Limites de ce guide. Les formats de configuration des clients et la liste des outils changent d'une version à l'autre. Confirmez les deux dans la documentation et dans votre client.

Comment OmniChannels.ai vous aide

OmniChannels.ai fournit le serveur MCP à l'adresse https://mcp.broadnet.me/mcp en plus de l'API REST à l'adresse https://api.broadnet.me, avec un modèle de jeton Bearer unique pour SMS, WhatsApp, RCS, Messenger, Instagram, Telegram, e-mail et Push. BroadNet est un Meta Business Solution Provider officiel, et son produit d'agents IA prend en charge l'anglais et l'arabe avec passation à un agent humain et utilisation d'outils via MCP ; voir agents IA. L'accès de test est limité à vos propres numéros vérifiés. Commencez par le guide MCP et la présentation développeur.

Questions fréquentes

Qu'est-ce qu'un serveur MCP ?

Un serveur MCP est un programme qui propose des outils à des clients IA via le Model Context Protocol, un standard ouvert. Le client se connecte, liste les outils et les appelle lorsque la demande d'un utilisateur en a besoin. Un serveur MCP distant s'exécute sur l'infrastructure du fournisseur : vous vous connectez donc à une URL et vous vous authentifiez, au lieu d'installer du code.

Claude peut-il envoyer des messages WhatsApp ?

Claude ne peut pas atteindre WhatsApp seul, mais un client Claude qui prend en charge MCP peut appeler les outils d'un serveur MCP de messagerie. Avec le serveur MCP d'OmniChannels.ai connecté, Claude Code ou Claude Desktop peut envoyer un modèle WhatsApp approuvé ou un SMS depuis votre compte, sous réserve de vos réglages d'outils et des règles de Meta.

Est-il sûr de laisser un agent IA envoyer des messages ?

Ce n'est sûr qu'avec des garde-fous. Activez le minimum d'outils, exigez une confirmation humaine pour les envois, testez d'abord vers vos propres numéros vérifiés, utilisez des clés temporaires pendant l'expérimentation et examinez les rapports de livraison. L'agent agit avec les permissions de votre jeton : il peut dépenser du solde et joindre de vraies personnes si vous l'autorisez.

Faut-il un modèle WhatsApp pour qu'un agent écrive à quelqu'un ?

Oui, hors de la fenêtre de service client. Meta n'autorise les messages libres que tant qu'une fenêtre ouverte par le client est active ; sinon l'entreprise doit envoyer un modèle approuvé. Un agent peut lister vos modèles approuvés et en envoyer un par son nom, mais il ne peut pas inventer sur-le-champ un nouveau modèle approuvé.

Le serveur MCP remplace-t-il l'API REST ?

Non. Les outils correspondent à la même API REST, avec le même jeton et les mêmes permissions. Utilisez MCP quand un client IA doit découvrir et appeler lui-même les opérations, et l'API REST, la spécification OpenAPI ou le SDK pour du code de production déterministe comme les parcours d'OTP et les notifications de commande.

Comment obtenir une clé MCP ?

Connectez-vous au portail d'administration, ouvrez Intégrations puis Intégration MCP, et choisissez Obtenir une clé temporaire. Une clé permanente pour un agent de production est délivrée par l'administrateur de votre compte ou le compte maître. L'accès de test est limité à vos propres numéros vérifiés, et il n'existe pas d'inscription instantanée en libre-service.

Sources

  1. Spécification du Model Context Protocol (2025-06-18)
  2. Connecter Claude Code à des outils via MCP — documentation de Claude Code
  3. Politique de messagerie WhatsApp Business
  4. Tarification de la plateforme WhatsApp Business — Meta for Developers