Piloter Spox depuis un assistant IA (MCP)

Spox expose un serveur MCP (Model Context Protocol) accessible à l'adresse https://mcp.spox.fr. Tout assistant compatible MCP (Claude, Cursor, etc.) peut ainsi créer votre compte, configurer votre agent vocal, lire vos transcriptions et piloter vos campagnes SMS directement en conversation.

Configuration client

Ajoutez le bloc suivant dans la configuration de votre assistant IA :

{
  "mcpServers": {
    "spox": {
      "type": "http",
      "url": "https://mcp.spox.fr",
      "headers": { "Authorization": "Bearer spx_live_..." }
    }
  }
}

Remplacez spx_live_... par votre clé API. Sans clé, votre assistant accède uniquement aux outils publics : informations produit, tarifs et création de compte.

Créer une clé API

Connectez-vous à app.spox.fr, ouvrez Réglages → API keys et cliquez sur Nouvelle clé. Copiez la clé immédiatement : elle ne sera plus affichée après fermeture de la fenêtre. Vous pouvez créer plusieurs clés et les révoquer individuellement depuis la même interface.

Outils disponibles

Publics (sans authentification)

• get_product_info : retourne la description du produit, verticaux supportés et features clés
• get_pricing : retourne les tarifs actuels, minutes/SMS incluses et tarifs de dépassement
• create_account : crée un compte Spox et retourne un lien d'abonnement

Authentifiés

• list_agents : liste les agents vocaux configurés avec leurs réglages actuels (prompt, voix, langue, numéro)
• update_agent : modifie le prompt, la voix et la langue de l'agent vocal
• list_calls : liste les appels reçus avec date, durée et statut
• get_call_transcript : retourne la transcription complète d'un appel
• get_usage : retourne la consommation du mois en cours (minutes, SMS)
• get_forwarding_instructions : retourne les codes USSD pré-remplis avec votre numéro Spox
• send_sms_batch : envoie un SMS à une liste de numéros (dry_run par défaut)
• start_call_campaign : crée et lance une campagne d'appels (dry_run par défaut)

Simulation par défaut (dry_run)

Les outils d'envoi (send_sms_batch, start_call_campaign) utilisent dry_run=true par défaut. En mode simulation, aucun SMS n'est réellement envoyé et aucune facturation n'est déclenchée : votre assistant peut composer et valider un message sans risque. Pour envoyer réellement, passez explicitement dry_run: false dans votre requête.

Activation des clés créées via create_account

Lorsque votre assistant crée un compte via create_account, Spox envoie un e-mail au nouvel utilisateur avec un lien de définition de mot de passe. La clé API associée à ce compte n'est active qu'après que l'utilisateur ait cliqué sur ce lien et défini son mot de passe. Tant que l'étape de définition du mot de passe n'est pas complétée, les appels authentifiés avec cette clé retourneront une erreur 401.

Exemples de demandes

Une fois le serveur configuré, vous pouvez parler à votre assistant en langage naturel. Quelques exemples de ce qu'il peut faire avec les outils ci-dessus :

• « Liste mes appels de la semaine et résume ceux où un propriétaire a demandé un rappel. » (list_calls, get_call_transcript)
• « Combien de minutes me reste-t-il ce mois-ci ? » (get_usage)
• « Change le message d'accueil de Léa pour mentionner le nom de mon agence. » (update_agent)
• « Donne-moi le code de renvoi d'appel pour ma ligne Orange. » (get_forwarding_instructions)
• « Prépare un SMS de rappel de check-out pour ces trois numéros, sans l'envoyer. » (send_sms_batch en dry_run)

Sécurité des clés

Avec une clé API, votre assistant lit vos appels et transcriptions et peut déclencher des SMS facturés. Ne la partagez pas dans un dépôt de code ou un document partagé. Si une clé fuite, révoquez-la immédiatement depuis Réglages → API keys et créez-en une nouvelle. Pour aller plus loin sur le produit, voir la page Serveur MCP et le guide Démarrer avec Spox.

Questions fréquentes

Mon assistant peut-il créer un compte Spox sans mon intervention ? Il peut appeler create_account avec votre e-mail et le nom de votre structure, mais le compte et sa clé API ne deviennent actifs qu'après que vous avez cliqué le lien reçu par e-mail et défini un mot de passe, dans les 72 heures. Rien ne se passe sans cette confirmation.

Que se passe-t-il si j'oublie dry_run: false ? Rien n'est envoyé : send_sms_batch et start_call_campaign restent en simulation. C'est le comportement voulu, il faut demander explicitement l'envoi réel pour qu'un SMS parte et soit décompté de votre forfait.

Puis-je donner une clé à un prestataire ou à un collaborateur ? Créez une clé dédiée par usage depuis Réglages puis API keys, et révoquez-la quand la collaboration se termine. Une clé donne accès aux appels, transcriptions et à l'envoi de SMS facturés de tout le compte, il n'y a pas de clé à droits restreints aujourd'hui.