Como usar o Higgsfield MCP no Claude e no ChatGPT

Quase tudo que faço no Higgsfield hoje começa numa janela de chat, e não no site. Este guia é a configuração que eu queria ter tido no começo, com o caminho errado incluído.

Para usar o Higgsfield MCP, adicione um conector personalizado no Claude apontando para https://mcp.higgsfield.ai/mcp, entre na sua conta do Higgsfield e peça imagens e vídeos em linguagem normal. Não existe chave de API. Cada geração gasta os créditos do seu plano pago, pelo preço padrão.

Tudo que aparece abaixo foi feito na janela de chat do Claude, pelo conector do Higgsfield AI: uma imagem, um clipe do Kling feito a partir dela e uma edição Katana. Mais uma imagem saiu do ChatGPT, pelo plugin, e o Claude Code ganha um passo próprio porque a configuração é outra. Existe um conector no diretório do próprio Claude que parece certo mas não gera nada, então é por ele que eu começo.

O que você precisa antes de começar

Um plano pago do Higgsfield é o mínimo. O Starter, a US$ 19 por mês, é a entrada mais barata, e a avaliação do Higgsfield tem a lista completa de preços. Além disso, você precisa de uma conta no Claude (site ou app para desktop) ou no ChatGPT, e da conta certa do Higgsfield logada em higgsfield.ai.

O MCP, a CLI, o Canvas e o Supercomputer nunca usam os modelos Unlimited nem as gerações grátis. Isso só funciona no próprio higgsfield.ai.

Passo 1: adicione o conector certo do Higgsfield no Claude

Pule a entrada do diretório do Claude. Ela aparece como “Higgsfield AI (Community)” e é uma ponte pequena para vídeos do Claude Motion, com sete ferramentas que cobrem saldo, workspaces, modelos e histórico de gerações. Se você pedir uma imagem, o Claude responde que não tem ferramentas de geração.

O conector personalizado em mcp.higgsfield.ai/mcp é o de verdade. Ele expõe cerca de 150 ferramentas, que cobrem imagens, vídeo, Katana, personagens Soul, dublagem, vozes, upscale e publicação. Funciona igual no site e no app para desktop, já que os dois usam a mesma conta. Se o Chrome já estiver logado no higgsfield.ai, a aprovação passa sem pedir nada.

Se o Connect passar sem nunca mostrar uma página de login do Higgsfield, o Claude reaproveitou um login anterior. Remova todas as entradas do Higgsfield em Yours, limpe os dados do navegador para clerk.higgsfield.ai e mcp.higgsfield.ai, adicione o conector de novo e entre na conta que tem o seu plano. Limpar esses dados também desloga você do higgsfield.ai, então conte com um novo login por lá.

Passo 2: confira seus créditos pelo chat

Na primeira vez, o Claude pede permissão para usar a ferramenta, porque toda ferramenta do conector começa em “Needs approval”. A resposta traz o seu plano e os créditos do workspace selecionado, e é essa a conferência de que a conta certa está conectada. Se o workspace aparecer como “not selected”, peça ao Claude que o selecione. O conector nunca mostra o seu e-mail, só IDs de workspace.

Se os pedidos de aprovação cansarem, abra Customize → Connectors → Yours, escolha o Higgsfield e marque uma ferramenta como Always allow em Tool permissions.

Passo 3: gere uma imagem pelo chat

Pedi o Nano Banana Pro em 16:9 e disse ao Claude para seguir em frente se custasse 4 créditos ou menos. Meu prompt foi “a matte forest-green ceramic travel mug on a wooden cafe counter, soft morning window light, product photo, shallow depth of field”. O custo voltou em 2 créditos, o Claude gerou no 2K padrão, e a imagem apareceu no chat com os botões Download e Reference.

Uma esquisitice: o extrato de créditos cobrou como Nano Banana Pro, mas o histórico de gerações marca nano_banana_2, então pelos registros não dá para saber qual modelo renderizou.

Passo 4: transforme a imagem em vídeo conferindo o custo

Pedi um clipe de 5 segundos do Kling 3.0 em 720p, 16:9, com a imagem da caneca como quadro inicial. A cotação foi de 10 créditos com áudio, já que o som ambiente vem ligado por padrão, ou 7,5 créditos sem som. O próprio Claude escreveu o prompt de movimento: “slow push-in on the matte forest-green ceramic travel mug, a thin curl of steam rising gently, the coffee beans and cloth stay completely still, same soft morning window light, shallow depth of field”. Respondi que podia ir, com áudio.

O clipe voltou em cerca de dois minutos, com 5 segundos em 1284×716 e uma faixa AAC. O push-in e o vapor estão lá, e os grãos e o pano ficam parados, exatamente o que pedi. Para ver como o Kling se comporta no app dele, meu tutorial do Kling AI cobre as configurações.

Passo 5: rode uma edição Katana

O Katana é a skill de edição do Higgsfield para o Claude, publicada em 12 de outubro. Você entrega uma edição de referência, que pode ser um preset do catálogo ou um clipe seu, e até cinco fotos de um produto, personagem ou look. Ele refaz a edição com o seu material, seguindo a ordem dos planos, o ritmo e os cortes da referência.

Ao digitar /katana, abriu-se um cartão de catálogo com presets da comunidade, os primeiros 20 de cerca de 100, e /katana/preset-name roda um direto. Os arquivos de referência para presets próprios têm de 3 a 30 segundos. O Claude escolheu “Cinematic Perfume Commercial” para a caneca, o único preset construído em torno de um produto como protagonista.

O Claude leu os 468 quadros da referência de 19,5 segundos antes de planejar. O Katana não consegue cotar um preço único de antemão. A análise e o planejamento são grátis, e depois cada imagem e cada clipe planejado recebe um preço exato. O meu ficou assim.

Peça	O que era	Créditos
Imagem do café	Duas tentativas, Soul Cinema 2K	0,24
Plate principal	5 planos, Seedance 2.5, 720p, 10 s	70
Plate macro	6 planos, Seedance 2.5, 720p, 12 s	84
Total		154,24

Flashes, color grade, tempo, a montagem e o áudio não custam nada, o que me surpreendeu. Aprovei, e o Claude começou.

O que voltou foi um comercial de 12,7 segundos em 1280×720, no ritmo do anúncio de perfume. Tem cortes com flash branco, detalhes em macro, uma gota escorrendo da tampa contra a luz âmbar, vapor, a caneca em contraluz com um sol baixo e um fade para preto, com um trecho de 12,7 segundos da música da referência por baixo. A execução toda levou uns 20 minutos, análise incluída.

Não ficou perfeito. As duas primeiras imagens de cenário com o balcão vazio vieram com uma caneca desenhada, então o Katana precisou de uma terceira tentativa, e por isso o gasto fechou em 154,36 créditos, 0,12 acima da cotação. Dois planos macro foram descartados porque a tampa sumia neles, e a edição ficou com 12,7 segundos em vez de 15. A gota do começo também parece água limpa, não café. O Claude ofereceu um único plano de 28 créditos para corrigir qualquer um dos dois, e eu deixei como está.

Passo 6: conecte o Higgsfield ao Claude Code

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

O comando imprime “Added HTTP MCP server higgsfield” e guarda o servidor na sua configuração local. Logo depois, o claude mcp list mostra o servidor como “Needs authentication”, o que é esperado até você fazer o login pelo /mcp. A lista também inclui os conectores que você já tem no claude.ai, então pode aparecer “Higgsfield” e “Higgsfield AI” juntos, e o primeiro é o que você quer.

O Higgsfield também publica um caminho por CLI para agentes de código. O npx skills add higgsfield-ai/skills instala três skills (generate, soul e product-photoshoot), o higgsfield auth login faz o login e o /higgsfield:generate roda uma geração. Mesmos créditos, mesmas regras. Eu usei o caminho do MCP, não este.

Passo 7: adicione o plugin do Higgsfield ao ChatGPT

Funcionou numa conta Free do ChatGPT para mim. Pedir o saldo num chat novo devolveu um cartão da conta com o plano, o saldo de créditos e as gerações grátis que ainda restavam. O pedido de imagem, Nano Banana Pro em 16:9 a 1K, uma caneca num parapeito ensolarado ao lado de um vasinho de planta, foi cotado em 2 créditos e voltou em cerca de 49 segundos, com os botões Download e Reference. Apareceu a mesma esquisitice do rótulo nano_banana_2.

A geração de áudio funciona no Claude mas não no ChatGPT, e a disponibilidade do plugin pode depender do plano, da região e do workspace.

A página do plugin lista comandos de barra para presets (/effects, /product, /motion, /marketing-studio) e fluxos com nome (/hero-shot, /reel-cover, /genjutsu). Depois de instalado, a página mostra os botões Manage e Open plugin.

O Higgsfield MCP é grátis?

Não. Você precisa de um plano pago ativo, cada geração gasta créditos pelo preço padrão, e os modelos Unlimited ficam só na web. Também não existe um teto de gastos embutido, então o hábito que funcionou para mim foi pedir ao agente que cotasse o custo e esperasse o meu aval.

O que o teste custou	Créditos
Imagem (Nano Banana Pro, 2K)	2
Clipe do Kling 3.0, 5 s com áudio	10
Tentativas de cenário do Katana	0,36
Plate principal do Katana	70
Plate macro do Katana	84
Total no Claude	166,36

A imagem do ChatGPT somou mais 2. Para ter uma noção de escala, o plano Ultra do Higgsfield vem com 3.000 créditos por mês, então o teste inteiro usou pouco mais de 5% de um mês. O jeito como eu faço esses testes está na página como testamos.

MCP, API ou CLI: qual você quer?

O MCP é para agentes de chat. O Claude, o plugin do ChatGPT e outros agentes, como OpenClaw, Hermes Agent, NemoClaw e Manus, falam com o Higgsfield por ele, e você paga com os créditos do seu plano.

A CLI é para agentes de código. O caminho das skills, mostrado acima, dá a um agente de terminal as mesmas ferramentas de geração, com os mesmos créditos.

A API é um produto separado, para o seu próprio software. Ela usa chaves de API e uma cobrança própria, e o seu plano não a cobre. Se você só quer fazer imagens e clipes pelo chat, não precisa dela.

Onde ficam os resultados

Todo resultado aparece como um cartão no chat com os botões Download e Reference, e os resultados do Katana ganham o Publish. As mesmas gerações também aparecem em Assets no higgsfield.ai. Os links de download no chat são links simples de arquivo, então dá para salvar sem entrar em mais nenhuma conta.

Se você está pesando o Higgsfield contra ir direto ao app de um modelo, a comparação Higgsfield vs Kling AI coloca os preços e o resultado lado a lado.

Quando não funciona

• O Claude diz que não tem ferramentas de geração. Você adicionou o conector do diretório; remova-o e adicione o personalizado do Passo 1.
• Está conectado à conta errada do Higgsfield. Remova todas as entradas do Higgsfield, limpe os dados do site para clerk.higgsfield.ai e mcp.higgsfield.ai e adicione o conector de novo.
• Toda ferramenta pede aprovação. É o padrão, e você pode marcar Always allow por ferramenta em Tool permissions do conector.
• Uma geração é recusada. A moderação pode barrar um prompt, então reescreva-o, e lembre que uma nova tentativa dentro do Katana custa créditos, como aconteceu com a minha terceira tentativa de cenário.

Para saber mais

• Guia de conexão do Higgsfield
• Anúncio do Katana pelo Higgsfield
• Guia de conectores personalizados da Anthropic

Perguntas Frequentes