Claude · Codex · Gemini CLI

Servidor MCP para a sua biblioteca musical

Ligue o Claude ou o Codex ao MyMusik. Gira etiquetas, pastas e listas de reprodução, controle a reprodução, corte faixas e importe ou exporte música com IA.

Ligar um dispositivo
Escolha as permissões com o escudo e selecione «Copiar instruções para o agente».

Ligue o Claude ou o Codex a partir de Insights

Para testar a ligação, peça ao agente que indique três álbuns da sua biblioteca e confirme o resultado na vista de álbuns do MyMusik.

  1. Abra o MyMusik e aceda a Insights (/insights). Procure «Ligar um dispositivo».
  2. Selecione o ícone do escudo, escolha as permissões e a duração do acesso e depois «Aplicar». «Só de leitura» é um bom ponto de partida para explorar a biblioteca.
  3. Selecione «Copiar instruções para o agente» («Agente de IA» em ecrãs pequenos). Cada cópia cria um novo convite de utilização única.
  4. Execute mymusik-mcp pair e cole apenas o URL do convite que contém #grant=.
  5. Peça três álbuns da sua biblioteca MyMusik.

Mantenha o MyMusik aberto. O agente precisa de ferramentas MCP ou HTTP e de acesso à aplicação através da rede.

Insights no computador
Insights no computadorAbra o MyMusik e aceda a Insights (/insights). Procure «Ligar um dispositivo».
Conexão MCP no Codex
Conexão MCP no CodexO Codex confirma o acesso de somente leitura ao MyMusik e mostra quando a sessão expira.

Controle a sua aplicação musical com IA

Gira a biblioteca musical com IA em todo o processo: encontrar faixas, organizar a coleção, editar áudio e ouvir música. O servidor MCP musical do MyMusik dá ao agente acesso às operações da aplicação de acordo com as permissões escolhidas. Descreva o resultado pretendido e o agente pode combinar várias ações por si.

Estes são exemplos de pedidos, não ações automáticas nem seleções garantidas. Peça para rever uma alteração proposta quando quiser um ponto de verificação; as permissões determinam o que a ligação pode realmente fazer.

  • Encontre música sem percorrer todas as páginas

    «Encontra álbuns de [artist] na minha biblioteca e mostra-me as faixas.» Deixe o agente pesquisar músicas, álbuns, artistas, listas de reprodução e pastas geridas pela aplicação e ajudá-lo a escolher.

  • Continue a ouvir enquanto trabalha

    «Reproduz [playlist] e faz pausa quando eu pedir.» Com acesso à reprodução, um agente pode controlar o leitor e a fila enquanto continua a conversa.

  • Crie uma lista de reprodução a partir de uma conversa

    «Sugere 12 faixas destes artistas. Mostra-me a seleção e guarda-a como Dia de trabalho quando eu aprovar.» Utilize o agente para reunir faixas e criar uma lista com acesso de edição à biblioteca.

  • Gira etiquetas em toda a biblioteca

    «Adiciona a etiqueta Viagem a estas músicas e álbuns. Mantém as etiquetas existentes.» Crie, mude o nome, atribua e remova etiquetas de biblioteca nos elementos musicais suportados. Organize a coleção de acordo com as suas próprias categorias.

  • Crie e organize pastas aninhadas

    «Cria uma pasta Viagens com uma subpasta Verão e adiciona estes álbuns.» Crie, mude o nome e mova pastas da aplicação e as respetivas entradas. Estas pastas organizam referências da biblioteca; os ficheiros originais permanecem no mesmo local.

  • Atualize os detalhes de faixas e álbuns

    «Mostra-me as faixas com um nome de álbum incorreto e aplica depois as correções que eu aprovar.» Edite os metadados de biblioteca suportados e mantenha os nomes consistentes em toda a coleção.

Importe, corte e exporte música com IA

Atribua ao agente uma tarefa musical completa e deixe-o utilizar as ferramentas de importação, edição de áudio e exportação da aplicação. Pode verificar o progresso dos trabalhos e comunicar o resultado na conversa.

Escolha «Acesso personalizado» com os grupos de recursos necessários à tarefa completa. Por exemplo, editar áudio e criar uma música pode exigir permissões tanto de «Importações e ficheiros» como de «Biblioteca musical». A aplicação e o agente têm também de suportar guardar ou descarregar os ficheiros resultantes.

  • Importe música e acompanhe o progresso

    «Importa o áudio desta pasta, verifica os resultados e diz-me que faixas precisam de atenção.» Utilize ficheiros e pastas legíveis ou URL de áudio suportados. As origens têm de estar acessíveis ao dispositivo que executa o MyMusik; as definições de importação determinam se as faixas são aceites automaticamente ou precisam de revisão.

  • Corte, apare ou extraia uma faixa

    «Extrai de 00:30 a 01:00 desta faixa como uma música separada e mantém o original.» Utilize intervalos de tempo precisos para remover uma secção ou criar uma nova faixa a partir dela. A edição de áudio exige intervalos válidos e áudio local editável.

  • Exporte listas de reprodução e coleções de áudio

    «Exporta esta lista como M3U8 e prepara um ZIP com as suas faixas.» Exporte referências de listas ou reúna músicas de álbuns, listas e pastas da biblioteca como áudio MP3 com etiquetas. As exportações ZIP suportam até 1.000 faixas e exigem áudio exportável. Os ficheiros M3U8 referenciam localizações de conteúdos multimédia; a utilização noutro local exige acesso a esses ficheiros ou URL.

Escolha quanto acesso conceder

Utilize o escudo no cartão de ligação para ajustar o acesso à tarefa. A aplicação verifica as permissões da sessão ao executar uma operação.

Alterar a seleção não modifica uma sessão existente. Copie um novo prompt de IA e volte a ligar-se com o novo convite. Trate o prompt como um acesso privado à aplicação e partilhe-o apenas com um agente em quem confie.

  • Só de leitura

    Explore e resuma informações acessíveis da biblioteca sem permitir alterações. Comece aqui para verificar a ligação e discutir um plano.

  • Reprodução remota

    Permita os controlos do leitor e da fila necessários para gerir a audição. Esta predefinição também concede acesso de leitura a toda a API pública.

  • Edição da biblioteca

    Permita alterações suportadas a faixas, álbuns, artistas, listas, etiquetas e pastas da aplicação. Utilize este acesso para organizar a coleção e atualizar informações da biblioteca.

  • Gestão de importações

    Permita operações sobre importações, edição de áudio, arquivos e ficheiros. Um processo que também altere elementos da biblioteca pode precisar de permissões adicionais de «Biblioteca musical».

  • Acesso personalizado

    Combine os grupos de recursos «Reprodução», «Biblioteca musical» e «Importações e ficheiros» com o nível de acesso necessário à tarefa. Isto permite a um agente executar um processo em várias áreas da aplicação.

Acesso por código QR
Acesso por código QRCombine os grupos de recursos «Reprodução», «Biblioteca musical» e «Importações e ficheiros» com o nível de acesso necessário à tarefa. Isto permite a um agente executar um processo em várias áreas da aplicação.

Gestão da biblioteca musical com IA e MCP

MCP significa Model Context Protocol. O MyMusik disponibiliza as operações documentadas da aplicação como ferramentas que um agente pode descobrir e utilizar. O agente pode consultar os controlos relevantes para o pedido e receber resultados da aplicação.

O controlo da aplicação abrange operações de API disponibilizadas dentro dos limites do seu acesso. Não oferece controlo geral do rato e do teclado do computador.

  • Menos configuração manual

    O prompt copiado inclui o convite, as instruções de ligação, as permissões e os passos de recuperação. Não precisa de escrever uma integração para cada tarefa musical.

  • Mais espaço para a tarefa

    O agente pode obter apenas os detalhes das operações e os campos de resultado necessários e percorrer resultados maiores por páginas. Pode evitar carregar todo o catálogo da API para a conversa.

  • Verifique um pedido antes de o aplicar

    O servidor MCP pode validar um pedido de API proposto sem o executar. Verifica os argumentos e as regras de acesso aplicáveis; a operação real continua a realizar as suas próprias verificações quando é executada.

Mantenha a ligação acessível

A configuração mais simples é executar o agente no mesmo computador que o MyMusik. Um agente remoto também precisa de um caminho de rede até à aplicação em execução.

  1. Para outro dispositivo na rede local, verifique «Definições → Servidor Web → Permitir acesso remoto». Copie um prompt novo depois de alterar a configuração da ligação.
  2. Um agente executado num ambiente isolado na nuvem não consegue alcançar automaticamente o localhost do computador. Execute o agente localmente ou prepare uma ligação acessível; o prompt copiado inclui orientações de rede.
  3. Se um convite tiver expirado ou já tiver sido utilizado, copie um novo prompt de IA. Se o MyMusik tiver sido fechado ou suspenso, volte a abri-lo antes de tentar novamente.

Alguns detalhes úteis

O agente de IA pode controlar toda a aplicação?

Pode utilizar as funcionalidades disponibilizadas pelo MyMusik, incluindo organização da biblioteca, etiquetas, pastas, listas, reprodução, importações, edição de áudio e exportações. As operações disponíveis dependem da versão instalada, da plataforma e das permissões de ligação. O agente utiliza a API da aplicação para executar tarefas; não precisa de clicar em cada ecrã.

Funciona com qualquer configuração do Codex ou Claude?

O agente precisa de ferramentas MCP ou HTTP utilizáveis, autorização para estabelecer a ligação e acesso de rede à aplicação. Colar o prompt numa conversa apenas de texto não estabelece uma ligação. Peça ao agente para verificar o acesso antes de lhe atribuir uma tarefa musical.

Posso utilizar um cliente MCP padrão?

Sim. Após o emparelhamento, configure o cliente para executar mymusik-mcp stdio.

É o mesmo que a função de voz com IA integrada no MyMusik?

Esta ligação permite que um agente externo à sua escolha trabalhe com o MyMusik. A função de voz com IA da aplicação tem uma configuração própria. Continuam a aplicar-se os requisitos de conta, modelo e faturação do agente externo; as operações da aplicação baseadas em IA também podem exigir acesso ao serviço.

A aplicação musical ou o agente precisam de ficar abertos?

O servidor nativo do MyMusik tem de permanecer em execução e acessível. Fechar ou suspender a aplicação interrompe o acesso. A sessão tem um prazo de validade e pode ser necessário um novo convite para voltar a ligar. Terminar uma ligação não cancela necessariamente um trabalho já iniciado na aplicação.

Que informações pode o agente ver?

Pode pedir os dados da aplicação permitidos pela sessão. Esses dados são tratados pelo agente e pelo fornecedor do modelo que utiliza. «Só de leitura» impede escritas, mas continua a permitir a leitura de dados. Escolha um âmbito personalizado mais restrito quando adequado e mantenha os convites e as credenciais da sessão privados.