Crie vídeos com um agente de inteligência artificial: Higgsfield MCP no Claude Code

O Higgsfield liga-se ao Claude Code com um único comando claude mcp add e o endereço https://mcp.higgsfield.ai/mcp. Depois, dá-lhe uma tarefa em linguagem corrente e o agente acede ao Higgsfield por iniciativa própria, gera uma imagem ou um vídeo e devolve-o diretamente na janela. Paga duas vezes por isto: com créditos do Higgsfield para as gerações e com os limites do Claude Code por ter o servidor no contexto. Por isso, a minha regra é simples: se não estiver a usar o MCP, desligue-o.

O processo antigo era demorado: aceder ao site do Higgsfield, tentar perceber a interface, escrever um prompt, gerar, descarregar e carregar o resultado para o projeto. Agora, o Higgsfield lançou o seu próprio MCP, por isso já não precisa de aceder ao Higgsfield nem de tentar perceber essas interfaces.

É difícil imaginar alguém a aceder agora ao Higgsfield para gerar alguma coisa, quando pode gerar tudo através do seu próprio Claude Code.

Criei uma apresentação inteira com esta configuração, incluindo todos os vídeos. Descrevi a tarefa completa e entreguei-a ao agente.

Há um perigo: o agente pode começar a gerar 100 imagens, e paga por todas elas. Por isso, inclua em todas as tarefas uma condição relativa ao custo e ao número de tentativas.

Vamos ver tudo por ordem: como ligar o servidor, como lhe dar uma primeira tarefa, o que paga e quando desligar o servidor.

Passo 1. Adicione o servidor Higgsfield com o comando claude mcp add#

Abra um terminal na pasta do projeto onde vai gerar imagens e vídeos e execute:

claude mcp add --transport http higgsfield https://mcp.higgsfield.ai/mcp

O endereço está na página oficial higgsfield.ai/mcp; copie-o com o botão Copy connector URL.

Sem a opção --scope, o servidor é adicionado apenas ao projeto atual. Com --scope project, fica disponível para toda a equipa nesse projeto; com --scope user, fica disponível em todos os seus projetos.

Adicione o Higgsfield onde trabalha com ele. Num projeto em que escreve código ou texto, ocupará espaço no contexto sem fazer nada.

Abordei outros servidores para Claude Code num artigo separado.

Passo 2. Inicie sessão na sua conta Higgsfield através de /mcp#

Inicie o Claude Code e introduza /mcp. Selecione higgsfield na lista; será aberto um browser. Inicie sessão na sua conta Higgsfield.

As gerações serão cobradas a esta conta. Até iniciar sessão, o servidor devolve um erro 401: o Claude Code consegue vê-lo, mas não o consegue utilizar.

Passo 3. Confirme que o servidor se ligou#

Execute isto no terminal:

claude mcp list

O servidor higgsfield deverá apresentar o estado ✔ Connected.

Se o estado for diferente, verifique os detalhes: o endereço, o scope e o estado do servidor.

claude mcp get higgsfield

Se isso não ajudar, remova o servidor e volte a adicioná-lo:

claude mcp remove higgsfield
claude mcp add --transport http higgsfield https://mcp.higgsfield.ai/mcp

Depois, inicie sessão novamente através de /mcp. O Claude Code também apaga o início de sessão guardado quando remove o servidor, pelo que obterá o mesmo erro 401 se não voltar a iniciar sessão.

Como lhe dar uma primeira tarefa para uma imagem e um vídeo#

Dê-lhe uma primeira tarefa sem gerar nada. Peça ao agente que lhe mostre o que o servidor consegue fazer antes de gastar seja o que for:

Mostra-me que ferramentas e modelos o servidor Higgsfield tem e quantos créditos custa gerar com cada modelo. Não geres nada.

Em seguida, dê-lhe a tarefa propriamente dita. Acrescente uma condição ao fim de cada tarefa: antes de iniciar uma geração paga, indique o custo e combine o número de tentativas.

Um prompt /goal com um limite de tentativas funciona segundo o mesmo princípio: o agente fica com um número limitado de tentativas definido antecipadamente.

Tarefa para uma imagem da secção principal de um site:

Prepara uma imagem no Higgsfield para a secção principal do site do meu produto. Produto: [link]. Sugere um objeto, um ângulo, uma cor e um cenário que ajudem a explicar o produto. Deixa espaço no enquadramento para o título da página e o botão. Formato horizontal. Guarda o ficheiro final na pasta images do projeto.
Antes de iniciar uma geração paga, indica-me o custo, combina o número de tentativas e aguarda o meu «sim».

Tarefa para um vídeo feito a partir desta imagem:

Faz um vídeo curto no Higgsfield a partir da imagem images/hero.png: a câmara aproxima-se lentamente do produto e o fundo move-se ligeiramente. Sugere um modelo e pergunta-me qual deverá ser a duração do vídeo. Cria 1 versão.
Antes de iniciar uma geração paga, indica-me o custo, combina o número de tentativas e aguarda o meu «sim».

O agente acede então ao Higgsfield por iniciativa própria, escreve um prompt, gera e obtém uma imagem ou um vídeo, que lhe entrega na janela do Claude Code. Também lhe pode dizer em linguagem corrente o que deve alterar.

Que modelos estão disponíveis e quanto paga pelas gerações#

O Higgsfield funciona bem para mim porque inclui todas as ferramentas de IA na subscrição, embora se pague com créditos.

Peça ao agente a lista de modelos com a primeira tarefa da secção anterior; obterá os modelos e os respetivos preços em créditos válidos à data de hoje.

As gerações através do MCP são cobradas em créditos na sua conta Higgsfield. O próprio servidor utiliza os limites do Claude Code, por isso tem dois medidores de utilização. Mostrei onde são gastos os tokens do Claude Code num artigo separado:

Quanta utilização consome o servidor MCP e quando o deve desligar#

Todos os servidores MCP utilizam limites: as descrições das suas ferramentas são adicionadas ao contexto do modelo.

A pesquisa de ferramentas está ativada por predefinição no Claude Code. No início de uma sessão, são carregados os nomes das ferramentas do servidor e as instruções; as descrições completas são carregadas quando necessário. Se o Claude Code funcionar através do seu próprio ANTHROPIC_BASE_URL, a pesquisa é desativada e as descrições são carregadas na íntegra. Em ambos os casos, o servidor ocupa espaço no contexto de todas as sessões.

Se tiver um número enorme de ferramentas MCP instaladas, estas consomem os seus limites sem lhe trazer qualquer benefício. Por isso, há uma regra importante: se não estiver a usar o MCP, desligue-o para não sobrecarregar a janela de contexto.

Pode desligar e voltar a ligar o servidor assim:

• Temporariamente. Utilize o botão junto a higgsfield em /mcp. O Claude Code deixa de se ligar ao servidor, a definição é guardada e a seleção fica memorizada para este projeto.
• Completamente. Execute claude mcp remove higgsfield. O início de sessão guardado na conta é apagado juntamente com o servidor.
• Voltar a ligar. Utilize o mesmo botão em /mcp ou execute novamente claude mcp add e inicie sessão através de /mcp.

Mantenha o servidor ligado enquanto estiver a trabalhar com imagens e vídeos. Se estiver a escrever código ou texto e não tiver nada para gerar, desligue-o.

A propósito, criei um guia completo sobre como configurar o primeiro agente com o Hermes; não deixe de o consultar:

Nele, explico o que é o MCP, como evitar instalar um servidor malicioso e quanto custam. Depois de o ver, compreenderá de que ligações é que um agente realmente precisa.

Que abordagem escolher: o MCP, o programa Higgsfield ou um servidor não oficial#

Há três formas de ligar o Higgsfield a um agente:

Comece pelo servidor MCP: basta um comando para o instalar e um botão para o desligar. Se gerar todos os dias e não quiser um servidor a ocupar espaço no contexto, veja o programa Higgsfield com skills.

Próximo passo: Na conta Higgsfield ligada, execute a verificação de ferramentas, modelos e custo em créditos descrita acima, sem gerar conteúdo. Escolha um resultado pretendido e um limite de tentativas antes de qualquer geração. Para um fluxo separado com a API Ailoot, consulte o guia de pedidos de imagem ou o guia de tarefas e resultados de vídeo; estes descrevem chamadas à API Ailoot, e não esta conta Higgsfield MCP.