Distribea MCP

Distribea é um kit de mídia com IA alinhado à sua marca, feito para quem cria. Ele gera imagens, vídeo, música e voz a partir de comandos em linguagem natural e os entrega prontos para produção — WebP otimizado com texto alternativo para SEO, baixados para você ou inseridos direto no seu código. Um único conector, quatro tipos de mídia, acessível de três formas: uma CLI no seu terminal, um servidor MCP que seu agente de codificação com IA aciona enquanto cria, e um Claude Skill. Defina sua marca uma única vez; um diretor de arte com IA integrado escreve cada prompt — você diz o que quer, nunca como renderizar. Cobrança em créditos pelo preço normal do site; o conector não guarda chaves de API nem segredos.

npm install -g distribea-mcp
distribea login                                       # opens your browser — no key to paste

distribea image "founder portrait, soft daylight"  --portrait
distribea video "slow waves rolling at golden hour" --landscape
distribea music "warm lo-fi beat, mellow, 90 bpm"
distribea voice "Welcome to our store."             --lang en

Cada arquivo chega em uma pasta organizada, pronto para uso. Adicione --dry-run a qualquer comando para ver o preço exato em créditos primeiro (0 créditos, não gera nada).

---

Conteúdo

• O que é o Distribea
• O que você pode criar
• Quando usar o Distribea
• Por que o Distribea
• Instalação
• Início rápido
• Exemplos e receitas
• Vista uma página inteira
• Rostos e produtos recorrentes
• Modelos
• Referência de comandos
• Flags
• Ferramentas MCP
• Como funciona
• Cobrança e custo
• Privacidade e segurança
• FAQ
• Solução de problemas
• Atualização
• Suporte
• Licença

O que é o Distribea

A maioria das ferramentas de mídia com IA entrega um modelo bruto e uma caixa de prompt vazia, em uma aba do navegador, uma imagem por vez. O Distribea é a camada acima disso — e ele vive onde você cria.

• Um conector, quatro tipos de mídia. Imagem, vídeo, música e voz com uma única instalação. A maioria das ferramentas para nas imagens.
• Três formas de acesso, um só mecanismo. Execute pelo seu terminal (distribea …), adicione ao seu agente de IA como servidor MCP (Claude Code, Cursor, Windsurf, Replit, Copilot) ou instale o Claude Skill para que o modelo o acione sozinho.
• Alinhado à marca por padrão. Bloqueie sua marca uma vez e cada ativo seguirá o padrão. O diretor de arte transforma um assunto de uma linha em um prompt completo — você nunca escreve o "como".
• Pronto para produção. As imagens saem em WebP otimizado com texto alternativo adequado para SEO, baixadas para você ou inseridas direto na sua página.

O trabalho pesado — direção de arte, geração, cobrança — roda no mecanismo hospedado do Distribea. Este pacote é apenas o conector local: ele verifica e ajusta seus arquivos, não guarda chaves de API nem segredos e cobra a geração em créditos do seu plano Distribea pelo preço normal do site.

O que você pode criar

Mídia	Comando	O que você recebe
🖼️ Imagem	distribea image "<subject>"	Uma imagem alinhada à marca (png/jpg), em qualquer proporção. Retratos, heróis, fotos de produto, ilustrações, avatares de avaliações.
🎬 Vídeo	distribea video "<subject>"	Um clipe curto (mp4) — texto para vídeo ou imagem para vídeo a partir de uma foto de referência.
🎵 Música	distribea music "<style>"	Uma faixa pronta para uso comercial (mp3) — aberturas, música de fundo, trilhas para anúncios.
🎙️ Voz	distribea voice "<text>"	Uma narração (mp3), texto para fala em vários idiomas.
📄 Uma página inteira	distribea page [path]	Todos os espaços reservados <img> de uma página (ou do projeto todo) preenchidos com a identidade da marca, em paralelo, inseridos no seu código.
✍️ Capa de blog	distribea blog "<article>"	Uma imagem de capa 16:9 que ilustra o assunto real do artigo, no seu estilo, + texto alternativo.

Quando usar o Distribea

Use o Distribea sempre que um projeto precisar de imagens ou áudio e você acabaria usando fotos de banco de imagens, espaços reservados cinza, seções só com gradiente CSS ou uma foto colada sem tratamento. Trabalhos típicos:

• Você está criando uma landing page e precisa de imagens reais e alinhadas à marca — não de banco de imagens.
• Você precisa de fotos de produto para e-commerce que mantenham consistência em todo o catálogo.
• Você quer uma imagem hero, retratos de equipe ou avatares de depoimentos com rostos convincentes.
• Você está escrevendo um post de blog e precisa de uma imagem de capa combinando com o artigo e com seu estilo.
• Você precisa de um clipe de vídeo curto (texto para vídeo ou imagem para vídeo) para um hero ou anúncio.
• Você precisa de música de fundo para uma abertura, demonstração ou anúncio.
• Você precisa de uma narração para uma demonstração, tutorial ou vídeo.
• Você tem um site cheio de fotos de banco de imagens baratas ou fora da marca e quer reformulá-las no lugar.
• Você está codificando com um agente de IA e quer que ele preencha a mídia sozinho enquanto cria.

Por que o Distribea

	CLI/MCP de modelo bruto	MCP de imagem genérico	Distribea
Imagem · vídeo · música · voz	⚠️ varia	❌ só imagem	✅ os quatro, um conector
Vive no seu terminal e no seu agente	⚠️ um deles	⚠️ só MCP	✅ CLI · MCP · Skill
Escreve a direção de arte para você	❌ você dá prompt a cada modelo	⚠️ prompt por prompt	✅ diretor de arte integrado
Bloqueia sua marca uma vez	❌	⚠️ por prompt	✅ aplicado em tudo
Mesmo rosto em várias cenas	❌	❌	✅ personagens recorrentes
Preenche uma página inteira em uma chamada	❌	❌	✅ distribea page
Pronto para produção (WebP + SEO alt)	❌	❌	✅ automático
Sem chaves/segredos no conector	⚠️ guarda suas chaves de modelo	⚠️ varia	✅ login pelo navegador, nada para colar

Em uma frase: outras ferramentas dão a você um modelo e uma caixa de prompt; o Distribea entrega ativos prontos e alinhados à marca — nos quatro tipos de mídia que você realmente precisa — sem sair do lugar onde você cria.

Instalação

Um plano Distribea alimenta a geração (contas gratuitas/de teste recebem algumas imagens de cortesia para experimentar). O conector em si é gratuito e não armazena segredos.

CLI (recomendado)

npm install -g distribea-mcp
distribea login          # opens your browser, click Authorize — no key to paste

distribea whoami confirma que você está conectado.

Servidor MCP

Adicione isto ao .mcp.json na raiz do seu projeto:

{
  "mcpServers": {
    "distribea-mcp": {
      "command": "npx",
      "args": ["-y", "distribea-mcp@latest"],
      "env": {
        "DISTRIBEA_MCP_KEY": "dmcp_…"
      }
    }
  }
}

Pegue sua chave dmcp_… em distribea.com/account/mcp. Se você já executou distribea login, o servidor reutiliza essa sessão e você pode omitir o bloco env inteiro.

Ferramenta	Onde adicionar
Claude Code	claude mcp add distribea-mcp -e DISTRIBEA_MCP_KEY=dmcp_… -- npx -y distribea-mcp@latest
Cursor	Settings → MCP → Add, ou cole o bloco em ~/.cursor/mcp.json
Windsurf	Cole em ~/.codeium/windsurf/mcp_config.json
VS Code (Copilot)	Cole em .vscode/mcp.json
Replit	Adicione como servidor MCP personalizado com o comando acima

Claude Skill

O pacote inclui SKILL.md. Adicione uma vez e seu agente acionará o Distribea sozinho sempre que uma página precisar de imagens ou áudio.

npx skills add Distribea/distribea-mcp

Início rápido

npm install -g distribea-mcp
distribea login
distribea image "a quiet beach at sunrise, warm light" --landscape

O arquivo chega em uma pasta organizada, pronto para uso. É isso — sem modelo para escolher, sem engenharia de prompt: o estilo é inferido e o diretor de arte escreve o prompt. A partir daqui, troque image por video, music ou voice, ou execute distribea page para vestir uma página inteira de uma vez.

Exemplos e receitas

Todo comando aceita um assunto em linguagem natural. Adicione --dry-run para pré-visualizar o preço primeiro (0 créditos, não gera nada).

Imagem alinhada à marca

distribea image "founder portrait, soft daylight, neutral background" --portrait

Vídeo autônomo (texto para vídeo)

distribea video "slow waves rolling onto a tropical beach" --landscape

Música de fundo

distribea music "warm lo-fi beat, mellow, 90 bpm" --out ./assets

Narração (texto para fala)

distribea voice "Welcome to our store — let's get you started." --lang en

Foto de referência → imagem ou vídeo (imagem para imagem / imagem para vídeo)

Transforme uma foto real em uma nova imagem alinhada à marca ou anime-a. Passe --ref uma vez, ou várias vezes para múltiplas referências — limitado automaticamente ao que o modelo escolhido aceita.

distribea image "the same product on a marble kitchen counter" --ref ./bottle.jpg
distribea video "gentle push-in on the cliff at golden hour" --ref ./cliff.jpg --portrait

Capa de blog

Lê o artigo e ilustra o assunto específico dele, combinando com seu estilo bloqueado, como WebP 16:9 + texto alternativo.

distribea blog "How we cut our build times in half — full article body here…"

Escolha um modelo específico

Os padrões são fortes; nomeie um modelo apenas quando quiser um específico.

distribea image "minimalist blue logo on white" --model nano-banana-pro --dry-run

Navegue pelo catálogo ao vivo (grátis)

distribea models image      # or: video | music | voice

Vista uma página inteira

O fluxo de página é o superpoder. Construa sua página com marcadores <img src="https://placehold.co/1200x600"> onde cada imagem deve entrar, e uma única chamada preenche todos os espaços com imagens que combinam com sua marca — um visual consistente em todo o site, personagens recorrentes com o mesmo rosto em todas as cenas, avatares UGC convincentes para seções de avaliações.

distribea page ./index.html      # omit the path to dress the whole project

Cada imagem chega pronta para produção: WebP otimizado, texto alternativo adequado para SEO e inserida direto no seu código. Sem fotos de banco de imagens. Sem espaços reservados. Sem etapa de exportação. O estilo é inferido da própria página, então não há nada para configurar.

Já tem um site com fotos de banco de imagens baratas ou fora da marca? Reformule-as no lugar — a primeira passagem lista cada imagem substituível gratuitamente e depois aplica o novo visual sem tocar no seu código (os originais são mantidos como *.original).

Rostos e produtos recorrentes

Uma pessoa real (um fundador, um professor) ou um produto que precisa parecer idêntico em cada foto é tratado como um assunto bloqueado — o rosto/objeto permanece 100% idêntico, apenas o cenário muda.

distribea image "the teacher explaining at a whiteboard" --ref ./founder.jpg

Nunca cole uma foto crua na página: deixe um espaço reservado e deixe o mecanismo recriar aquele rosto exato no mundo do seu site. Avatares de avaliações e depoimentos saem como selfies casuais de smartphone (visual UGC); o mesmo avaliador mantém o mesmo rosto em todo o site.

Modelos

A geração roda em provedores de primeira linha, com um padrão forte alinhado à marca por tipo de mídia — então raramente você precisa nomear um:

Tipo	Padrão	Alguns provedores disponíveis
Imagem	Nano Banana Pro (2K)	Nano Banana Pro · Seedream · Z-Image · Grok Image
Vídeo	Grok Imagine (6s, 720p)	Grok · Seedance · Veo · Sora
Música	MiniMax Music	MiniMax · CassetteAI
Voz	ElevenLabs Multilingual v2	ElevenLabs · MiniMax

O catálogo é ao vivo — navegue pelos modelos atuais, no que cada um é melhor, suas opções e preços indicativos com distribea models image|video|music|voice (grátis), ou list_models / list_video_models / list_music_models / list_voice_models via MCP.

Referência de comandos

Comando	Finalidade
distribea login [key]	Conectar — abre seu navegador; ou passe uma chave dmcp_… diretamente
distribea whoami · logout	Verificar / esquecer a sessão salva
distribea image "<subject>"	Uma imagem para download (png/jpg)
distribea video "<subject>"	Um vídeo para download (mp4)
distribea music "<style>"	Uma faixa para download (mp3)
distribea voice "<text>"	Uma narração para download (mp3)
distribea page [path]	Preencher uma página (ou o projeto todo) — espaços reservados → imagens alinhadas à marca
distribea blog "<article>"	Capa de artigo (16:9 + texto alternativo)
distribea models [type]	Navegar pelo catálogo ao vivo: image · video · music · voice
distribea call <tool> --k v	Chamar qualquer ferramenta MCP avançada diretamente (veja Ferramentas MCP)

Execute distribea help para a referência completa.

Flags

Flag	Finalidade
--model <id>	Escolher um modelo específico (veja distribea models)
--ref <file>	Imagem de referência — imagem para imagem / imagem para vídeo (repita para várias)
--format <r>	16:9 (paisagem) · 9:16 (retrato) · 1:1 (quadrado)
--portrait · --landscape · --square	Atalhos de orientação
--lang <code>	Idioma da voz (ex.: en, fr)
--out <dir>	Onde baixar o arquivo
--jpg	Imagem como jpg em vez de png
--dry-run	Somente cotação (0 créditos) — mostra o preço, não gera nada

Ferramentas MCP

Quando usado como servidor MCP, o mesmo mecanismo expõe estas ferramentas ao seu agente. O agente escolhe a certa para o trabalho; você apenas descreve o que precisa.

Ferramenta	O que faz
make_images ⭐	Preenche todos os espaços reservados/estoque de uma página (ou do projeto inteiro) com imagens alinhadas à marca, em paralelo; ou re-marca imagens existentes no lugar (rebrand: true)
bring_alive	Dá vida a um site existente: adiciona imagens onde seções não têm nenhuma e substitui fotos de estoque/antigas alinhadas à marca (proposta gratuita primeiro, reversível)
generate_image	Uma imagem alinhada à marca (alterna automaticamente para o modo selfie UGC para avatares de avaliação)
generate_with_model	Imagem independente com um modelo + configurações escolhidos, baixada como png/jpg nativo
generate_video	Vídeo independente com um modelo escolhido, baixado como mp4 nativo
generate_music	Faixa de música independente, baixada como mp3
generate_voice	Narração independente (texto para fala), baixada como mp3
list_models · list_video_models · list_music_models · list_voice_models	Navegue pelo catálogo (ids, pontos fortes, opções, preços indicativos) antes de gerar (gratuito)
edit_image	Retocar, refazer, remover fundo, ampliar ×4, estender
blog_cover	Gera uma imagem de capa alinhada à marca para um artigo de blog
site_style	Bloqueia, refina ou ancora a identidade visual do site
brand_pack	Logotipo, pacote de favicons e og:image em uma única chamada
create_reference	Bloqueia um personagem recorrente (foto real suportada) ou produto
finish_images	Corrige textos ALT ausentes e converte imagens pesadas para WebP (gratuito)
pack_status	Estilo atual, personagens, créditos
list_projects · link_project · forget_project	Salva, reconecta ou apaga a memória de marca de um projeto (gratuito)

Como funciona

1. Você dá um assunto — um comando CLI, ou seu agente chama uma ferramenta enquanto constrói.
2. O diretor de arte expande em um prompt completo e alinhado à marca usando seu estilo bloqueado — para que você nunca precise escrever o "como" manualmente.
3. O modelo mais adequado gera o ativo (ou aquele que você nomeou com --model).
4. Você recebe um arquivo final — baixado para uma pasta organizada, ou aplicado na sua página como WebP otimizado com texto ALT de SEO, com os originais mantidos em segurança.

Cada lote é cotado em créditos antes de ser executado; --dry-run (CLI) ou dry_run (MCP) pré-visualiza o preço e não gera nada. O conector roda localmente e não guarda segredos; sua memória de marca, ativos gerados e cobrança ficam no mecanismo hospedado Distribea.

Cobrança & custo

• A geração é cobrada em créditos no seu plano Distribea; cada lote é cotado em créditos antes de começar — use --dry-run (CLI) ou dry_run (MCP) para pré-visualizar o preço primeiro.
• Vídeo, música e voz exigem um plano pago e demoram mais para renderizar. Se uma chamada disser que ainda está renderizando, execute novamente com as mesmas configurações para buscá-la — você nunca é cobrado duas vezes.
• Uma chamada page veste uma página; o trabalho está então concluído. A Distribea não regenera ou "melhora" ativos por conta própria — retoque apenas quando você pedir.

Privacidade & segurança

Este conector local contém nenhuma chave de API e nenhum segredo. Para gerar um ativo, ele envia ao mecanismo hospedado Distribea apenas o necessário para a solicitação:

• O que é enviado: seu briefing (o assunto que você pede), um pequeno trecho de texto da página em que está trabalhando (para inferir o estilo e o contexto do site), um identificador de projeto com hash e qualquer arquivo que você explicitamente pedir para editar. Seus outros arquivos de projeto permanecem na sua máquina — eles nunca são lidos ou enviados.
• O que é armazenado, vinculado à sua conta: seu estilo visual bloqueado, personagens/produtos/avatares recorrentes, os ativos gerados para você (hospedados no CDN da Distribea) e seu uso de créditos/cobrança.
• Terceiros: os ativos são produzidos por meio dos provedores de IA hospedados da Distribea exclusivamente para atender à sua solicitação. Seus dados nunca são vendidos.
• Autenticação: as chamadas são autenticadas com sua chave pessoal (dmcp_…), emitida e revogável em distribea.com/account/mcp.
• Retenção & contato: os dados são mantidos durante a vida da sua conta; política completa e contato em distribea.com/legal/privacy-policy.

FAQ

O que é Distribea MCP? Um kit de ferramentas de mídia de IA alinhado à marca que gera imagens, vídeo, música e voz a partir de prompts em linguagem natural, disponível como CLI, servidor MCP e Skill do Claude. Ele entrega ativos prontos para produção (WebP + texto ALT de SEO) pelo preço regular do site.

Com quais ferramentas de codificação de IA ele funciona? Claude Code, Cursor, Windsurf, Replit e GitHub Copilot — qualquer coisa que fale MCP. Também roda como CLI simples em qualquer terminal.

Preciso de uma chave de API? Não. distribea login faz login pelo navegador — nada para colar. Para uma configuração MCP/hospedada, você usa uma chave pessoal dmcp_…, emitida e revogável na sua conta.

É gratuito? O conector é gratuito e não armazena segredos. A geração é cobrada em créditos no seu plano Distribea; contas gratuitas e de teste ganham algumas imagens de presente para experimentar.

Pode gerar vídeo, música e voz — ou apenas imagens? Todos os quatro: imagem, vídeo, música e voz, por meio de um único conector.

Como é diferente de um modelo de imagem bruto ou de um MCP de imagem genérico? Um diretor de arte integrado escreve o prompt a partir do seu assunto de uma linha, sua marca é bloqueada uma vez e aplicada em todos os lugares, rostos e produtos permanecem idênticos entre as tomadas, e uma única chamada pode preencher uma página inteira — aplicada no seu código como WebP com texto ALT de SEO.

Pode usar minhas próprias fotos? Sim. Passe --ref para imagem-para-imagem ou imagem-para-vídeo, e bloqueie uma pessoa ou produto para que o mesmo rosto/objeto apareça em cada cena enquanto o cenário muda.

Vai modificar meu código ou arquivos? Apenas os arquivos que você apontar. distribea page preenche espaços reservados e os aplica no seu markup; ao re-marcar imagens existentes, mantém os originais como *.original. Seus outros arquivos nunca são lidos ou enviados.

Quais formatos e proporções ele produz? Ativos baixados são png/jpg nativos (imagem), mp4 (vídeo), mp3 (música/voz); imagens colocadas em uma página saem como WebP otimizado. Orientações: 16:9, 9:16, 1:1.

Como vejo o preço antes de gerar? Adicione --dry-run (CLI) ou dry_run (MCP). Ele cota o custo exato em créditos e não gera nada (0 créditos).

Uma chamada diz que ainda está renderizando — serei cobrado duas vezes? Não. Vídeo, música e voz demoram mais; execute novamente o mesmo comando exato para buscar o resultado. Você nunca é cobrado duas vezes.

Quais modelos ele usa? Padrões fortes alinhados à marca por tipo de mídia (por exemplo, Nano Banana Pro para imagens, Grok Imagine para vídeo, MiniMax para música, ElevenLabs para voz), com um catálogo ao vivo que você pode navegar e substituir com --model.

Solução de problemas

No Distribea key / Not authenticated — execute distribea login (ou defina DISTRIBEA_MCP_KEY para uma configuração MCP/hospedada).

Unknown model "<name>" — execute distribea models image|video|music|voice para o catálogo atual.

Uma chamada diz que ainda está renderizando — vídeo/música/voz demoram mais; execute novamente o mesmo comando exato para buscar o resultado. Você nunca é cobrado duas vezes.

Atualização

npm install -g distribea-mcp@latest

O servidor MCP puxa @latest automaticamente por meio de npx, para que as configurações do agente permaneçam atualizadas por conta própria.

Suporte

Bugs e solicitações de recursos: github.com/Distribea/distribea-mcp/issues. Chave e documentação: distribea.com/account/mcp.

Licença

MIT