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 imagens e vídeos FLUX a partir de qualquer cliente compatível com MCP.

MCP Registry License: MIT Docs

Instalação · Demonstrações · Ferramentas · Habilidades · Exemplos · Solução de problemas


O servidor FLUX MCP expõe o kit de ferramentas completo do FLUX — texto para imagem, edição de imagem, composição com múltiplas referências, provador 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 desejar. 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 e 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 rascunhos de pré-visualização.
  • Feito para conversas. Até 8 imagens em paralelo por prompt. Edite imagens anexadas. Navegue e reutilize o histórico.
  • Guias de prompting especializados. Guias oficiais da BFL cobrem fluxos de trabalho focados em imagem e FLUX 3.
  • Você paga a BFL diretamente. Sem intermediários, sem cotas compartilhadas. Preços atuais: bfl.ai/pricing.

Instalação

Claude — Desktop e claude.ai
  1. Abra Configurações → Conectores.
  2. Clique em Adicionar conector personalizado.
  3. Nomeie-o como FLUX, URL https://mcp.bfl.ai.
  4. Clique em Conectar, entre e 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

Com 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 no painel Cascade. A primeira chamada FLUX abre um navegador para o login.

Outros clientes MCP (ponte stdio via mcp-remote)

Para clientes que suportam MCP stdio, mas não lidam com o fluxo OAuth por conta própria — por exemplo, Hermes (Nous Research) e ferramentas semelhantes que só aceitam 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/ em cache e os atualiza automaticamente.


Demonstrações

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

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

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

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

Edite qualquer imagem diretamente no chat

"Adicione um camelo na areia."

AntesDepois

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

"Mostre minhas gerações FLUX recentes."

Toda geração é salva. Toque em qualquer bloco para editar, variar ou baixar. As variações ramificam-se de qualquer imagem anterior 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 ela faz
generate_imageGere 1–8 imagens em paralelo. Cobre texto para imagem, edições, composição com múltiplas referências, transferência de estilo, edições no estilo inpainting e outpainting — tudo por meio de prompts.
vtoProvador virtual — vista uma pessoa (ou animal de estimação) com uma peça de roupa, chapéu, óculos de sol, sapatos, bolsa ou qualquer 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 de 4, máximo de 8.
get_historyListe gerações recentes como uma grade de miniaturas com ações por bloco de Variações / Editar / copiar / baixar. Paginação por chave, filtros de data.
get_creditsRetorne seu saldo restante de créditos BFL.
list_skillsListe os guias de prompting oficiais da BFL — melhores práticas de imagem, direção de vídeo, áudio e diálogo, quadros-chave, anúncios de produtos, looks arquivais, integração de API.
get_skillBusque um guia pelo nome. Guias longos retornam uma introdução mais um índice de seções; busque as seções que a tarefa precisar.

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 principais, ativos finais — qualidade máxima
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 FLUX Tools (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
t2vSomente 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 de seu quadro de abertura exato; dois fazem a ponte entre um quadro de abertura e um de fechamento; 3–10 formam um storyboard distribuído uniformemente pelo clipe (duration explícito obrigató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 nem 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, em ordem crescente — 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 de classe 1080p). generate_audio: ativado por padrão.
  • Rascunhos são o caminho para explorar. draft: true renderiza uma pré-visualização rápida de baixa etapa do plano exato de geração (somente hd). Faça lotes de rascunhos baratos, escolha o vencedor e enhance_video o re-renderiza em qualidade total a partir de 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 r2v dedicado virá depois.

Habilidades de prompting

O servidor inclui guias de prompting especializados de black-forest-labs/skills e os serve de três maneiras, para que todo cliente tenha pelo menos uma. Esses guias cobrem fluxos de trabalho focados; um guia geral de prompting do FLUX 3 ainda não está incluído:

  • Ferramentas — list_skills e get_skill(name). Funciona em qualquer lugar, incluindo ChatGPT.
  • Recursos — bfl://skills/<name> para clientes com seletores de recursos (Claude, Cursor).
  • Prompts — skill_<name_with_underscores> slash-prompts onde o cliente os suporta (por exemplo, skill_flux_image_best_practices).

Pergunte "quais habilidades FLUX você tem?" ou apenas solicite algo especializado, como um anúncio de produto, filmagem Super 8, direção de diálogo. As ferramentas de geração apontam seu cliente para o guia correspondente antes de escrever o prompt.


Exemplos de prompts

Experimente estes no seu cliente assim 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 no início. Ponha o objeto, pessoa ou cena mais importante primeiro.
  • Descreva a iluminação. "Luz suave de hora dourada" ou "luz difusa de estúdio 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.

O servidor expõe guias especializados para fluxos de trabalho focados. Um guia geral de prompting do FLUX 3 ainda não está incluído.


Solução de problemas

As ferramentas não aparecem após a conexão
  • 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 os pop-ups não estejam 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: pergunte ao seu cliente "verifique meus créditos BFL".
Atualizando ferramentas ou reconectando o servidor
  • Claude.ai / Desktop: Configurações → Conectores → desative e reative o FLUX, 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 e confirmar o saldo.
Uma geração continua carregando

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

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

Falha na edição de imagem ou vídeo anexado

Seu cliente MCP precisa de permissão para enviar mídia anexada ao BFL. Se o seu cliente bloquear HTTPS de saída do sandbox, permita *.bfl.ai ou forneça uma URL pública. 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.


Habilidades do Agente (repositório complementar)

MCP e Habilidades do Agente resolvem problemas diferentes:

MCP (este repositório)Habilidades do Agente
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 outro cliente MCPConstruir aplicações que chamam a API FLUX

Use ambos. Eles se complementam e os guias de prompt do repositório de habilidades também são servidos diretamente via MCP (veja Habilidades de prompt).


Links


Licença

MIT © Black Forest Labs