MCP

engagelab-sms-mcp est un serveur MCP (Model Context Protocol) qui permet aux assistants IA d'envoyer des SMS via la plateforme EngageLab. Après avoir ajouté ce serveur à un client compatible MCP (comme Cursor, Claude Desktop, etc.), l'IA peut effectuer à votre place des opérations d'envoi de SMS basées sur des modèles.

Prérequis

Node.js 18+
Disposer d'un compte EngageLab et avoir obtenu les identifiants de l'API SMS (dev_key et dev_secret)
Disposer d'au moins un modèle SMS validé

Astuce : les identifiants API peuvent être créés et gérés sur la page API Key de la console EngageLab.

Méthode de configuration

Cursor

Accédez à Settings > MCP, cliquez sur Add new MCP server et collez la configuration suivante :

{ "mcpServers": { "engagelab-sms": { "command": "npx", "args": ["-y", "engagelab-sms-mcp"], "env": { "ENGAGELAB_DEV_KEY": "<your_dev_key>", "ENGAGELAB_DEV_SECRET": "<your_dev_secret>" } } } }

              
              {
  "mcpServers": {
    "engagelab-sms": {
      "command": "npx",
      "args": ["-y", "engagelab-sms-mcp"],
      "env": {
        "ENGAGELAB_DEV_KEY": "<your_dev_key>",
        "ENGAGELAB_DEV_SECRET": "<your_dev_secret>"
      }
    }
  }
}

Afficher ce bloc de code dans la fenêtre flottante

Remplacez <your_dev_key> et <your_dev_secret> par les identifiants réels obtenus dans votre console EngageLab.

Claude Desktop

Ouvrez Settings > Developer > Edit Config et ajoutez ce qui suit dans mcpServers :

{ "mcpServers": { "engagelab-sms": { "command": "npx", "args": ["-y", "engagelab-sms-mcp"], "env": { "ENGAGELAB_DEV_KEY": "<your_dev_key>", "ENGAGELAB_DEV_SECRET": "<your_dev_secret>" } } } }

              
              {
  "mcpServers": {
    "engagelab-sms": {
      "command": "npx",
      "args": ["-y", "engagelab-sms-mcp"],
      "env": {
        "ENGAGELAB_DEV_KEY": "<your_dev_key>",
        "ENGAGELAB_DEV_SECRET": "<your_dev_secret>"
      }
    }
  }
}

Afficher ce bloc de code dans la fenêtre flottante

Autres clients MCP

Tout client MCP prenant en charge le transport stdio peut utiliser ce serveur. Définissez la commande de démarrage sur npx -y engagelab-sms-mcp et transmettez les variables d'environnement requises.

Outils disponibles

send_sms

Envoie un SMS à l'aide d'un modèle pré-validé via EngageLab.

Paramètres de requête :

Champ	Type	Obligatoire	Description
to	string[]	Oui	Liste des numéros de mobile cibles, format international recommandé (ex. `+6581234567`)
template.id	string	Oui	ID de modèle SMS EngageLab validé
template.params	object	Oui	Valeurs des variables du modèle, ex. `{"code": "123456"}`

Exemple de requête :

{ "to": ["+6581234567"], "template": { "id": "your-template-id", "params": { "code": "123456" } } }

              
              {
  "to": ["+6581234567"],
  "template": {
    "id": "your-template-id",
    "params": {
      "code": "123456"
    }
  }
}

Afficher ce bloc de code dans la fenêtre flottante

Paramètres de réponse :

Champ	Type	Description
success	boolean	Indique si la requête a été acceptée
plan_id	string	ID de plan EngageLab, utilisé pour le suivi
total_count	number	Nombre total de destinataires soumis
accepted_count	number	Nombre de destinataires acceptés pour la distribution
message_id	string	Identifiant du message (le cas échéant)
message	string	Description de l'état ou de l'erreur
code	number	Code de réponse EngageLab (0 signifie succès)

Variables d'environnement

Variable	Obligatoire	Valeur par défaut	Description
ENGAGELAB_DEV_KEY	Oui	—	dev key EngageLab
ENGAGELAB_DEV_SECRET	Oui	—	dev secret EngageLab
ENGAGELAB_BASE_URL	Non	`https://smsapi.engagelab.com`	URL de base de l'API
ENGAGELAB_REQUEST_TIMEOUT_MS	Non	`10000`	Délai d'expiration de la requête (ms)
ENGAGELAB_MAX_RETRIES	Non	`1`	Nombre maximal de tentatives en cas d'échec

Questions fréquentes

Le serveur ne démarre pas et affiche « Missing required environment variable »

Vérifiez que vous avez correctement renseigné ENGAGELAB_DEV_KEY et ENGAGELAB_DEV_SECRET dans la configuration env de votre client MCP.

send_sms renvoie le code d'erreur 3002 (« invalid template id format »)

Vérifiez que l'ID de modèle correspond bien à un modèle validé dans votre console EngageLab.

send_sms renvoie une erreur liée aux paramètres du modèle

Vérifiez que les noms de clés dans template.params correspondent exactement aux noms des variables définies dans votre modèle EngageLab.

Le SMS n'est pas reçu

Utilisez le format de numéro de téléphone international (ex. +6581234567).
Vérifiez que le modèle est validé et n'a pas été désactivé.