FLUX

Servidor MCP oficial do FLUX da Black Forest Labs. Gere, edite, varie e navegue por imagens FLUX.2 diretamente em qualquer cliente compatível com MCP.

Documentação

Black Forest Labs

FLUX MCP

Traga o FLUX para as ferramentas que você já usa.
Gere, edite, varie e navegue por FLUX e vídeos de qualquer cliente compatível com MCP.

MCP Registry License: MIT Docs

Instalação · Vitrine · Ferramentas · Exemplos · Solução de problemas


O servidor FLUX MCP expõe o kit de ferramentas FLUX completo — texto para imagem, edição de imagem, composição multi-referência, prova virtual, vídeo FLUX 3, variações e histórico — para qualquer cliente que fale o Model Context Protocol. Gere opções em paralelo, edite imagens anexadas por meio de prompts, experimente roupas em uma foto, anime imagens estáticas em clipes com áudio e crie variações a partir de qualquer resultado que você gostar. Sem código de API, sem chaves coladas na conversa.

  • Hospedado, remoto, somente OAuth. Conecte-se a https://mcp.bfl.ai. Entre com sua conta BFL, escolha a organização para cobrança — pronto.
  • Todos os modelos FLUX.2. Pro, Max, Klein (4B & 9B), Flex. Seu cliente escolhe o modelo certo para a tarefa.
  • Vídeo FLUX 3. Texto para vídeo, imagem para vídeo a partir de quadros-chave e continuação de vídeo com áudio sincronizado, incluindo prévias de rascunho.
  • Feito para chat. Até 8 imagens em paralelo por prompt. Edite imagens anexadas. Navegue e reutilize o histórico.
  • Você paga a BFL diretamente. Sem intermediários, sem cotas compartilhadas. Tarifas atuais: bfl.ai/pricing.

Instalação

Claude — Desktop & claude.ai
  1. Abra Configurações → Conectores.
  2. Clique em Adicionar conector personalizado.
  3. Dê o nome FLUX, URL https://mcp.bfl.ai.
  4. Clique em Conectar, entre, escolha a organização BFL para cobrança.
Claude Code
claude mcp add --transport http FLUX https://mcp.bfl.ai

Um navegador abre no primeiro uso para OAuth. Os tokens são atualizados automaticamente.

Cursor

Um clique: Adicionar ao Cursor — abre o Cursor com o servidor FLUX pré-preenchido.

Manual — adicione a .cursor/mcp.json:

{
  "mcpServers": {
    "FLUX": {
      "url": "https://mcp.bfl.ai"
    }
  }
}
Codex
codex mcp add flux --url https://mcp.bfl.ai
codex mcp login flux

Ou acrescente a ~/.codex/config.toml:

[mcp_servers.flux]
url = "https://mcp.bfl.ai"
Windsurf

Edite ~/.codeium/windsurf/mcp_config.json (observe que o Windsurf usa serverUrl, não url):

{
  "mcpServers": {
    "FLUX": {
      "serverUrl": "https://mcp.bfl.ai"
    }
  }
}

Recarregue os plugins do painel Cascade. A primeira chamada FLUX abre um navegador para login.

Outros clientes MCP (ponte stdio via mcp-remote)

Para clientes que suportam stdio MCP mas não lidam com o fluxo OAuth por conta própria — por exemplo, Hermes (Nous Research) e ferramentas semelhantes que aceitam apenas tokens estáticos do tipo bearer:

{
  "mcpServers": {
    "FLUX": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.bfl.ai"]
    }
  }
}

mcp-remote abre um navegador para OAuth, armazena tokens em ~/.mcp-auth/ e os atualiza automaticamente.


Vitrine

Gere um lote de opções em um único prompt

"Gere 4 variantes de retrato editorial — iluminação, paleta e clima variados."

Ou apenas uma — quando uma única foto heroica é o que você precisa

"Uma fotografia aérea de cima para baixo de piscinas de sal do deserto rasas, luz solar direta intensa."

Edite qualquer imagem diretamente no chat

"Adicione um camelo na areia."

AntesDepois

Navegue e reutilize todo o seu histórico de gerações

"Mostre-me minhas gerações FLUX recentes."

Cada geração é salva. Toque em qualquer bloco para editar, variar ou baixar. As variações ramificam-se de qualquer imagem passada com um clique.


Ferramentas

Seu cliente escolhe qual ferramenta chamar com base no seu prompt — você não precisa invocá-las pelo nome.

FerramentaO que faz
generate_imageGere 1–8 imagens em paralelo. Cobre texto para imagem, edições, composição multi-referência, transferência de estilo, edições estilo inpainting e outpainting — tudo por meio de prompts.
vtoProva virtual — vista uma pessoa (ou animal de estimação) com uma peça de roupa, chapéu, óculos de sol, sapatos, bolsa ou qualquer item vestível a partir de uma imagem de referência. Preserva rosto, cabelo e pose; apenas o item vestido muda.
generate_videoGere 1–4 vídeos em paralelo com FLUX 3 — texto para vídeo, imagem para vídeo a partir de quadros-chave ou continuação de um vídeo existente. 5–20 segundos, áudio sincronizado.
enhance_videoRe-renderize um vídeo rascunho em qualidade total — a mesma composição, semente e plano de prompt do rascunho que você escolheu.
generate_variationsProduza N imagens adicionais na mesma direção de uma geração anterior (identificada por request_id). Padrão: 4, máximo 8.
get_historyListe gerações recentes como uma grade de miniaturas com ações de Variações / Editar / copiar / baixar por bloco. Paginação por chave, filtros de data.
get_creditsRetorne o saldo de créditos BFL restante.

Modelos

Disponíveis em generate_image:

ModeloUse para
flux2_pro_preview (padrão)Trabalho do dia a dia — melhor equilíbrio entre qualidade e velocidade
flux2_maxFotos heroicas, ativos finais — maior qualidade
flux2_klein_9b_previewIterações mais rápidas, até 4 imagens de entrada
flux2_klein_4bOpção mais rápida
flux2_flexTipografia e texto legível

O catálogo completo, os limites de imagens de referência por modelo, as Ferramentas FLUX (vto) e o vídeo FLUX 3 também são expostos como o recurso MCP bfl://models.

Vídeo

generate_video renderiza clipes MP4 de 24fps com 5–20 segundos e áudio sincronizado, até 4 em paralelo por chamada. Cada solicitação usa um de três modos:

ModoEntradaO que você obtém
t2vApenas promptUm clipe gerado a partir da sua descrição
i2vPrompt + 1–10 imagens de quadro-chaveUm quadro-chave anima uma imagem estática a partir do seu quadro inicial exato; dois fazem a ponte entre um quadro inicial e um final; 3–10 formam um storyboard distribuído uniformemente pelo clipe (duration explícito necessário)
v2vPrompt + um vídeo de origemUma continuação dos segundos finais da origem, com áudio incluído
  • Prompts são prosa O FLUX 3 raciocina sobre o prompt e planeja a geração antes de renderizar — descreva a cena, o movimento e o som. Não há semente ou parâmetro de modelo no vídeo.
  • Quadros-chave referenciam um resultado anterior (request_id), uma imagem enviada ou uma URL pública. Carimbos de tempo opcionais por quadro-chave (em segundos, crescentes — definidos em todos os quadros-chave ou em nenhum) fixam posições exatas no clipe; com duration definido como auto, o clipe vai até o último carimbo de tempo (máximo de 20 segundos).
  • Vídeos de origem para v2v são um resultado anterior de generate_video, um MP4 anexado de até 50 MB ou uma URL pública de MP4.
  • Controles de formato. duration: 5–20 segundos ou auto (padrão). aspect_ratio: auto (padrão), 21:9, 2:1, 16:9, 4:3, 1:1, 3:4 ou 9:16. resolution: hd (padrão, classe 704p) ou fhd (finalizado por um upsampler de vídeo em uma tela classe 1080p). generate_audio: ativado por padrão.
  • Rascunhos são o caminho para explorar. draft: true renderiza uma prévia rápida de baixa etapa da geração planejada exata (somente hd). Faça lotes de rascunhos baratos, escolha o vencedor e enhance_video o re-renderiza em qualidade total a partir do seu request_id.
  • As renderizações levam minutos — clipes longos até cerca de uma hora. A ferramenta retorna imediatamente com um request_id pendente; os resultados sobrevivem ao fechamento do chat e são retomados automaticamente.
  • Condicionamento baseado em referência (referências de identidade e movimento) não faz parte da superfície de vídeo; um modo dedicado r2v virá mais tarde.

Exemplos de prompts

Experimente estes no seu cliente depois que o FLUX estiver conectado:

Generate 4 editorial portrait variants — varied lighting, palette, and mood.
Use FLUX.2 [pro] at 1440×1792.
A top-down aerial photograph of shallow desert salt pools at golden hour,
intense direct sunlight, #FF6B6B and #F5E6D3 mineral deposits, FLUX.2 [max].
[attach an image]
Add a camel on the sand. Preserve the rest of the composition exactly.
Generate a movie poster with the title "MIRAGE" in 1970s grindhouse type,
high-contrast cyan and orange. Use FLUX.2 [flex].
[attach a selfie]
Try this on me — a red Nike Tech Fleece hoodie, oversized fit.
[attach an image]
Animate this into a 10-second clip — slow push-in, wind through the palms,
distant surf.
Generate 3 draft videos of a paper lantern rising over a night market,
each with a different camera move. I'll enhance the best one.
Show me my recent FLUX generations.
[click Variations on a past image]
4 more like this one, vary the lighting.

Dicas de prompt

  • Coloque o assunto em primeiro lugar. Ponha o objeto, pessoa ou cena mais importante primeiro.
  • Descreva a iluminação. "Luz suave da hora dourada" ou "luz de estúdio difusa e nublada" dá ao modelo uma direção útil.
  • Use cores hexadecimais. #FF6B6B (coral pink) é mais preciso do que "vermelho rosado".
  • Cite texto renderizado. Use strings exatas entre aspas para tipografia, rótulos, pôsteres e placas.
  • Evite prompts negativos. O FLUX responde ao que você descreve, não a uma lista do que evitar.
  • Itere a partir dos resultados. Use Variações para alternativas ou Editar para continuar refinando uma imagem gerada.

Para o guia completo de prompts do FLUX, veja black-forest-labs/skills.


Solução de problemas

Ferramentas não aparecem após conectar
  • Claude Desktop / claude.ai: Configurações → Conectores, confirme que o FLUX aparece como Conectado. Se falhou silenciosamente, remova e adicione novamente — certifique-se de que pop-ups não estão bloqueados para que a janela OAuth possa abrir.
  • Claude Code: claude mcp list deve mostrar o servidor.
  • Codex: codex mcp list deve mostrar flux. Inicie uma nova sessão do Codex após adicionar.
  • Teste rápido: peça ao seu cliente "verifique meus créditos BFL".
Atualizando ferramentas ou reconectando o servidor
  • Claude.ai / Desktop: Configurações → Conectores → alterne o FLUX para desligado e ligado, ou clique em Reconectar.
  • Claude Code: /mcp mostra o status e a reautenticação. Reconstrução completa:
    claude mcp remove FLUX
    claude mcp add --transport http FLUX https://mcp.bfl.ai
    
  • Codex: codex mcp login flux. Reconstrução completa:
    codex mcp remove flux
    codex mcp add flux --url https://mcp.bfl.ai
    
  • Clientes mcp-remote: rm -rf ~/.mcp-auth e reinicie o cliente para forçar um novo OAuth.
Erros de autenticação ou cobrança
  • Certifique-se de ter uma conta BFL em bfl.ai.
  • Desconecte e reconecte o conector para refazer o OAuth.
  • Verifique se a organização selecionada tem créditos suficientes.
  • Peça ao seu cliente para verificar seus créditos BFL para confirmar o saldo.
Uma geração continua carregando

Lotes grandes, FLUX.2 [max] ou edições complexas levam mais tempo do que gerações menores. Clientes MCP visuais atualizam a visualização da imagem automaticamente.

As renderizações de vídeo levam minutos — clipes longos até cerca de uma hora. Elas retornam uma solicitação pendente imediatamente e são retomadas automaticamente, mesmo se você fechar o chat e voltar mais tarde.

A edição de imagem ou vídeo anexado falha

Seu cliente MCP precisa de permissão para enviar mídia anexada à BFL. Se o seu cliente bloquear HTTPS de saída do sandbox, permita *.bfl.ai ou passe uma URL pública. Os uploads de vídeo são apenas MP4, até 50 MB.

Alternando a organização cobrada

Desconecte o conector FLUX no seu cliente e reconecte-o. O fluxo OAuth solicitará que você selecione uma organização novamente.


Agent Skills (repositório complementar)

MCP e Agent Skills resolvem problemas diferentes:

MCP (este repositório)Agent Skills
O que fazGera, edita, varia e navega por imagens diretamente no chatEnsina seu agente de codificação a escrever código da API FLUX
Melhor paraTrabalho criativo dentro do Claude ou de outro cliente MCPCriação de aplicações que chamam a API FLUX

Use ambos. Eles se complementam.


Links


Licença

MIT © Black Forest Labs