Configuração

Conectar um assistente ao Soundbox.

Conecte um assistente de IA compatível para buscar, verificar e gerenciar a sua própria biblioteca do Soundbox, sem dar acesso à de mais ninguém.

Conectar com a sua conta Soundbox

Nas configurações de MCP ou Conectores do seu assistente, adicione um servidor Streamable HTTP com este endereço:

https://soundboxradio.com/mcp

O seu assistente vai então abrir um navegador para você entrar no Soundbox e autorizar a conexão. É o caminho recomendado: não há chave nenhuma para copiar, e depois você pode remover esse assistente nas Configurações do Soundbox sem mexer nas outras conexões.

O que um assistente conectado pode fazer

Um assistente conectado pode buscar estações, verificar transmissões, ler as informações do programa no ar e gerenciar as estações e músicas da biblioteca que você liberou. Isso inclui o nome da estação, os outros nomes, a descrição, as categorias, o estado na Alexa e a frase de Você diz de um atalho de rotina. Ele também pode marcar uma rotina como criada.

Os atalhos de rotina continuam separados dos dados da estação. Um assistente pode mudar a frase guardada no Soundbox, mas as rotinas da Alexa são gerenciadas no app da Alexa.

Para clientes sem entrada pelo navegador

Alguns clientes e scripts automáticos não conseguem concluir a entrada pelo navegador. Nas Configurações do Soundbox, abra Deixar um assistente adicionar estações e escolha Copiar a configuração em Com uma chave. Adicione a entrada fornecida junto dos servidores MCP que já existirem na configuração desse cliente.

Uma chave dá acesso à sua biblioteca, então trate como uma senha. Guarde em um arquivo de configuração ou variável de ambiente, nunca em um chat. Troque a chave nas Configurações do Soundbox sempre que precisar desconectar todos os clientes que a usam.

Uma configuração típica é assim. Use o formato exato indicado pelo seu cliente quando for diferente.

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

Se a conexão não aparecer

Reinicie o assistente depois de mudar um arquivo de configuração. Se ele ainda não enxergar o Soundbox, confira o endereço do servidor, o formato de configuração que aquele cliente exige e a documentação de MCP dele.