Configurazione

Collegare un assistente a Soundbox.

Collega un assistente IA compatibile per cercare, controllare e gestire la tua libreria Soundbox, senza dargli accesso a quella di nessun altro.

Collegare con il tuo account Soundbox

Nelle impostazioni MCP o Connettori del tuo assistente, aggiungi un server Streamable HTTP con questo indirizzo:

https://soundboxradio.com/mcp

Il tuo assistente aprirà poi un browser così puoi accedere a Soundbox e autorizzare il collegamento. È la via consigliata: non c'è nessuna chiave da copiare, e più avanti puoi togliere quell'assistente dalle Impostazioni di Soundbox senza toccare gli altri collegamenti.

Cosa può fare un assistente collegato

Un assistente collegato può cercare stazioni, controllare i flussi, leggere le informazioni sul programma in onda e gestire le stazioni e i brani della libreria che gli hai aperto. Questo comprende il nome della stazione, gli altri nomi, la descrizione, le categorie, lo stato su Alexa e la frase Tu dici di una scorciatoia di routine. Può anche segnare una routine come creata.

Le scorciatoie di routine restano separate dai dati della stazione. Un assistente può cambiare la frase salvata in Soundbox, ma le routine di Alexa si gestiscono nell'app Alexa.

Per i client senza accesso dal browser

Alcuni client e script automatici non riescono a completare l'accesso dal browser. Nelle Impostazioni di Soundbox apri Lascia che un assistente aggiunga stazioni e scegli Copia la configurazione sotto Con una chiave. Aggiungi la voce fornita accanto ai server MCP già presenti nella configurazione di quel client.

Una chiave dà accesso alla tua libreria, quindi trattala come una password. Tienila in un file di configurazione o in una variabile d'ambiente, mai in una chat. Sostituisci la chiave nelle Impostazioni di Soundbox quando vuoi scollegare tutti i client che la usano.

Una configurazione tipica è questa. Usa il formato esatto indicato dal tuo client dove è diverso.

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

Se il collegamento non compare

Riavvia l'assistente dopo aver modificato un file di configurazione. Se ancora non vede Soundbox, controlla l'indirizzo del server, il formato di configurazione richiesto da quel client e la sua documentazione MCP.