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
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.
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
- Abra Configurações → Conectores.
- Clique em Adicionar conector personalizado.
- Dê o nome
FLUX, URLhttps://mcp.bfl.ai. - 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."
| Antes | Depois |
![]() | ![]() |
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.
| Ferramenta | O que faz |
|---|---|
generate_image | Gere 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. |
vto | Prova 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_video | Gere 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_video | Re-renderize um vídeo rascunho em qualidade total — a mesma composição, semente e plano de prompt do rascunho que você escolheu. |
generate_variations | Produza N imagens adicionais na mesma direção de uma geração anterior (identificada por request_id). Padrão: 4, máximo 8. |
get_history | Liste 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_credits | Retorne o saldo de créditos BFL restante. |
Modelos
Disponíveis em generate_image:
| Modelo | Use para |
|---|---|
flux2_pro_preview (padrão) | Trabalho do dia a dia — melhor equilíbrio entre qualidade e velocidade |
flux2_max | Fotos heroicas, ativos finais — maior qualidade |
flux2_klein_9b_preview | Iterações mais rápidas, até 4 imagens de entrada |
flux2_klein_4b | Opção mais rápida |
flux2_flex | Tipografia 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:
| Modo | Entrada | O que você obtém |
|---|---|---|
t2v | Apenas prompt | Um clipe gerado a partir da sua descrição |
i2v | Prompt + 1–10 imagens de quadro-chave | Um 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) |
v2v | Prompt + um vídeo de origem | Uma 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; comdurationdefinido comoauto, o clipe vai até o último carimbo de tempo (máximo de 20 segundos). - Vídeos de origem para
v2vsão um resultado anterior degenerate_video, um MP4 anexado de até 50 MB ou uma URL pública de MP4. - Controles de formato.
duration: 5–20 segundos ouauto(padrão).aspect_ratio:auto(padrão),21:9,2:1,16:9,4:3,1:1,3:4ou9:16.resolution:hd(padrão, classe 704p) oufhd(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: truerenderiza uma prévia rápida de baixa etapa da geração planejada exata (somentehd). Faça lotes de rascunhos baratos, escolha o vencedor eenhance_videoo re-renderiza em qualidade total a partir do seurequest_id. - As renderizações levam minutos — clipes longos até cerca de uma hora. A ferramenta retorna imediatamente com um
request_idpendente; 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
r2vvirá 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 listdeve mostrar o servidor. - Codex:
codex mcp listdeve mostrarflux. 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:
/mcpmostra 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-authe 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 faz | Gera, edita, varia e navega por imagens diretamente no chat | Ensina seu agente de codificação a escrever código da API FLUX |
| Melhor para | Trabalho criativo dentro do Claude ou de outro cliente MCP | Criação de aplicações que chamam a API FLUX |
Use ambos. Eles se complementam.
Links
- Documentação — docs.bfl.ai
- Preços — bfl.ai/pricing
- Status — status.bfl.ai
- Black Forest Labs — bfl.ai
Licença
MIT © Black Forest Labs
