Auf dieser Seite5 Abschnitte ▾
Mit dem MCP-Server von Free Your Music kann ein KI-Assistent dein Free-Your-Music-Konto nutzen. Du fragst im Chat, zum Beispiel "Übertrag meine Roadtrip-Playlist zu Apple Music und halte sie synchron", und der Assistent ruft die Tools von Free Your Music auf, um das zu erledigen. Er kann alles, was die Web-App von Free Your Music kann. Der MCP-Server gehört zu Pro.
Was du brauchst
- Einen MCP-Host: Claude Desktop, Claude Code, Cursor oder Cline.
- Node.js 20 oder neuer, damit der Host den Server mit npx starten kann.
- Ein Free-Your-Music-Konto mit Pro: dasselbe Konto, das du unter freeyourmusic.com/app nutzt.
Installieren
Den MCP-Server von Free Your Music installieren
- Führe in einem Terminal den Befehl für deinen Host aus. Claude Desktop: npx -y @freeyourmusic/mcp install --host=claude-desktop. Claude Code: --host=claude-code. Cursor: --host=cursor. Cline: --host=cline.
- Starte den Host neu. Die Tools erscheinen unter dem Server freeyourmusic.
- Bitte den Assistenten: "Melde mich bei Free Your Music an." Er gibt dir einen Link zu freeyourmusic.com/app/cli und einen kurzen Code.
- Öffne den Link, melde dich per E-Mail, Apple oder Google an, prüfe, ob der Code übereinstimmt, und tippe auf Erlauben. Ohne Pro bietet dir die Seite zuerst Pro an.
- Bitte ihn, einen Musikdienst zu verbinden, zum Beispiel "Verbinde mein Spotify-Konto", und melde dich im Browser bei diesem Dienst an.
Jeder Host hat eine eigene Installationsseite mit der genauen Konfigurationsdatei und dem Neustart-Schritt: Claude Desktop, Claude Code, Cursor, Cline. Für einen anderen Host führst du npx -y @freeyourmusic/mcp install --host=print aus und fügst das ausgegebene JSON in die Konfiguration des Hosts ein.
Was kann der Assistent tun?
| Tools | Was sie tun |
|---|---|
| Konto | Anmelden, deinen Pro-Status zeigen, Musikdienste verbinden und auflisten |
| Bibliothek und Suche | Playlists, Lieblingssongs, Alben und Künstler lesen; einen Dienst durchsuchen |
| Übertragungen | Übertragungen starten, verfolgen, pausieren, fortsetzen und löschen; Synchron halten |
| Playlist-Tools | Eine Playlist erstellen; Songs bearbeiten, sortieren, mischen, Duplikate entfernen, aufteilen, zusammenführen, kopieren, eine Version wiederherstellen |
| Treffer | Songs ohne Treffer prüfen und einen Ersatz wählen |
| Einblicke, Stats und Exporte | Playlist-Einblicke, Hörstatistiken, Exporte |
Tools, die Daten löschen oder ersetzen, etwa das Löschen einer Playlist, tragen eine Warnmarkierung, damit dein Host dich fragen kann, bevor er sie ausführt. Das Löschen deines Free-Your-Music-Kontos ist kein Tool: Das kann nur die CLI.
Datenschutz
- Der MCP-Server läuft auf deinem Computer und ruft die API von Free Your Music über HTTPS auf, wie die Web-App.
- Deine Sitzung liegt in ~/.fym/credentials.json, einer Datei, die nur dein Benutzerkonto lesen kann. Die CLI auf demselben Computer teilt sie.
- Die Anmeldungen bei deinen Musikdiensten bleiben auf den Servern von Free Your Music. Der Assistent sieht deine Passwörter nie.
- Der MCP-Server fügt kein Tracking hinzu. Veröffentlichte Versionen melden unerwartete Fehler an unser Absturzberichts-Tool, ohne deine Tool-Argumente oder Zugangsdaten. Setze FYM_DISABLE_TELEMETRY=1, um das auszuschalten.
- Die Ergebnisse der Tools gehen an deine KI-App. Wie diese App sie verarbeitet, hängt von ihren Einstellungen und ihrem Modellanbieter ab.
Häufige Fragen
Die Tools erscheinen nicht in meinem Host. Was tue ich?
Starte den Host nach der Installation komplett neu. Erscheinen die Tools dann immer noch nicht, führe den Installationsbefehl erneut aus oder nutze --host=print und füge das JSON von Hand in die Konfiguration des Hosts ein.
Funktioniert der MCP-Server auf meinem Handy?
Nein. Er läuft auf einem Computer mit Node.js, neben einem MCP-Host wie Claude Desktop oder Cursor. Auf dem Handy nutzt du die App von Free Your Music.
Sieht mein KI-Assistent die Passwörter meiner Musikdienste?
Nein. Die Anmeldungen bei deinen Musikdiensten bleiben auf den Servern von Free Your Music. Der Assistent bekommt nur die Ergebnisse der Tools, die er aufruft.
Mehr über Free Your Music und KI-Tools. Kommst du nicht weiter? Kontaktiere den Support und sag uns, welchen Host du nutzt.