--- title: "Claude Code + OmniChannels.ai : développez et testez la messagerie depuis votre terminal" description: "Ajoutez le serveur MCP OmniChannels.ai à Claude Code pour envoyer des tests, suivre leur livraison et coder WhatsApp et SMS d'après notre spécification OpenAPI." canonical: "https://omnichannels.ai/fr/integrations/claude-code/" language: "fr" updated: "2026-10-10" publisher: "BroadNet Technologies" brand: "OmniChannels.ai" --- # Claude Code + OmniChannels.ai : développez et testez la messagerie depuis votre terminal Canonical: https://omnichannels.ai/fr/integrations/claude-code/ Language: fr Publisher: OmniChannels.ai by BroadNet Technologies **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. Connexion via MCP · Connexion via API et webhooks ## 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__ - 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: https://omnichannels.ai/developers/mcp/) 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: https://omnichannels.ai/developers/mcp-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: https://omnichannels.ai/developers/mcp-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: https://omnichannels.ai/developers/openapi/) 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. ## Exemple de flux Claude Code (Écrit votre intégration et appelle les outils sur demande) → MCP et API OmniChannels.ai (Outils MCP pour les tests ; votre code appelle l'API REST) → Votre téléphone de test (SMS ou WhatsApp de test vers votre numéro vérifié) → Votre gestionnaire de webhooks (Reçoit les statuts de livraison et les messages entrants) ## Questions ### Existe-t-il un plugin OmniChannels.ai officiel pour Claude Code ? Non. Claude Code se connecte grâce à sa prise en charge standard des serveurs MCP distants, avec notre point de terminaison public et votre jeton d'API, et lit notre spécification OpenAPI publique comme n'importe quel autre fichier de votre dépôt. ### Comment partager le serveur avec mon équipe sans partager de clé ? Versionnez un fichier .mcp.json au niveau du projet dont l'en-tête Authorization utilise ${BROADNET_TOKEN}. Chaque développeur définit cette variable dans son propre shell, et Claude Code lui demande d'approuver le serveur du projet avant de l'utiliser. ### Claude Code peut-il envoyer des messages sans demander ? Par défaut, Claude Code demande avant d'utiliser un outil MCP. Conservez ce comportement pour les outils d'envoi, car chaque envoi est un message réel et facturé. N'autorisez que les outils de lecture dans vos règles d'autorisation, et vérifiez d'abord les noms des outils sous /mcp, car ils dépendent de la version du serveur et de votre compte. ### Dois-je utiliser MCP ou l'API REST dans mon produit ? Utilisez MCP pour que Claude Code puisse tester et inspecter votre compte pendant le développement. Le code que vous livrez doit appeler directement l'API REST avec un jeton issu de votre coffre de secrets, en s'appuyant sur la spécification OpenAPI pour les champs exacts. ## Guides développeurs - https://omnichannels.ai/developers/mcp-claude-code/ - https://omnichannels.ai/developers/openapi/ - https://omnichannels.ai/developers/webhooks/ - https://omnichannels.ai/developers/mcp/ ## Documentation de l'éditeur - [Connect Claude Code to tools via MCP](https://code.claude.com/docs/en/mcp) - [Claude Code permissions](https://code.claude.com/docs/en/permissions) ## Intégrations associées - https://omnichannels.ai/fr/integrations/claude/ - https://omnichannels.ai/fr/integrations/cursor/ - https://omnichannels.ai/fr/integrations/vs-code/ - https://omnichannels.ai/fr/integrations/langchain/ 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. Mis à jour le: 2026-10-10