Installation

Connecter un assistant à Soundbox.

Connecte un assistant IA compatible pour chercher, vérifier et gérer ta propre bibliothèque Soundbox, sans lui donner accès à celle de quelqu'un d'autre.

Se connecter avec ton compte Soundbox

Dans les réglages MCP ou Connecteurs de ton assistant, ajoute un serveur Streamable HTTP avec cette adresse :

https://soundboxradio.com/mcp

Ton assistant ouvrira alors un navigateur pour que tu te connectes à Soundbox et autorises la connexion. C'est la voie recommandée : il n'y a aucune clé à copier, et tu peux retirer cet assistant plus tard depuis les Réglages de Soundbox sans toucher aux autres connexions.

Ce qu'un assistant connecté peut faire

Un assistant connecté peut chercher des stations, vérifier des flux, lire les informations de programme en cours, et gérer les stations et les morceaux de la bibliothèque que tu lui as ouverte. Cela comprend le nom de la station, les autres noms, la description, les catégories, l'état sur Alexa et la phrase Tu dis d'un raccourci de routine. Il peut aussi marquer une routine comme créée.

Les raccourcis de routine restent séparés des détails de la station. Un assistant peut changer la phrase enregistrée dans Soundbox, mais les routines Alexa elles-mêmes se gèrent dans l'application Alexa.

Pour les clients sans connexion par navigateur

Certains clients et scripts automatiques ne peuvent pas passer par la connexion dans le navigateur. Dans les Réglages de Soundbox, ouvre Laisser un assistant ajouter des stations et choisis Copier la configuration sous Avec une clé. Ajoute l'entrée fournie à côté des serveurs MCP déjà présents dans la configuration de ce client.

Une clé donne accès à ta bibliothèque : traite-la comme un mot de passe. Garde-la dans un fichier de configuration ou une variable d'environnement, jamais dans une conversation. Remplace la clé dans les Réglages de Soundbox dès que tu veux déconnecter tous les clients qui l'utilisent.

Une configuration typique ressemble à ceci. Utilise le format exact fourni par ton client s'il diffère.

{
  "mcpServers": {
    "soundbox": {
      "type": "http",
      "url": "https://soundboxradio.com/mcp",
      "headers": { "Authorization": "Bearer YOUR-KEY" }
    }
  }
}

Si la connexion n'apparaît pas

Redémarre l'assistant après avoir modifié un fichier de configuration. S'il ne voit toujours pas Soundbox, vérifie l'adresse du serveur, le format de configuration exigé par ce client et sa documentation MCP.