CLI e ferramentas de IA

O servidor MCP (Claude, Cursor, Cline)

Aplica-se a
  • macOS
  • Windows
  • Linux
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

  1. 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.
  2. Reinicie o anfitrião. As ferramentas aparecem no servidor freeyourmusic.
  3. 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.
  4. 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.
  5. 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?

FerramentasO que fazem
ContaIniciar sessão, mostrar o estado do seu Pro, conectar e listar serviços de música
Biblioteca e pesquisaLer playlists, músicas curtidas, álbuns e artistas; pesquisar num serviço
TransferênciasIniciar, acompanhar, pausar, retomar e eliminar transferências; Manter sincronizado
Ferramentas de playlistsCriar uma playlist; editar músicas, ordenar, baralhar, remover duplicados, dividir, juntar, copiar, restaurar uma versão
CorrespondênciasRevisar músicas sem correspondência e escolher uma substituta
Análises, estatísticas e exportaçõesAná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.

Ver a página do MCP

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.

Artigos relacionados

Contacto

Ainda com dúvidas?

Escreva à nossa equipa de suporte para support@freeyourmusic.com. Indique a sua plataforma e o que já experimentou.

O mais rápido: a partir da app

  1. Conta
  2. Ajuda e suporte
  3. Escrever para o suporte

Assim o email inclui a sua plataforma, a versão da app e o ID da sua conta, e podemos ajudar mais depressa.

Pessoas reais leem cada email. Os planos pagos têm suporte prioritário.