Intégrer à l'IA (MCP)

Le serveur MCP de GetSMS donne à votre assistant IA les outils pour envoyer des SMS au Maroc, suivre leur livraison et consulter votre solde. Il suit le Model Context Protocol, compris par Claude, Cursor, VS Code et la plupart des agents.

Vous demandez en langage naturel, l’assistant appelle l’API pour vous :

Envoie « Votre commande #8841 est prête, passez la récupérer avant 19 h » au 06 12 34 56 78, puis dis-moi s’il a été livré.

Installer

1. Ouvrez Clés API dans le tableau de bord et copiez votre clé de test sk_test_…. Avec elle, rien ne part et rien n’est débité (voir Sandbox).

2. Ajoutez le serveur à votre client. Il faut Node.js 18 ou plus récent.

   Claude Code

   claude mcp add getsms --env GETSMS_API_KEY=sk_test_VOTRE_CLE -- npx -y @getsms/mcp

   Ajoutez --scope user pour l’avoir dans tous vos projets.

   Claude Desktop

   Réglages → Développeur → Modifier la configuration, puis dans claude_desktop_config.json :

   {
     "mcpServers": {
       "getsms": {
         "command": "npx",
         "args": ["-y", "@getsms/mcp"],
         "env": { "GETSMS_API_KEY": "sk_test_VOTRE_CLE" }
       }
     }
   }

   Redémarrez Claude Desktop.

   Cursor

   Dans ~/.cursor/mcp.json (tous les projets) ou .cursor/mcp.json (un projet) :

   {
     "mcpServers": {
       "getsms": {
         "command": "npx",
         "args": ["-y", "@getsms/mcp"],
         "env": { "GETSMS_API_KEY": "sk_test_VOTRE_CLE" }
       }
     }
   }

   VS Code

   Dans .vscode/mcp.json. VS Code demande la clé une fois et la garde en lieu sûr :

   {
     "inputs": [
       { "type": "promptString", "id": "getsms-key", "description": "Clé API GetSMS", "password": true }
     ],
     "servers": {
       "getsms": {
         "type": "stdio",
         "command": "npx",
         "args": ["-y", "@getsms/mcp"],
         "env": { "GETSMS_API_KEY": "${input:getsms-key}" }
       }
     }
   }

3. Demandez à l’assistant d’envoyer un SMS de test au +212600000002 : il est livré, puis le destinataire simulé répond « OUI » au bout de 9 secondes.

4. Quand tout vous convient, remplacez la clé de test par votre clé de production uk_….

Outils

Outil	Rôle	Coût
send_sms	Envoie un SMS à un mobile marocain (+2126…, +2127… ; 06… et 07… sont convertis). from, request_id et send_at sont facultatifs.	Débite vos crédits
send_bulk_sms	Le même texte à 1 000 destinataires au plus, doublons retirés, tout ou rien. from est obligatoire avec une clé de production.	Débite vos crédits
get_message	Un message et son statut à jour.	Gratuit
list_messages	Une conversation entre votre numéro et un contact, réponses comprises.	Gratuit
get_balance	Votre solde en dirhams HT, votre prix par SMS et le nombre de SMS qu’il couvre.	Gratuit
estimate_cost	Le nombre de segments d’un texte et son coût pour N destinataires, calculé sur place comme GetSMS le facture.	Gratuit, sans appel à l’API
list_phone_numbers	Vos numéros d’envoi, utilisables comme from.	Gratuit

Les réponses indiquent toujours si l’envoi a eu lieu dans le sandbox (sandbox: true). La ressource getsms://docs/quickstart résume les tarifs, les statuts et les numéros de test.

Crédits et sécurité

Avec une clé de production, l'assistant dépense vos crédits

Chaque segment est débité à votre prix unitaire (voir Crédits et facturation). Gardez la confirmation des outils activée dans votre client pour send_sms et send_bulk_sms, et demandez une estimation avant un gros envoi.

• Pas de double envoi sur une nouvelle tentative. Si l’assistant fournit un request_id, une nouvelle tentative avec le même identifiant renvoie le premier résultat au lieu de renvoyer le SMS : l’API le garantit pendant 24 h, et le serveur MCP répond sans même la rappeler dans le même processus.
• Des erreurs exploitables. Crédit insuffisant (402), clé refusée (401), paramètre invalide (422) : l’assistant reçoit un message clair, avec le coût et le solde en dirhams, et peut vous expliquer quoi faire.
• Votre clé reste chez vous. Elle ne part que vers api.getsms.tech, dans l’en-tête x-api-key. Elle n’apparaît ni dans les journaux ni dans les réponses données au modèle.
• La clé de test est limitée. Elle envoie et lit les messages du sandbox, sans accès au solde ni aux numéros.

Serveur HTTP

Pour un agent hébergé ou une équipe, lancez le serveur en HTTP (transport Streamable HTTP). Il ne garde ni session ni clé : chaque requête porte la clé de son appelant.

npx -y @getsms/mcp --http --port 3333

Le point d’accès est http://127.0.0.1:3333/mcp. Les clients envoient Authorization: Bearer <votre clé GetSMS> :

claude mcp add --transport http getsms http://127.0.0.1:3333/mcp \
  --header "Authorization: Bearer sk_test_VOTRE_CLE"

Par défaut, le serveur n’écoute que sur la machine locale. Pour l’exposer (--host 0.0.0.0), placez-le derrière un proxy HTTPS et indiquez son nom public : le serveur refuse alors toute requête adressée à un autre nom (protection contre le DNS rebinding).

npx -y @getsms/mcp --http --host 0.0.0.0 --allowed-host mcp.votre-domaine.ma

Variables d’environnement

Variable	Défaut	Rôle
GETSMS_API_KEY	—	Votre clé, en mode stdio.
GETSMS_API_URL	https://api.getsms.tech	URL de l’API.
GETSMS_TIMEOUT_MS	30000	Délai maximal de chaque appel, en millisecondes.