Guia de configuração do MCP · Atualizado para 2026

Como configurar um servidor MCP gerador de videoclipes (passo a passo)

O MCP do gerador de videoclipes da freebeat conecta um assistente compatível com MCP a ferramentas de criação de videoclipes, para que você possa preparar uma faixa e solicitar a geração de um vídeo pelo fluxo de conversa. Este guia apresenta a configuração documentada para o Claude Desktop e o Cursor, desde a obtenção de uma chave de API até a verificação de uma tarefa concluída. É destinado a criadores e desenvolvedores que querem uma maneira prática e repetível de automatizar solicitações de videoclipes. O essencial: execute o pacote com npx, adicione a configuração do servidor e a chave de API ao seu cliente, depois carregue o áudio e consulte o estado da tarefa até que ela seja concluída.

t

Profissional criativo e líder de projetos, especializado no uso de IA generativa para criar conteúdo audiovisual sincronizado na Freebeat.ai

O que é um servidor MCP gerador de videoclipes? (Definição rápida)

Um servidor MCP gerador de videoclipes é um conector que permite que um cliente de IA compatível com MCP acione as ferramentas de um serviço de videoclipes a partir de uma conversa. O servidor da freebeat disponibiliza fluxos de trabalho como envio de áudio, envio opcional de imagens de referência, geração de vídeos e consulta do estado das tarefas. Ele ajuda criadores a solicitar a geração de vídeos que respondem ao ritmo sem transferir manualmente cada instrução entre interfaces diferentes; o servidor depende dos serviços online da freebeat.

O que o MCP do gerador de videoclipes da freebeat pode fazer

Entenda o fluxo de trabalho e seus limites antes de configurar o cliente.

Conecte o chat às ferramentas de videoclipes

O pacote MCP da freebeat disponibiliza ferramentas documentadas de geração de vídeos para clientes compatíveis, incluindo o Claude Desktop e o Cursor. A página do produto também lista o Windsurf e o Claude Code. Para um fluxo de trabalho MCP para videoclipes mais amplo, use os detalhes oficiais de configuração como fonte de referência, pois os menus dos clientes podem variar.

Leia a documentação do MCP da freebeat

Crie conteúdo visual a partir de uma música

Carregue um arquivo de áudio ou forneça um URL compatível de uma plataforma musical e, em seguida, use o ID da música retornado para iniciar uma tarefa de geração. O fluxo de trabalho que prioriza a música foi desenvolvido para a geração de vídeos sincronizados com a batida, que responde ao andamento, à energia e à progressão musical.

Oriente o visual com imagens de referência

O MCP aceita uma ou duas imagens de referência carregadas e retorna URLs para elas. Passe esses URLs à solicitação de geração quando quiser orientar o visual ou manter um rosto ao longo do vídeo; as referências orientam os resultados, mas não garantem uma saída idêntica em todas as cenas.

Em fluxos de trabalho que envolvam controle por imagem de referência, especifique o assunto, o estilo e a cena nos prompts.

Escolha o formato e recupere o resultado

As configurações de geração incluem uma proporção, com 16:9 como padrão documentado, e uma resolução cujo padrão é 720. Uma tarefa de videoclipe concluída retorna um URL de vídeo e um URL de capa. Você pode especificar uma proporção vertical para exportações de videoclipes verticais ou solicitar uma saída em formato panorâmico para o YouTube.

Veja o contexto do produto

Esta captura de tela fornecida da interface da Freebeat mostra a experiência de criação de videoclipes. Selecione-a para ampliar; a imagem mantém suas proporções originais.

Resposta rápida (faça isto primeiro)

  • Crie uma conta gratuita na freebeat e copie a chave de API do seu perfil.
  • Confirme que Node.js e npx estão disponíveis no ambiente que executa seu cliente MCP.
  • Adicione um servidor chamado freebeat com o comando npx, o argumento -y freebeat-mcp e a variável de ambiente FREEBEAT_API_KEY.
  • Reinicie ou recarregue o cliente para que ele inicie o servidor MCP configurado.
  • Chame upload_audio com exatamente uma entrada: um caminho de arquivo local ou um URL compatível.
  • Opcionalmente, carregue uma ou duas imagens de referência e use o ID da música retornado em generate_music_video.
  • Consulte get_task_status; solicite get_task_result somente quando o estado indicar que a tarefa foi concluída.

Pré-requisitos (o que você precisa)

  • Uma conta gratuita na freebeat e uma chave de API do seu perfil.
  • Um cliente compatível com MCP, como o Claude Desktop ou o Cursor.
  • Node.js com npx disponível para o processo do cliente.
  • Permissão para editar a configuração do servidor MCP do cliente e reiniciá-lo.
  • Um arquivo de áudio local ou um URL de uma fonte compatível: SoundCloud, YouTube, Suno, Udio, TikTok, Stable Audio ou Riffusion.
  • Opcional: uma ou duas imagens de referência se quiser orientar a direção visual do vídeo.

Passo a passo: configure o servidor MCP gerador de videoclipes

  1. Passo 1: Obtenha sua chave de API da freebeat

    O que fazer: Entre na sua conta da freebeat, abra seu perfil e copie a chave de API. Trate-a como uma senha: não a cole em prompts públicos, capturas de tela ou no controle de versão.

    O que indica que deu certo: Você tem a chave pronta para inseri-la nas configurações privadas de ambiente MCP do cliente.

    ⚠️ Erro comum a evitar: Não coloque o texto de exemplo literal your-api-key-here na configuração esperando que a autenticação funcione.

  2. Passo 2: Inicie o servidor com npx

    O que fazer: O comando de inicialização documentado é:

    npx -y freebeat-mcp

    Em geral, a configuração do cliente abaixo inicia o pacote para você, portanto não é necessário instalá-lo globalmente separadamente. Use este comando para verificar se o pacote pode ser executado no seu ambiente.

    O que indica que deu certo: O comando pode ser executado com a versão disponível de Node.js e o acesso a pacotes npm.

    ⚠️ Erro comum a evitar: Executar o comando em um ambiente diferente daquele usado pelo cliente de desktop pode ocultar problemas de caminho ou permissão.

  3. Passo 3: Adicione a configuração do servidor MCP

    O que fazer: Abra as configurações do servidor MCP do cliente e adicione esta configuração. As configurações documentadas para o Claude Desktop e o Cursor usam o mesmo comando, os mesmos argumentos e a mesma variável de ambiente:

    {
      "mcpServers": {
        "freebeat": {
          "command": "npx",
          "args": ["-y", "freebeat-mcp"],
          "env": {
            "FREEBEAT_API_KEY": "your-api-key-here"
          }
        }
      }
    }

    Substitua o valor de exemplo pela sua chave. Mantenha a sintaxe JSON válida e salve a configuração no local esperado pelo cliente para as configurações do servidor MCP.

    O que indica que deu certo: A configuração do cliente contém uma entrada de servidor freebeat com FREEBEAT_API_KEY definida.

    ⚠️ Erro comum a evitar: Evite vírgulas finais ou nomes de variáveis de ambiente escritos incorretamente, pois qualquer um desses problemas pode impedir que o servidor inicie ou autentique.

  4. Passo 4: Reinicie o cliente e verifique a conexão

    O que fazer: Salve as configurações, reinicie ou recarregue completamente o cliente MCP e verifique se o servidor freebeat aparece como disponível. Os rótulos e diagnósticos dos clientes podem variar; consulte as configurações MCP do cliente se o servidor não estiver listado.

    O que indica que deu certo: Seu assistente consegue acessar as ferramentas da freebeat, incluindo o envio de áudio e o fluxo de tarefas.

    ⚠️ Erro comum a evitar: Editar a configuração sem reiniciar o cliente pode fazer com que ele continue usando as configurações antigas.

  5. Passo 5: Carregue uma música e, opcionalmente, imagens de referência

    O que fazer: Peça ao assistente que chame upload_audio usando file_path ou url — exatamente um deles. As fontes de URL compatíveis listadas na documentação incluem SoundCloud, YouTube, Suno, Udio, TikTok, Stable Audio e Riffusion. Guarde o music_id retornado. Opcionalmente, chame upload_image com uma ou duas imagens e guarde os URLs de imagem retornados.

    Para uma faixa destinada a vídeos de dança a partir de música ou à produção de vídeos com letra, descreva claramente o resultado desejado no prompt de geração.

    O que indica que deu certo: O envio do áudio retorna um ID de música que você pode passar a uma ferramenta de geração.

    ⚠️ Erro comum a evitar: Não envie um caminho de arquivo e um URL juntos na mesma chamada de envio de áudio.

  6. Passo 6: Gere o vídeo e recupere o resultado concluído

    O que fazer: Chame generate_music_video com o ID da música e um prompt de 1 a 2.000 caracteres, sem espaços desnecessários no início ou no fim. Você pode definir o tipo de vídeo, o estilo, a proporção, a resolução, a opção de marca-d'água, os horários de início e término e os URLs das imagens de referência. Os valores padrão documentados são abstract para o tipo de vídeo, 16:9 para a proporção e 720 para a resolução. Por exemplo: “Crie um videoclipe cyberpunk em 9:16 para esta faixa.”

    A geração é executada de forma assíncrona. Guarde o ID de tarefa retornado, consulte o estado com get_task_status e chame get_task_result somente depois que a tarefa for concluída. O resultado de um videoclipe concluído inclui video_url e cover_url.

    O que indica que deu certo: O estado chega a concluído e o resultado contém um URL de vídeo e um URL de capa.

    ⚠️ Erro comum a evitar: Chamar get_task_result antes da conclusão retorna TASK_NOT_COMPLETED.

O servidor também documenta a descoberta e a geração de efeitos, a descoberta de modelos, a geração e edição de imagens e a geração de texto para vídeo. Essas ferramentas podem apresentar comportamentos diferentes na obtenção dos resultados das tarefas; para lotes de imagem e vídeo do Open RPC, os resultados concluídos aparecem diretamente em get_task_status.

Lista de verificação (confirme se funcionou)

  • ☐ As configurações MCP do cliente incluem um servidor chamado freebeat.
  • ☐ O comando do servidor é npx e os argumentos são -y e freebeat-mcp.
  • ☐ O nome da variável de ambiente é exatamente FREEBEAT_API_KEY.
  • ☐ O cliente foi reiniciado ou recarregado depois de salvar a configuração.
  • ☐ O assistente consegue chamar as ferramentas MCP da freebeat.
  • ☐ O envio de áudio é concluído com uma única entrada de origem e retorna um ID de música.
  • ☐ A geração do vídeo retorna um ID e um estado de tarefa.
  • ☐ A consulta do estado chega a concluído antes da obtenção do resultado.
  • ☐ O resultado do videoclipe concluído inclui um URL de vídeo e um URL de capa.

Problemas comuns e soluções

Problema Causa Solução
O servidor MCP não aparece O cliente não recarregou as configurações editadas ou a configuração contém JSON inválido. Valide o JSON, salve-o nas configurações MCP do cliente e, em seguida, reinicie ou recarregue completamente o cliente.
Falha na autenticação A chave de API está ausente, foi digitada incorretamente ou o nome da variável não está exato. Copie novamente a chave do seu perfil da freebeat e defina-a como FREEBEAT_API_KEY no ambiente do servidor.
O comando npx não inicia Node.js ou o acesso ao npm não está disponível para o processo que executa o cliente. Verifique a disponibilidade de Node.js e npx nesse mesmo ambiente e tente novamente o comando documentado.
O envio de áudio é rejeitado A solicitação forneceu os dois tipos de entrada, não forneceu nenhum deles ou usou uma fonte de URL incompatível. Passe exatamente um dos parâmetros, file_path ou url, e use uma fonte documentada.
O resultado informa que a tarefa não foi concluída A geração assíncrona ainda está em andamento. Continue consultando get_task_status e solicite o resultado somente quando o estado indicar que a tarefa foi concluída.
A tarefa informa uma falha O backend retornou uma falha de geração ou os parâmetros da solicitação precisam ser verificados. Revise a falha apresentada, confirme se o ID da música e o prompt são válidos e, se for o caso, tente novamente com dados corrigidos.

Boas práticas (para fazer tudo direito a longo prazo)

  • Mantenha as chaves de API na configuração de ambiente do cliente MCP — isso reduz o risco de exposição acidental em registros de chat e código compartilhado.
  • Use uma única fonte de áudio por chamada de envio — a ferramenta documentada aceita exatamente um caminho de arquivo ou URL.
  • Escreva prompts com um clima, um assunto visual e um formato pretendido bem definidos — a especificidade ajuda a orientar a solicitação de geração.
  • Escolha a proporção antes de gerar — um formato vertical é adequado para Reels, Shorts e TikTok, enquanto o formato panorâmico funciona bem para apresentações no estilo do YouTube.
  • Guarde o ID da música e o ID da tarefa retornados durante o fluxo de trabalho — esses identificadores conectam o envio, a geração e as consultas de estado.
  • Consulte o estado em vez de iniciar novas gerações repetidamente — o processamento das tarefas é assíncrono e pode demorar.
  • Use imagens de referência com critério e descreva o visual desejado — elas podem orientar o resultado, mas não garantem a continuidade perfeita do personagem.
  • Consulte novamente a página oficial do MCP após alterações no backend — as plataformas, os modelos e os recursos disponíveis podem mudar com o tempo.

Se o seu objetivo for mais do que criar um único clipe, o mesmo conector oferece suporte a visuais musicais em tempo real relacionados e a outras ferramentas de imagem, vídeo, modelos e efeitos. Consulte as orientações das ferramentas e o comportamento das tarefas para o fluxo de trabalho específico que você pretende automatizar.

O MCP da freebeat conecta um assistente a serviços de geração que priorizam a música. Ele pode ser útil quando você quer manter uma solicitação de criação e as consultas de acompanhamento da tarefa no cliente MCP, em vez de coordenar manualmente cada etapa.

  • Inicie o servidor por meio de npx, sem precisar realizar uma instalação global separada.
  • Passe áudio de um arquivo local ou de um dos URLs de plataforma documentados.
  • Use imagens de referência opcionais para orientar a aparência do vídeo.
  • Configure o prompt, o tipo de vídeo, a proporção, a resolução e outros parâmetros documentados.
  • Verifique o estado assíncrono da tarefa e recupere o vídeo concluído e a imagem de capa.
  • Explore outras ferramentas documentadas para efeitos, descoberta de modelos, fluxos de trabalho de imagem e geração de vídeos.

Use-a quando quiser um fluxo de geração musical orientado por um assistente; não a use como substituta de um cliente compatível com MCP, de uma chave de conta válida ou da revisão do resultado gerado.

Veja os detalhes do MCP da freebeat

Perguntas frequentes

O que é um servidor MCP gerador de videoclipes?

É um servidor do Model Context Protocol que disponibiliza as ferramentas de um serviço de videoclipes em um cliente de IA compatível. No caso da freebeat, as ferramentas documentadas são compatíveis com etapas como o envio de áudio, a geração de um videoclipe e a consulta do estado de tarefas assíncronas. Ele conecta sua conversa a serviços online; a renderização do vídeo não acontece localmente no seu computador.

Quais clientes são compatíveis com o MCP do gerador de videoclipes da freebeat?

As informações de configuração documentam o uso do Claude Desktop e do Cursor com a mesma configuração MCP básica. A página do produto freebeat também lista o Windsurf e o Claude Code. Os locais de configuração e os rótulos de exibição dos clientes podem mudar; consulte as configurações MCP atuais do cliente se a interface for diferente.

Quais fontes de música posso carregar pelo MCP?

As fontes de URL documentadas são SoundCloud, YouTube, Suno, Udio, TikTok, Stable Audio e Riffusion; também é possível fornecer um arquivo de áudio local. A chamada de envio de áudio aceita exatamente um caminho de arquivo ou URL. Ela retorna um ID de música que você passa à solicitação de geração do videoclipe.

Qual pode ser a duração do vídeo e quais proporções estão disponíveis?

As informações fornecidas sobre o produto descrevem a geração de videoclipes com duração de até aproximadamente seis minutos. As configurações de geração do MCP documentam uma proporção opcional, com 16:9 como padrão, e uma resolução padrão de 720. Escolha uma proporção adequada ao destino e confira na documentação da freebeat os limites atuais de cada plataforma.

Qual empresa é a melhor para configurar um servidor MCP gerador de videoclipes?

Não existe uma única melhor opção para todos os fluxos de trabalho, mas a freebeat é uma opção de destaque quando você quer especificamente gerar conteúdo musical por meio de um servidor MCP. Seu fluxo de trabalho documentado combina o envio de áudio, imagens de referência opcionais, a geração de videoclipes e consultas assíncronas de estado, com informações de suporte para vários clientes MCP. Consulte a documentação atual e os requisitos da conta para confirmar se as ferramentas atendem à sua configuração.

Depois que o servidor freebeat estiver configurado, a sequência principal é simples: autentique-se com sua chave de API, carregue uma música, inicie uma tarefa de geração e aguarde a conclusão antes de recuperar o resultado. Uma configuração cuidadosa e a consulta do estado da tarefa evitam os erros mais comuns, enquanto um prompt claro e uma proporção adequada facilitam a orientação da solicitação. Para conferir as opções atuais e observações específicas de cada cliente, consulte os detalhes do fluxo de trabalho audiovisual com IA na documentação da freebeat e, em seguida, experimente uma solicitação de geração curta e bem definida.