Nesta página5 secções ▾
O servidor MCP do Free Your Music permite que um assistente de IA use a sua conta Free Your Music. Peça numa conversa, por exemplo "transfere a minha playlist da viagem para o Apple Music e mantém-na sincronizada", e o assistente chama as ferramentas do Free Your Music para o fazer. Pode fazer tudo o que o app web do Free Your Music faz. O servidor MCP faz parte do Pro.
O que precisa
- Um anfitrião MCP: Claude Desktop, Claude Code, Cursor ou Cline.
- Node.js 20 ou mais recente, para que o anfitrião possa executar o servidor com npx.
- Uma conta Free Your Music com Pro: a mesma conta que usa em freeyourmusic.com/app.
Instalar
Instalar o servidor MCP do Free Your Music
- Num terminal, execute o comando para o seu anfitrião. Claude Desktop: npx -y @freeyourmusic/mcp install --host=claude-desktop. Claude Code: --host=claude-code. Cursor: --host=cursor. Cline: --host=cline.
- Reinicie o anfitrião. As ferramentas aparecem no servidor freeyourmusic.
- Peça ao assistente: "Inicia sessão no Free Your Music." Ele dá-lhe um link para freeyourmusic.com/app/cli e um código curto.
- Abra o link, inicie sessão com email, Apple ou Google, confirme que o código corresponde e toque em Permitir. Sem Pro, a página oferece primeiro o Pro.
- Peça-lhe para conectar um serviço de música, por exemplo "Conecta a minha conta Spotify", e inicie sessão nesse serviço no navegador.
Cada anfitrião tem a sua própria página de instalação com o ficheiro de configuração exato e o passo de reinício: Claude Desktop, Claude Code, Cursor, Cline. Para outro anfitrião, execute npx -y @freeyourmusic/mcp install --host=print e cole o JSON que ele mostra na configuração do anfitrião.
O que o assistente pode fazer?
| Ferramentas | O que fazem |
|---|---|
| Conta | Iniciar sessão, mostrar o estado do seu Pro, conectar e listar serviços de música |
| Biblioteca e pesquisa | Ler playlists, músicas curtidas, álbuns e artistas; pesquisar num serviço |
| Transferências | Iniciar, acompanhar, pausar, retomar e eliminar transferências; Manter sincronizado |
| Ferramentas de playlists | Criar uma playlist; editar músicas, ordenar, baralhar, remover duplicados, dividir, juntar, copiar, restaurar uma versão |
| Correspondências | Revisar músicas sem correspondência e escolher uma substituta |
| Análises, estatísticas e exportações | Análises de playlists, estatísticas de audição, exportações |
As ferramentas que eliminam ou substituem dados, como eliminar uma playlist, levam um aviso, para que o seu anfitrião lhe possa perguntar antes de as executar. Eliminar a sua conta Free Your Music não é uma ferramenta: só a CLI o pode fazer.
Privacidade
- O servidor MCP corre no seu computador e chama a API do Free Your Music por HTTPS, como faz o app web.
- A sua sessão fica em ~/.fym/credentials.json, um ficheiro que só a sua conta de utilizador do computador pode ler. A CLI no mesmo computador partilha-o.
- Os inícios de sessão dos seus serviços de música ficam nos servidores do Free Your Music. O assistente nunca vê as suas palavras-passe.
- O servidor MCP não acrescenta rastreamento. As versões publicadas comunicam erros inesperados à nossa ferramenta de relatórios de falhas, sem os argumentos das ferramentas nem credenciais. Defina FYM_DISABLE_TELEMETRY=1 para desativar isso.
- Os resultados das ferramentas vão para o seu app de IA. A forma como esse app os trata depende das definições dele e do fornecedor do modelo.
Perguntas frequentes
As ferramentas não aparecem no meu anfitrião. O que faço?
Reinicie completamente o anfitrião depois da instalação. Se as ferramentas continuarem a não aparecer, execute de novo o comando de instalação, ou use --host=print e acrescente o JSON à configuração do anfitrião manualmente.
O servidor MCP funciona no smartphone?
Não. Corre num computador com Node.js, ao lado de um anfitrião MCP como o Claude Desktop ou o Cursor. No smartphone, use o app Free Your Music.
O meu assistente de IA vê as palavras-passe dos meus serviços de música?
Não. Os inícios de sessão dos seus serviços de música ficam nos servidores do Free Your Music. O assistente só recebe os resultados das ferramentas que chama.
Saiba mais sobre o Free Your Music e as ferramentas de IA. Ainda com dificuldades? Contacte o suporte e diga-nos que anfitrião usa.