Aller au contenu
OmniChannels.ai

Assistants et agents IA

Cursor + OmniChannels.ai : envoyez et suivez vos messages pendant le développement

Connexion via MCPConnexion via API et webhooksMis à jour le

En bref

Cursor se connecte à OmniChannels.ai via notre serveur MCP distant, https://mcp.broadnet.me/mcp. Ajoutez-le à .cursor/mcp.json avec votre jeton dans un en-tête Authorization lu depuis une variable d'environnement. L'agent de Cursor peut alors envoyer des messages WhatsApp, SMS et RCS, lister vos modèles approuvés et lire les rapports de livraison, en demandant votre approbation avant chaque appel d'outil. Aucune extension n'est nécessaire.

Ce que vous pouvez faire

  • Envoyer des messages de test en codant

    Vérifiez un flux de messages de bout en bout sans quitter l'éditeur, en n'envoyant qu'à vos numéros vérifiés.

    Exemple de demande

    “Envoie un message WhatsApp au 971500000000 pour indiquer que la commande a été expédiée.”

  • Retrouver noms et variables des modèles

    L'agent liste vos modèles WhatsApp approuvés pour que votre code utilise exactement les bons noms et paramètres.

    Exemple de demande

    “Liste mes modèles WhatsApp approuvés en arabe et montre les variables attendues par chacun.”

  • Déboguer les problèmes de livraison

    Lisez le rapport de livraison d'un message que votre code vient d'envoyer et voyez pourquoi il a échoué.

    Exemple de demande

    “Vérifie le rapport de livraison du dernier message que j'ai envoyé et explique un éventuel échec.”

  • Écrire le code d'intégration à partir de la spécification

    Fournissez à l'agent notre spécification OpenAPI pour que les appels REST qu'il écrit utilisent exactement les bons champs, y compris pour les envois multipart.

    Exemple de demande

    “À partir de la spécification OpenAPI, écris une fonction TypeScript qui envoie une campagne SMS en masse.”

Comment la connexion fonctionne

Connexion via MCPConnexion via API et webhooks

OmniChannels.ai exploite un serveur MCP distant en Streamable HTTP. Cursor lit les serveurs MCP dans .cursor/mcp.json au niveau d'un projet, ou dans ~/.cursor/mcp.json pour tous les projets, et résout ${env:NAME} dans les champs url et headers : le jeton peut ainsi rester dans une variable d'environnement plutôt que dans le fichier.

Une fois connecté, Cursor liste les outils du serveur dans ses paramètres MCP, où vous pouvez activer ou désactiver chacun d'eux. Par défaut, Cursor demande une approbation avant d'exécuter un outil MCP et affiche d'abord les arguments. Gardez l'approbation activée pour chaque outil d'envoi, car chaque envoi est un message réel et facturé.

  • Point de terminaison : https://mcp.broadnet.me/mcp (Streamable HTTP)
  • En-tête : Authorization: Bearer ${env:BROADNET_TOKEN}
  • Configuration : .cursor/mcp.json (projet) ou ~/.cursor/mcp.json (global)
  • Diagnostic dans le panneau Output, sous MCP Logs

Mise en place

  1. 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. 2

    Obtenir une clé MCP

    Dans le portail d'administration, ouvrez Integrations, puis MCP Integration, et choisissez Get temporary key.

    Guide: MCP server for AI agents
  3. 3

    Ajouter le serveur à mcp.json

    Ajoutez une entrée omnichannels sous mcpServers avec notre URL et un en-tête Authorization qui lit ${env:BROADNET_TOKEN}.

    Guide: Use the MCP server with Cursor
  4. 4

    Définir la variable et redémarrer

    Définissez BROADNET_TOKEN dans l'environnement depuis lequel Cursor démarre, par exemple votre profil de shell, puis redémarrez Cursor.

  5. 5

    Passer en revue les outils

    Dans les paramètres MCP de Cursor, désactivez tous les outils dont l'agent n'a pas besoin et gardez l'approbation activée pour les outils d'envoi.

  6. 6

    Envoyer un premier message

    Demandez à l'agent d'envoyer un message de test à votre numéro vérifié, approuvez l'appel, puis consultez le rapport de livraison.

Documentation de l'éditeur

Cursor est une marque de son propriétaire. OmniChannels.ai n'est ni affilié à Cursor ni approuvé par lui ; cette page décrit une connexion réalisée avec les fonctions MCP, HTTP ou webhook propres à Cursor.

Exemple de flux

Le parcours d'une demande type, de Cursor jusqu'à votre client, puis retour.

  1. 01

    Agent Cursor

    Une demande dans le chat de l'agent

  2. 02

    Serveur MCP OmniChannels.ai

    L'outil s'exécute après votre approbation de l'appel

  3. 03

    Votre téléphone de test

    Message WhatsApp, SMS ou RCS délivré

  4. 04

    Rapport de livraison

    L'agent relit le statut avec un outil de lecture

1. Agent Cursor: Une demande dans le chat de l'agent 2. Serveur MCP OmniChannels.ai: L'outil s'exécute après votre approbation de l'appel 3. Votre téléphone de test: Message WhatsApp, SMS ou RCS délivré 4. Rapport de livraison: L'agent relit le statut avec un outil de lecture

Questions

Existe-t-il une extension OmniChannels.ai officielle pour Cursor ?

Non. Cursor se connecte grâce à sa prise en charge standard de MCP, avec notre point de terminaison MCP public et votre jeton d'API dans .cursor/mcp.json. Rien n'est à installer.

Puis-je versionner .cursor/mcp.json dans mon dépôt ?

Oui, si le jeton est lu depuis une variable d'environnement avec ${env:BROADNET_TOKEN}. La configuration prête à l'emploi fournie par le portail contient la clé elle-même : gardez cette version hors du contrôle de version.

Le serveur affiche une erreur ou aucun outil. Que vérifier ?

Ouvrez le panneau Output et choisissez MCP Logs. Une erreur d'autorisation signifie que l'en-tête est absent ou que la clé est incorrecte ou expirée. Une variable vide signifie que Cursor a été lancé sans que BROADNET_TOKEN soit défini.

Sur quels canaux l'agent peut-il envoyer ?

Les outils couvrent l'envoi sur chaque canal activé sur votre compte, par exemple SMS, WhatsApp, RCS, Telegram, Messenger, Instagram et notifications push. La liste exacte des outils dépend de la version du serveur et de votre compte.

Obtenez un accès API et MCP

Indiquez vos canaux, pays et cas d'usage. Un ingénieur émet vos identifiants de test et vérifie vos numéros de test.