CLI et outils IA

Le serveur MCP (Claude, Cursor, Cline)

S'applique à
  • macOS
  • Windows
  • Linux
Sur cette page5 parties ▾

Le serveur MCP Free Your Music permet à un assistant IA d'utiliser votre compte Free Your Music. Vous demandez dans une conversation, par exemple « transfère ma playlist road trip vers Apple Music et garde-la synchronisée », et l'assistant appelle les outils Free Your Music pour le faire. Il peut faire tout ce que fait l'application web Free Your Music. Le serveur MCP fait partie de Pro.

Ce dont vous avez besoin

  • Un hôte MCP : Claude Desktop, Claude Code, Cursor ou Cline.
  • Node.js 20 ou plus récent, pour que l'hôte puisse lancer le serveur avec npx.
  • Un compte Free Your Music avec Pro : le même compte que sur freeyourmusic.com/app.

L'installer

Installer le serveur MCP Free Your Music

  1. Dans un terminal, lancez la commande de votre hôte. Claude Desktop : npx -y @freeyourmusic/mcp install --host=claude-desktop. Claude Code : --host=claude-code. Cursor : --host=cursor. Cline : --host=cline.
  2. Redémarrez l'hôte. Les outils apparaissent sous le serveur freeyourmusic.
  3. Demandez à l'assistant : « Connecte-moi à Free Your Music. » Il vous donne un lien vers freeyourmusic.com/app/cli et un code court.
  4. Ouvrez le lien, connectez-vous par e-mail, Apple ou Google, vérifiez que le code correspond et touchez Autoriser. Sans Pro, la page propose d'abord Pro.
  5. Demandez-lui de connecter un service de musique, par exemple « Connecte mon compte Spotify », et connectez-vous à ce service dans le navigateur.

Chaque hôte a sa propre page d'installation avec le fichier de configuration exact et l'étape de redémarrage : Claude Desktop, Claude Code, Cursor, Cline. Pour un autre hôte, lancez npx -y @freeyourmusic/mcp install --host=print et collez le JSON affiché dans la configuration de l'hôte.

Que peut faire l'assistant ?

OutilsCe qu'ils font
CompteSe connecter, afficher l'état de Pro, connecter et lister les services de musique
Bibliothèque et rechercheLire les playlists, titres aimés, albums et artistes ; chercher sur un service
TransfertsLancer, suivre, mettre en pause, reprendre et supprimer des transferts ; Garder synchronisé
Outils de playlistCréer une playlist ; modifier les titres, trier, mélanger, supprimer les doublons, diviser, fusionner, copier, restaurer une version
CorrespondancesVérifier les titres non associés et choisir un remplacement
Statistiques et exportsStatistiques de playlist, statistiques d'écoute, exports

Les outils qui suppriment ou remplacent des données, comme la suppression d'une playlist, portent un avertissement, pour que votre hôte puisse vous demander confirmation avant de les lancer. La suppression de votre compte Free Your Music n'est pas un outil : seule la CLI peut le faire.

Confidentialité

  • Le serveur MCP fonctionne sur votre ordinateur et appelle l'API Free Your Music en HTTPS, comme l'application web.
  • Votre session est dans ~/.fym/credentials.json, un fichier que seul votre compte utilisateur peut lire. La CLI du même ordinateur la partage.
  • Vos connexions aux services de musique restent sur les serveurs de Free Your Music. L'assistant ne voit jamais vos mots de passe.
  • Le serveur MCP n'ajoute aucun pistage. Les versions publiées signalent les erreurs inattendues à notre outil de rapport de plantage, sans les arguments de vos outils ni vos identifiants. Définissez FYM_DISABLE_TELEMETRY=1 pour le désactiver.
  • Les résultats des outils vont à votre application IA. La façon dont elle les traite dépend de ses réglages et de son fournisseur de modèle.

Questions fréquentes

Les outils n'apparaissent pas dans mon hôte. Que faire ?

Redémarrez complètement l'hôte après l'installation. Si les outils n'apparaissent toujours pas, relancez la commande d'installation, ou utilisez --host=print et ajoutez vous-même le JSON à la configuration de l'hôte.

Le serveur MCP fonctionne-t-il sur mon téléphone ?

Non. Il fonctionne sur un ordinateur avec Node.js, à côté d'un hôte MCP comme Claude Desktop ou Cursor. Sur votre téléphone, utilisez l'application Free Your Music.

Mon assistant IA voit-il les mots de passe de mes services de musique ?

Non. Vos connexions aux services de musique restent sur les serveurs de Free Your Music. L'assistant reçoit seulement les résultats des outils qu'il appelle.

Voir la page MCP

En savoir plus sur Free Your Music et les outils IA. Toujours bloqué ? Contactez le support en indiquant l'hôte que vous utilisez.

Articles liés

Contact

Toujours bloqué ?

Écrivez à notre équipe support à support@freeyourmusic.com. Indiquez votre plateforme et ce que vous avez essayé.

Le plus rapide : depuis l'app

  1. Compte
  2. Aide et assistance
  3. Écrire à l'assistance

L'e-mail contient alors votre plateforme, la version de l'app et l'identifiant de votre compte, pour que nous puissions vous aider plus vite.

De vraies personnes lisent chaque e-mail. Les forfaits payants bénéficient d'un support prioritaire.