CLI und KI-Tools

Der MCP-Server (Claude, Cursor, Cline)

Gilt für
  • macOS
  • Windows
  • Linux
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

  1. 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.
  2. Starte den Host neu. Die Tools erscheinen unter dem Server freeyourmusic.
  3. Bitte den Assistenten: "Melde mich bei Free Your Music an." Er gibt dir einen Link zu freeyourmusic.com/app/cli und einen kurzen Code.
  4. Ö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.
  5. 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?

ToolsWas sie tun
KontoAnmelden, deinen Pro-Status zeigen, Musikdienste verbinden und auflisten
Bibliothek und SuchePlaylists, Lieblingssongs, Alben und Künstler lesen; einen Dienst durchsuchen
ÜbertragungenÜbertragungen starten, verfolgen, pausieren, fortsetzen und löschen; Synchron halten
Playlist-ToolsEine Playlist erstellen; Songs bearbeiten, sortieren, mischen, Duplikate entfernen, aufteilen, zusammenführen, kopieren, eine Version wiederherstellen
TrefferSongs ohne Treffer prüfen und einen Ersatz wählen
Einblicke, Stats und ExportePlaylist-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.

Zur MCP-Seite

Mehr über Free Your Music und KI-Tools. Kommst du nicht weiter? Kontaktiere den Support und sag uns, welchen Host du nutzt.

Ähnliche Artikel

Kontakt

Kommst du nicht weiter?

Schreib unserem Support-Team an support@freeyourmusic.com. Nenne deine Plattform und was du schon versucht hast.

Am schnellsten: aus der App

  1. Konto
  2. Hilfe und Support
  3. An den Support schreiben

Die E-Mail enthält dann deine Plattform, die App-Version und deine Konto-ID, damit wir schneller helfen können.

Echte Menschen lesen jede E-Mail. Bezahlte Pläne erhalten bevorzugten Support.