En bref
Claude Code se connecte à OmniChannels.ai en une commande : claude mcp add --transport http vers https://mcp.broadnet.me/mcp avec un en-tête Authorization: Bearer. Il peut alors envoyer des messages de test, lister les modèles WhatsApp et lire les rapports de livraison tout en écrivant votre code d'intégration à partir de notre spécification OpenAPI 3.1. Les équipes partagent le serveur dans .mcp.json, et des règles d'autorisation déterminent quels outils s'exécutent sans demande.
Ce que vous pouvez faire
Coder à partir des vrais modèles
Claude Code lit vos modèles WhatsApp approuvés via MCP et écrit une fonction avec exactement les variables requises par chacun.
Exemple de demande
“Utilise les outils omnichannels pour lister mes modèles WhatsApp approuvés, puis écris une fonction TypeScript qui envoie order_update avec les champs nécessaires.”
Créer un gestionnaire de webhooks
Indiquez à Claude Code le guide des webhooks : il écrit un point de terminaison qui enregistre les statuts de livraison et les messages entrants, en tolérant les champs qui varient selon le canal.
Exemple de demande
“Écris un gestionnaire de webhook Express qui enregistre les statuts SUBMITTED, SENT, DELIVERED, READ, FAILED et REJECTED par identifiant de message et journalise les champs inconnus au lieu d'échouer.”
Générer un client typé à partir de la spécification
Avec la spécification OpenAPI enregistrée dans votre dépôt, Claude Code utilise les chemins et champs exacts au lieu de les deviner.
Exemple de demande
“À partir de docs/omnichannels-openapi.yaml, écris un module Python qui envoie un SMS avec POST /sms/sendSms et liste chaque champ utilisé avec son type selon la spécification.”
Tester de bout en bout sur votre propre numéro
Claude Code envoie un message de test après votre approbation de l'appel d'outil, puis vérifie le rapport de livraison pour confirmer que votre code fonctionne.
Exemple de demande
“Envoie un SMS de test depuis OmniDemo à mon numéro 447700900123, puis vérifie son rapport de livraison.”
Déboguer les envois en échec
Les outils de lecture permettent à Claude Code de comparer les rapports de livraison avec vos journaux et de remonter un échec jusqu'à la requête qui l'a provoqué.
Exemple de demande
“Lis le rapport de livraison de la campagne d'hier, résume les causes d'échec et vérifie notre code de nouvelle tentative au regard du guide des erreurs.”
Comment la connexion fonctionne
Claude Code ajoute des serveurs MCP distants avec claude mcp add --transport http et un en-tête Authorization. Votre shell développe le jeton depuis une variable d'environnement lorsque vous lancez la commande ; en équipe, un fichier .mcp.json au niveau du projet permet à chaque développeur de fournir son propre jeton via ${BROADNET_TOKEN}, et Claude Code demande à chacun d'approuver le serveur avant de l'utiliser.
MCP sert à agir sur votre compte : envoyer des messages de test, lire les modèles et les rapports de livraison. Pour écrire le code d'intégration, fournissez à Claude Code notre spécification OpenAPI 3.1 comme référence pour les points de terminaison et les champs, ainsi que le guide des webhooks, car les charges utiles des webhooks ne figurent pas dans la spécification. Des règles d'autorisation telles que mcp__omnichannels__get_* laissent les outils de lecture s'exécuter sans demande, tandis que les outils d'envoi continuent de demander.
- Commande : claude mcp add --transport http omnichannels https://mcp.broadnet.me/mcp
- En équipe : versionnez .mcp.json avec Bearer ${BROADNET_TOKEN}, jamais une clé
- Les règles d'autorisation nomment les outils mcp__omnichannels__<tool>
- Spécification OpenAPI 3.1 sur /developers/openapi.json pour les champs exacts des requêtes
- Le SMS unique utilise JSON ; les envois en masse et la plupart des autres canaux utilisent multipart/form-data
Mise en place
- 1
Demander un accès à l'API
Demandez un accès de test et recevez un jeton d'API. Les envois de test ne partent que vers vos propres numéros vérifiés.
- 2
Obtenir une clé temporaire
Dans le portail d'administration, ouvrez Integrations, puis MCP Integration, choisissez Get temporary key et exportez-la sous BROADNET_TOKEN.
Guide: MCP server for AI agents - 3
Ajouter le serveur
Exécutez claude mcp add --transport http omnichannels https://mcp.broadnet.me/mcp avec l'en-tête Authorization, ou versionnez un fichier .mcp.json de projet pour votre équipe, puis vérifiez avec /mcp.
Guide: Use the MCP server with Claude Code - 4
Définir les règles d'autorisation
Autorisez si vous le souhaitez les outils de lecture comme mcp__omnichannels__get_*, laissez chaque outil d'envoi en mode demande et refusez les outils inutiles au projet.
Guide: Use the MCP server with Claude Code - 5
Ajouter la spécification OpenAPI
Téléchargez openapi.yaml dans votre dépôt et demandez à Claude Code de s'en servir pour les chemins, les champs et les énumérations.
Guide: OpenAPI 3.1 spec - 6
Tester sur votre propre numéro
Demandez à Claude Code d'envoyer un message de test à votre numéro vérifié, puis de relire le rapport de livraison.
Documentation de l'éditeur
Claude Code est une marque de son propriétaire. OmniChannels.ai n'est ni affilié à Claude Code ni approuvé par lui ; cette page décrit une connexion réalisée avec les fonctions MCP, HTTP ou webhook propres à Claude Code.
