SonaPrompt

Pesquise um catálogo musical real pelo seu assistente, obtenha prévias de 30 segundos que você pode tocar e adicione músicas diretamente às suas playlists do Apple Music.

Documentação

Servidor MCP de Música

Deixe o ChatGPT ou o Claude pesquisar em um catálogo de música real e enviar faixas que você pode realmente tocar. Eles já conhecem música. Isso dá a eles as partes que não conseguem fazer sozinhos: confirmar que uma música existe e colocá-la em algum lugar onde você possa ouvi-la.

URL do servidor — cole isso nas configurações de conector do seu assistente.

https://sonaprompt.com/mcp

Servidor remoto via HTTP transmissível. Autorizado com OAuth, então não há chave de API para colar nem token para guardar em lugar nenhum. Gratuito. Você fará login em uma conta SonaPrompt ao conectar, o que leva um clique com Google ou Apple.

Dois níveis, e você escolhe na hora de conectar.

Qualquer conta recebe:

  • Pesquisar em um catálogo de música real
  • Pré-visualizações de 30 segundos que você pode tocar
  • Abrir qualquer faixa no Spotify ou no YouTube Music

Com uma assinatura do Apple Music, você também recebe:

  • Ler suas playlists, para que nunca sugira o que você já tem
  • Adicionar músicas às suas playlists

Sem assinatura, você ainda recebe tudo da primeira lista, e a página de pré-visualização funciona em qualquer serviço de streaming. Você pode conectar o Apple Music mais tarde reconectando.

O que você pode pedir

Depois de conectado, a conversa fica assim:

  • "Encontre post-rock instrumental que cresce lentamente, nada depois de 2010."
  • "O que tem na minha playlist Morning Run?"
  • "Adicione três músicas que combinem, mas nada que já esteja lá."
  • "Faça uma playlist para um domingo chuvoso e coloque oito faixas nela."

O assistente lê a playlist primeiro, então não vai sugerir músicas que você já tem. Cada música que ele menciona é verificada no catálogo real do Apple Music, então uma faixa inventada falha na verificação em vez de chegar até você. E ele devolve uma página onde você pode ouvir pré-visualizações de 30 segundos de tudo antes de se comprometer a adicionar.

Como conectar

Claude

  1. Configurações, depois Conectores, depois Adicionar conector personalizado.
  2. Cole https://sonaprompt.com/mcp como a URL do servidor MCP remoto.
  3. Clique em Conectar. Uma janela do navegador abre pedindo para você entrar com o Apple Music.
  4. Aprove, e as ferramentas aparecem na sua próxima conversa.

ChatGPT

  1. Configurações, depois Conectores, depois adicione um conector por URL.
  2. Cole https://sonaprompt.com/mcp, depois autorize com o Apple Music quando solicitado.

Conectores personalizados não estão disponíveis em todos os planos do ChatGPT. Se você não vê a opção, é por isso.

Claude Code

claude mcp add --transport http sonaprompt https://sonaprompt.com/mcp

Depois execute /mcp dentro do Claude Code e autentique.

Qualquer outra coisa

Qualquer cliente que fale MCP via HTTP transmissível com OAuth funcionará. A descoberta é padrão:

GET https://sonaprompt.com/.well-known/oauth-protected-resource/mcp

{
  "resource": "https://sonaprompt.com/mcp",
  "authorization_servers": ["https://sonaprompt.com/"],
  "scopes_supported": ["playlists:read", "playlists:write"],
  "resource_name": "Apple Music"
}

O registro dinâmico de clientes é suportado, então não há nada para registrar manualmente.

As ferramentas

Em qualquer conta

  • search_catalog — pesquisa o catálogo. Confirma que uma música é real e retorna o id dela.
  • preview_links — transforma uma lista de músicas em uma página de pré-visualizações de 30 segundos que você pode tocar.

Com o Apple Music conectado

  • list_playlists — suas playlists do Apple Music.
  • get_playlist_tracks — todas as músicas que já estão em uma delas. É isso que impede sugestões duplicadas.
  • add_tracks — adiciona músicas a uma playlist, ou cria uma nova. Músicas que já estão lá são puladas.

Quatro das cinco são somente leitura. add_tracks é a única que escreve, e seu assistente pedirá confirmação antes de executar. Se você conectar sem o Apple Music, as três últimas não são registradas, então seu assistente não pode oferecer algo que não pode fazer.

O que ele pode e não pode acessar

A conexão é limitada a playlists:read e playlists:write. Na prática:

  • Ele pode listar suas playlists, ler o que está nelas, criar uma playlist e adicionar músicas.
  • Ele não pode excluir uma playlist, remover uma música, renomear nada ou tocar música.
  • Ele nunca vê seu Apple ID ou sua senha. O login da Apple acontece na página da Apple.

Seu token de usuário do Apple Music é criptografado em repouso e usado apenas para atender suas próprias solicitações. Revogue-o quando quiser pela página de conexão ou removendo o conector no seu assistente. Veja Privacidade para detalhes.

Requisitos

  • Uma conta SonaPrompt, criada em um clique com Google ou Apple quando você conectar.
  • Um cliente que suporte servidores MCP remotos com OAuth.
  • Uma assinatura do Apple Music apenas se você quiser as ferramentas de playlist.

Quando não funciona

  • "A conexão com o Apple Music não é mais válida" — o token expirou ou foi revogado. Reconecte pela página de conexão.
  • O assistente menciona músicas, mas não dá link — peça para ele chamar preview_links. Essa é a página onde você pode realmente ouvi-las.
  • Ele sugere músicas que já estão na playlist — peça para ele ler a playlist primeiro. get_playlist_tracks é o que impede isso.
  • Nada aparece após autorizar — comece uma nova conversa. A maioria dos clientes só carrega ferramentas no início de uma.
  • Você assinou o Apple Music depois de conectar — reconecte e escolha Conectar Apple Music. A lista de ferramentas é definida quando a conexão é feita.

Também há uma API REST

Se preferir chamá-la do seu próprio código em vez de um assistente, a API recebe uma descrição em linguagem simples e retorna faixas reais. Um endpoint, uma chave.