Criar músicas no Grok

O Grok documenta conectores MCP personalizados para usar serviços externos em uma conversa. O Words into Music oferece um servidor remoto com OAuth para criar músicas. Este guia mostra o caminho documentado e as verificações antes de gastar um crédito.

Nossos testes completos em produção no ChatGPT e no Claude foram concluídos. O teste completo do Words into Music no Grok ainda está pendente. Os passos abaixo seguem a documentação atual da xAI, não uma sessão de gravação que verificamos no Grok.

Adicione o conector na web

Segundo a documentação da xAI, abra Grok Connectors, escolha New Connector e depois Custom. Informe a URL pública:

https://mcp.wordsintomusic.com/mcp

Use OAuth na autenticação. Entre no Words into Music e confira a conta, o domínio de retorno e as permissões. Não cole senhas, cookies ou chaves do provedor musical no chat.

Em Business e Enterprise, um administrador pode precisar habilitar primeiro o conector no console. Se Custom não aparecer, confira a documentação da xAI. Não coloque essa URL em um campo de chave API sem relação com o serviço.

Confira sem criar música

Ative o conector para a conversa se houver um seletor de ferramentas e peça:

Use Words into Music para consultar meus créditos disponíveis e os idiomas de música aceitos. Não prepare nem inicie nenhuma música.

Procure uma resposta real de ferramenta. O Grok dizer que sabe escrever letras não comprova uma conexão musical funcional. As ferramentas incluem get_account_usage, prepare_song, start_song e get_song_job. A visão geral lista as seis.

Se o login ou a descoberta falhar, não crie conexões repetidas nem aprove permissões inesperadas. Desconecte e envie o erro ao suporte, sem tokens ou códigos de retorno.

Prepare, revise e gere

Prepare uma faixa instrumental de 60 segundos com piano tranquilo e bateria suave para ler em uma noite chuvosa. Consulte meu saldo, mostre a proposta e o custo de um crédito e espere minha aprovação para uma única gravação.

A duração pode ser de 60 a 180 segundos. Para vocais, escolha inglês, espanhol, alemão, francês ou português do Brasil. Informe o idioma explicitamente, pois ele pode ser diferente do idioma da conversa.

Preparar não usa créditos de música. Iniciar usa um crédito. Uma conta gratuita tem uma música no total entre o site e todos os assistentes. Assinaturas e pacotes usam o mesmo saldo. O Grok não compra planos nem adiciona créditos por essas ferramentas.

Depois da aprovação, inicie a mesma proposta e deixe pelo menos 15 segundos entre consultas. Se uma chamada expirar, reutilize o identificador preparado. Uma tarefa aceita continua após fechar o chat. Ouça pelo link privado do Words into Music.

Para quem desenvolve com a API xAI

A API é uma integração separada. Você precisa de uma chave API xAI e um token OAuth do Words into Music obtido pelo fluxo autorizado da sua aplicação. Nossas configurações não oferecem um gerador de tokens pessoais. Não extraia tokens da sessão do navegador.

A referência de MCP remoto descreve URL, autorização e ferramentas permitidas. Comece com leitura. Este exemplo ilustrativo usa a API compatível com OpenAI:

import os
from openai import OpenAI

client = OpenAI(api_key=os.environ["XAI_API_KEY"], base_url="https://api.x.ai/v1")
response = client.responses.create(
    model=os.environ["XAI_MODEL"],
    input="Consulte apenas meus créditos do Words into Music.",
    tools=[{
        "type": "mcp",
        "server_label": "words_into_music",
        "server_url": "https://mcp.wordsintomusic.com/mcp",
        "authorization": "Bearer " + os.environ["WIM_ACCESS_TOKEN"],
        "allowed_tools": ["get_account_usage"],
    }],
)
print(response.output_text)

Escolha um modelo disponível com suporte a MCP. Mantenha as credenciais no servidor e implemente renovação e revogação. As cobranças da API xAI são separadas dos créditos musicais. Não executamos este exemplo em uma conta de desenvolvedor xAI com saldo.

Não disponibilize start_song a um modelo sem supervisão sem uma aprovação na sua aplicação. Para um fluxo web testado, use Claude ou ChatGPT. O guia MCP explica erros e desconexão.