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.