Guia de configuração MCP do Words into Music

Este guia reúne os ajustes exatos para um cliente MCP compatível. Se você usa ChatGPT ou Claude, os guias específicos mostram primeiro os menus de cada aplicativo.

Ajustes da conexão

Use a URL inteira, incluindo o /mcp final. A página inicial, um link de música e localhost não são endereços do conector. Nós hospedamos o servidor, então você não precisa instalar um servidor musical no computador.

Conecte e confira antes de gerar

1. Adicione um servidor HTTP remoto no cliente e informe a URL.
2. Escolha OAuth. Use a identidade publicada do cliente ou o registro automático, quando disponível.
3. Entre no Words into Music, verifique seu e-mail se necessário e revise as permissões.
4. Volte ao assistente e ative o conector para a conversa.
5. Peça para consultar seus créditos sem iniciar uma música.

A resposta deve separar créditos disponíveis e reservados. Zero créditos reservados significa que não há saldo retido para uma tarefa em andamento, não que todas as músicas anteriores tenham sido gratuitas.

Opção pelo terminal com Claude Code

Se você já usa Claude Code, o comando HTTP documentado é:

claude mcp add --transport http words-into-music https://mcp.wordsintomusic.com/mcp

Depois abra /mcp no Claude Code e autentique a conexão. Acrescente --scope user ao registrar se quiser usá-la em todos os projetos. Essa é uma configuração documentada, não um teste completo nosso no Claude Code. Consulte a documentação MCP atual se os comandos mudarem.

Crie uma única gravação

Prepare o tema ou a letra, o som, o idioma, a duração e a escolha entre voz e instrumental. A preparação não desconta saldo. Revise a proposta e aprove uma música antes da chamada a start_song.

Prepare uma faixa instrumental de 60 segundos com piano suave e bateria com vassourinhas para uma tarde chuvosa. Consulte meu saldo, mostre a proposta e o custo de um crédito e espere minha aprovação. Se uma chamada expirar, não crie outra música.

Um cliente desenvolvido por você deve manter um requestId estável, o preparedRequestId e o jobId retornado. Repita um início que expirou com o mesmo identificador preparado. Uma nova preparação pode gerar outra música cobrada depois.

Consulte get_song_job no máximo a cada 15 segundos. A resposta final inclui o link privado. O guia de letra para música ajuda a preparar o texto e conferir o canto.

Problemas comuns

O assistente não encontra as ferramentas

Uma conexão salva pode estar desativada no chat. No Claude, abra o menu de mais, escolha Connectors e ative Words into Music. No ChatGPT, selecione o plugin com @ quando uma mensagem precisar de uma nova chamada. Atualize as ferramentas ou abra outra conversa se necessário.

O login se repete ou o acesso é negado

Conclua OAuth no mesmo fluxo do navegador. Não copie URLs de retorno para outro navegador nem códigos para o chat. Reconecte pelas configurações do cliente se a sessão expirou. Após desconectar no Words into Music, os tokens antigos devem falhar.

Não há créditos ou outra música está em andamento

Confira o saldo compartilhado em Cobrança. MCP não compra planos. Espere a tarefa atual terminar em vez de criar solicitações para contornar o limite.

O link diz que a gravação é privada

Entre na mesma conta que aprovou a conexão. O link não concede acesso público nem permite ler músicas de outra conta.

Remova o acesso

Em Configurações, abra Aplicativos conectados e desconecte o cliente. As novas chamadas são bloqueadas imediatamente. Desconecte também no assistente. Nos testes reais, ChatGPT e Claude retornaram MCP_ACCESS na chamada seguinte à revogação.

A visão geral do MCP detalha ferramentas e custos. O guia do Grok separa o conector web da API. A especificação de autorização MCP explica o protocolo.