Einrichtung

Einen Assistenten mit Soundbox verbinden.

Verbinde einen kompatiblen KI-Assistenten, der deine eigene Soundbox-Sammlung durchsuchen, prüfen und verwalten kann — ohne Zugriff auf die von irgendjemand anderem.

Mit deinem Soundbox-Konto verbinden

Füg in den MCP- oder Connector-Einstellungen deines Assistenten einen Streamable-HTTP-Server mit dieser Adresse hinzu:

https://soundboxradio.com/mcp

Dein Assistent öffnet dann einen Browser, damit du dich bei Soundbox anmelden und die Verbindung bestätigen kannst. Das ist der empfohlene Weg: Es gibt keinen Schlüssel zu kopieren, und du kannst diesen Assistenten später in den Soundbox-Einstellungen entfernen, ohne dass andere Verbindungen betroffen sind.

Was ein verbundener Assistent kann

Ein verbundener Assistent kann Sender suchen, Streams prüfen, aktuelle Programminformationen lesen und die Sender und Songs in der Sammlung verwalten, für die du ihn freigegeben hast. Dazu gehören Sendername, weitere Namen, Beschreibung, Kategorien, der Alexa-Status und der Satz unter Du sagst für eine Routine. Er kann eine Routine auch als angelegt markieren.

Routine-Kürzel bleiben von den Senderangaben getrennt. Ein Assistent kann den in Soundbox gespeicherten Satz ändern, die Alexa-Routinen selbst werden aber in der Alexa-App verwaltet.

Für Clients ohne Anmeldung im Browser

Manche Clients und unbeaufsichtigte Skripte können die Anmeldung im Browser nicht durchlaufen. Öffne in den Soundbox-Einstellungen Einen Assistenten Sender hinzufügen lassen und wähl Konfiguration kopieren unter Mit einem Schlüssel. Trag den ausgegebenen Eintrag neben den bestehenden MCP-Servern in der Konfiguration dieses Clients ein.

Ein Schlüssel gibt Zugriff auf deine Sammlung, behandle ihn also wie ein Passwort. Bewahr ihn in einer Konfigurationsdatei oder einer Umgebungsvariable auf, nie in einem Chat. Ersetz den Schlüssel in den Soundbox-Einstellungen, wenn du alle Clients trennen willst, die ihn benutzen.

Eine typische Konfiguration sieht so aus. Nimm das genaue Format, das dein Client vorgibt, wenn es abweicht.

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

Wenn die Verbindung nicht auftaucht

Starte den Assistenten neu, nachdem du eine Konfigurationsdatei geändert hast. Sieht er Soundbox dann immer noch nicht, prüf die Serveradresse, das vom Client verlangte Konfigurationsformat und dessen MCP-Dokumentation.