Distribea MCP

Distribea es un kit de medios de IA fiel a tu marca, pensado para creadores. Genera imágenes, video, música y voz a partir de instrucciones en lenguaje natural y los entrega listos para producción — WebP optimizado con texto alt para SEO, descargados para ti o integrados directamente en tu código. Un solo conector, cuatro tipos de medios, accesible de tres maneras: una CLI en tu terminal, un servidor MCP que tu agente de codificación con IA invoca mientras construye, y un Claude Skill. Define tu marca una sola vez; un director de arte con IA integrado escribe cada instrucción — tú dices qué quieres, nunca cómo representarlo. Se factura en créditos al precio normal del sitio; el conector no guarda claves API ni secretos.

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 archivo llega a una carpeta ordenada, listo para usar. Añade --dry-run a cualquier comando para ver primero el precio exacto en créditos (0 créditos, no genera nada).

---

Contenido

• Qué es Distribea
• Qué puedes crear
• Cuándo usar Distribea
• Por qué Distribea
• Instalación
• Inicio rápido
• Ejemplos y recetas
• Viste una página completa
• Rostros y productos recurrentes
• Modelos
• Referencia de comandos
• Banderas
• Herramientas MCP
• Cómo funciona
• Facturación y costos
• Privacidad y seguridad
• Preguntas frecuentes
• Solución de problemas
• Actualización
• Soporte
• Licencia

Qué es Distribea

La mayoría de las herramientas de medios con IA te dan un modelo en bruto y una caja de instrucciones vacía, en una pestaña del navegador, una imagen a la vez. Distribea es la capa superior — y vive donde tú construyes.

• Un conector, cuatro tipos de medios. Imagen, video, música y voz con una sola instalación. La mayoría de las herramientas se quedan en imágenes.
• Tres formas de acceso, un mismo motor. Ejecútalo desde tu shell (distribea …), intégralo en tu agente de IA como servidor MCP (Claude Code, Cursor, Windsurf, Replit, Copilot), o añade el Claude Skill para que el modelo lo use por sí solo.
• Fiel a tu marca por defecto. Fija tu marca una vez y cada recurso coincidirá con ella. El director de arte convierte un tema de una línea en una instrucción completa — tú nunca escribes el "cómo".
• Listo para producción. Las imágenes salen como WebP optimizado con texto alt adecuado para SEO, descargadas para ti o integradas directamente en tu página.

El trabajo pesado — dirección de arte, generación, facturación — se ejecuta en el motor alojado de Distribea. Este paquete es solo el conector local: escanea y modifica tus archivos, no guarda claves API ni secretos, y factura la generación en créditos de tu plan Distribea al precio normal del sitio.

Qué puedes crear

Medio	Comando	Qué obtienes
🖼️ Imagen	distribea image "<subject>"	Una imagen fiel a tu marca (png/jpg), en cualquier proporción. Retratos, imágenes principales, fotos de producto, ilustraciones, avatares de reseñas.
🎬 Video	distribea video "<subject>"	Un clip corto (mp4) — texto a video, o imagen a video desde una foto de referencia.
🎵 Música	distribea music "<style>"	Una pista lista para uso comercial (mp3) — intros, música de fondo, bases para anuncios.
🎙️ Voz	distribea voice "<text>"	Una locución (mp3), texto a voz en muchos idiomas.
📄 Una página completa	distribea page [path]	Cada marcador <img> en una página (o en todo el proyecto) se rellena fiel a tu marca, en paralelo, integrado en tu código.
✍️ Portada de blog	distribea blog "<article>"	Una imagen de portada 16:9 que ilustra el tema real del artículo, con tu estilo, + texto alt.

Cuándo usar Distribea

Recurre a Distribea siempre que un proyecto necesite imágenes o audio y de otro modo usarías fotos de stock, marcadores grises, secciones solo con degradados CSS o una foto pegada en bruto. Trabajos típicos:

• Estás creando una página de aterrizaje y necesitas imágenes reales y fieles a tu marca — no de stock.
• Necesitas fotos de producto para e-commerce que se mantengan consistentes en todo el catálogo.
• Quieres una imagen principal, retratos de equipo o avatares de testimonios con rostros creíbles.
• Estás escribiendo una entrada de blog y necesitas una portada acorde al artículo y a tu estilo.
• Necesitas un clip de video corto (texto a video o imagen a video) para una imagen principal o un anuncio.
• Necesitas música de fondo para una intro, demo o anuncio.
• Necesitas una locución para una demo, tutorial o narración de video.
• Tienes un sitio lleno de fotos de stock baratas o fuera de marca y quieres renombrarlas en su lugar.
• Estás programando con intuición junto a un agente de IA y quieres que complete los medios por sí solo mientras construye.

Por qué Distribea

	CLI/MCP de modelo en bruto	MCP de imágenes genérico	Distribea
Imagen · video · música · voz	⚠️ varía	❌ solo imagen	✅ los cuatro, un conector
Vive en tu terminal y en tu agente	⚠️ uno de ellos	⚠️ solo MCP	✅ CLI · MCP · Skill
Escribe la dirección de arte por ti	❌ tú instruyes a cada modelo	⚠️ instrucción por instrucción	✅ director de arte integrado
Fija tu marca una sola vez	❌	⚠️ por instrucción	✅ aplicada en todas partes
Mismo rostro entre escenas	❌	❌	✅ personajes recurrentes
Rellena una página completa en una llamada	❌	❌	✅ distribea page
Listo para producción (WebP + alt SEO)	❌	❌	✅ automático
Sin claves/secretos en el conector	⚠️ guarda tus claves de modelo	⚠️ varía	✅ inicio de sesión en navegador, nada que pegar

En una línea: otras herramientas te dan un modelo y una caja de instrucciones; Distribea te da recursos terminados y fieles a tu marca — en los cuatro tipos de medios que realmente necesitas — sin salir del lugar donde construyes.

Instalación

Un plan de Distribea impulsa la generación (las cuentas gratuitas/de prueba reciben un par de imágenes de regalo para probarlo). El conector en sí es gratuito y no almacena secretos.

CLI (recomendada)

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

distribea whoami confirma que estás conectado.

Servidor MCP

Pega esto en .mcp.json en la raíz de tu proyecto:

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

Obtén tu clave de dmcp_… en distribea.com/account/mcp. Si ya has ejecutado distribea login, el servidor reutiliza esa sesión y puedes omitir el bloque env por completo.

Herramienta	Dónde añadirlo
Claude Code	claude mcp add distribea-mcp -e DISTRIBEA_MCP_KEY=dmcp_… -- npx -y distribea-mcp@latest
Cursor	Settings → MCP → Add, o pega el bloque en ~/.cursor/mcp.json
Windsurf	Pégalo en ~/.codeium/windsurf/mcp_config.json
VS Code (Copilot)	Pégalo en .vscode/mcp.json
Replit	Añádelo como servidor MCP personalizado con el comando anterior

Claude Skill

El paquete incluye SKILL.md. Añádelo una vez y tu agente recurrirá a Distribea por sí solo siempre que una página necesite imágenes o audio.

npx skills add Distribea/distribea-mcp

Inicio rápido

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

El archivo llega a una carpeta ordenada, listo para usar. Eso es todo — sin modelo que elegir, sin ingeniería de instrucciones: el estilo se infiere y el director de arte escribe la instrucción. Desde aquí, cambia image por video, music o voice, o ejecuta distribea page para vestir una página completa de una vez.

Ejemplos y recetas

Cada comando acepta un tema en lenguaje natural. Añade --dry-run para previsualizar el precio primero (0 créditos, no genera nada).

Imagen fiel a tu marca

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

Video independiente (texto a video)

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

Música de fondo

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

Locución (texto a voz)

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

Foto de referencia → imagen o video (imagen a imagen / imagen a video)

Convierte una foto real en una nueva imagen fiel a tu marca o anímala. Pasa --ref una vez, o varias veces para múltiples referencias — se limita automáticamente a lo que acepta el modelo elegido.

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

Portada de blog

Lee el artículo e ilustra su tema específico, acorde a tu estilo fijado, como WebP 16:9 + texto alt.

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

Elige un modelo específico

Los valores predeterminados son sólidos; solo nombra un modelo cuando quieras uno en particular.

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

Explora el catálogo en vivo (gratis)

distribea models image      # or: video | music | voice

Viste una página completa

El flujo de trabajo de página es la superpotencia. Construye tu página con marcadores <img src="https://placehold.co/1200x600"> donde vaya cada imagen, y luego una sola llamada rellena cada espacio con imágenes que coinciden con tu marca — un aspecto consistente en todo el sitio, personajes recurrentes con el mismo rostro en cada escena, avatares UGC creíbles para secciones de reseñas.

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

Cada imagen llega lista para producción: WebP optimizado, texto alt adecuado para SEO e integrado directamente en tu código. Sin fotos de stock. Sin marcadores. Sin paso de exportación. El estilo se infiere de la propia página, así que no hay nada que configurar.

¿Ya tienes un sitio con fotos de stock baratas o fuera de marca? Renómbralas en su lugar — la primera pasada lista cada imagen reemplazable gratis, y luego aplica el nuevo aspecto sin tocar tu código (los originales se conservan como *.original).

Rostros y productos recurrentes

Una persona real (un fundador, un profesor) o un producto que debe verse idéntico en cada toma se trata como un sujeto fijado — el rostro/objeto permanece 100% idéntico, solo cambia la puesta en escena.

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

Nunca pegues una foto en bruto en la página: deja un marcador y deja que el motor vuelva a escenificar ese rostro exacto en el mundo de tu sitio. Los avatares de reseñas y testimonios salen como selfies casuales de smartphone (aspecto UGC); el mismo reseñador mantiene el mismo rostro en todo el sitio.

Modelos

La generación se ejecuta en proveedores de primer nivel, con un valor predeterminado sólido y fiel a tu marca por tipo de medio — así que rara vez necesitas nombrar uno:

Tipo	Predeterminado	Algunos de los proveedores disponibles
Imagen	Nano Banana Pro (2K)	Nano Banana Pro · Seedream · Z-Image · Grok Image
Video	Grok Imagine (6s, 720p)	Grok · Seedance · Veo · Sora
Música	MiniMax Music	MiniMax · CassetteAI
Voz	ElevenLabs Multilingual v2	ElevenLabs · MiniMax

El catálogo está en vivo — explora los modelos actuales, en qué destaca cada uno, sus opciones y precios indicativos con distribea models image|video|music|voice (gratis), o list_models / list_video_models / list_music_models / list_voice_models a través de MCP.

Referencia de comandos

Comando	Propósito
distribea login [key]	Conectar — abre tu navegador; o pasa una clave dmcp_… directamente
distribea whoami · logout	Verificar / olvidar la sesión guardada
distribea image "<subject>"	Una imagen descargable (png/jpg)
distribea video "<subject>"	Un video descargable (mp4)
distribea music "<style>"	Una pista descargable (mp3)
distribea voice "<text>"	Una locución descargable (mp3)
distribea page [path]	Rellenar una página (o todo el proyecto) — marcadores → imágenes fieles a tu marca
distribea blog "<article>"	Portada de artículo (16:9 + texto alt)
distribea models [type]	Explorar el catálogo en vivo: image · video · music · voice
distribea call <tool> --k v	Llamar directamente a cualquier herramienta MCP avanzada (ver Herramientas MCP)

Ejecuta distribea help para la referencia completa.

Banderas

Bandera	Propósito
--model <id>	Elegir un modelo específico (ver distribea models)
--ref <file>	Imagen de referencia — imagen a imagen / imagen a video (repetir para varias)
--format <r>	16:9 (horizontal) · 9:16 (vertical) · 1:1 (cuadrado)
--portrait · --landscape · --square	Atajos de orientación
--lang <code>	Idioma de la voz (p. ej. en, fr)
--out <dir>	Dónde descargar el archivo
--jpg	Imagen como jpg en lugar de png
--dry-run	Solo cotización (0 créditos) — muestra el precio, no genera nada

Herramientas MCP

Cuando se usa como servidor MCP, el mismo motor expone estas herramientas a tu agente. El agente elige la adecuada para cada tarea; tú solo describes lo que necesitas.

Herramienta	Qué hace
make_images ⭐	Rellena cada espacio reservado/slot de stock de una página (o de todo el proyecto) con imágenes acordes a la marca, en paralelo; o renombra imágenes existentes en su lugar (rebrand: true)
bring_alive	Haz que un sitio existente cobre vida: añade imágenes donde las secciones no tienen y reemplaza fotos de stock/antiguas acordes a la marca (propuesta gratuita primero, reversible)
generate_image	Una imagen acorde a la marca (cambia automáticamente al modo selfie UGC para avatares de reseñas)
generate_with_model	Imagen independiente con un modelo + ajustes elegidos, descargada como png/jpg nativo
generate_video	Video independiente con un modelo elegido, descargado como mp4 nativo
generate_music	Pista de música independiente, descargada como mp3
generate_voice	Voz en off independiente (texto a voz), descargada como mp3
list_models · list_video_models · list_music_models · list_voice_models	Explora el catálogo (ids, fortalezas, opciones, precios indicativos) antes de generar (gratis)
edit_image	Retocar, rehacer, eliminar fondo, ampliar ×4, extender
blog_cover	Genera una imagen de portada acorde a la marca para un artículo de blog
site_style	Bloquea, refina o ancla la identidad visual del sitio
brand_pack	Logo, paquete de favicons e imagen og:image en una sola llamada
create_reference	Bloquea un personaje recurrente (con foto real compatible) o producto
finish_images	Corrige textos ALT faltantes y convierte imágenes pesadas a WebP (gratis)
pack_status	Estilo actual, personajes, créditos
list_projects · link_project · forget_project	Guarda, reconecta o borra la memoria de marca de un proyecto (gratis)

Cómo funciona

1. Tú das un tema — un comando CLI, o tu agente llama a una herramienta mientras construye.
2. El director de arte lo expande en un prompt completo y acorde a la marca usando tu estilo bloqueado — así nunca escribes el "cómo" a mano.
3. El modelo más adecuado genera el activo (o el que nombraste con --model).
4. Recibes un archivo terminado — descargado en una carpeta ordenada, o integrado en tu página como WebP optimizado con texto ALT SEO, con los originales guardados de forma segura.

Cada lote se cotiza en créditos antes de ejecutarse; --dry-run (CLI) o dry_run (MCP) previsualiza el precio y no genera nada. El conector se ejecuta localmente y no guarda secretos; tu memoria de marca, activos generados y facturación viven en el motor alojado de Distribea.

Facturación y costos

• La generación se factura en créditos de tu plan Distribea; cada lote se cotiza en créditos antes de comenzar — usa --dry-run (CLI) o dry_run (MCP) para previsualizar el precio primero.
• Video, música y voz requieren un plan de pago y tardan más en renderizarse. Si una llamada dice que aún se está renderizando, ejecútala de nuevo con los mismos ajustes para recogerla — nunca se te cobra dos veces.
• Una llamada a page viste una página; el trabajo está hecho. Distribea no regenerará ni "mejorará" activos por su cuenta — solo retoca cuando lo pidas.

Privacidad y seguridad

Este conector local no contiene claves API ni secretos. Para generar un activo, envía al motor alojado de Distribea solo lo necesario para la solicitud:

• Lo que se envía: tu brief (el tema que pides), un breve extracto de texto de la página en la que se trabaja (para inferir el estilo y contexto del sitio), un identificador de proyecto con hash, y cualquier archivo que pidas explícitamente editar. Tus otros archivos del proyecto permanecen en tu máquina — nunca se leen ni se suben.
• Lo que se almacena, vinculado a tu cuenta: tu estilo visual bloqueado, personajes/productos/avatares recurrentes, los activos generados para ti (alojados en el CDN de Distribea) y tu uso de créditos/facturación.
• Terceros: los activos se producen a través de los proveedores de IA alojados de Distribea únicamente para cumplir tu solicitud. Tus datos nunca se venden.
• Autenticación: las llamadas se autentican con tu clave personal (dmcp_…), emitida y revocable en distribea.com/account/mcp.
• Retención y contacto: los datos se conservan durante la vida de tu cuenta; política completa y contacto en distribea.com/legal/privacy-policy.

Preguntas frecuentes

¿Qué es Distribea MCP? Un kit de herramientas de medios con IA acorde a la marca que genera imágenes, video, música y voz a partir de prompts en lenguaje natural, disponible como CLI, servidor MCP y Skill de Claude. Entrega activos listos para producción (WebP + texto ALT SEO) al precio regular del sitio.

¿Con qué herramientas de codificación de IA funciona? Claude Code, Cursor, Windsurf, Replit y GitHub Copilot — cualquier cosa que hable MCP. También se ejecuta como CLI simple en cualquier terminal.

¿Necesito una clave API? No. distribea login te inicia sesión a través del navegador — nada que pegar. Para una configuración MCP/alojada usas una clave personal dmcp_…, emitida y revocable en tu cuenta.

¿Es gratis? El conector es gratuito y no almacena secretos. La generación se factura en créditos de tu plan Distribea; las cuentas gratuitas y de prueba reciben un par de imágenes de regalo para probarlo.

¿Puede generar video, música y voz — o solo imágenes? Los cuatro: imagen, video, música y voz, a través de un solo conector.

¿En qué se diferencia de un modelo de imagen crudo o un MCP de imagen genérico? Un director de arte integrado escribe el prompt a partir de tu tema de una línea, tu marca se bloquea una vez y se aplica en todas partes, los rostros y productos se mantienen idénticos entre tomas, y una sola llamada puede llenar una página completa — integrada en tu código como WebP con texto ALT SEO.

¿Puede usar mis propias fotos? Sí. Pasa --ref para imagen a imagen o imagen a video, y bloquea una persona o producto para que el mismo rostro/objeto aparezca en cada escena mientras cambia la puesta en escena.

¿Modificará mi código o archivos? Solo los archivos a los que lo apuntes. distribea page llena los espacios reservados y los integra en tu marcado; al renombrar imágenes existentes conserva los originales como *.original. Tus otros archivos nunca se leen ni se suben.

¿Qué formatos y proporciones produce? Los activos descargados son png/jpg nativos (imagen), mp4 (video), mp3 (música/voz); las imágenes colocadas en una página salen como WebP optimizado. Orientaciones: 16:9, 9:16, 1:1.

¿Cómo veo el precio antes de generar? Añade --dry-run (CLI) o dry_run (MCP). Cotiza el costo exacto en créditos y no genera nada (0 créditos).

Una llamada dice que aún se está renderizando — ¿me cobrarán dos veces? No. Video, música y voz tardan más; vuelve a ejecutar el mismo comando exacto para recoger el resultado. Nunca se te cobra dos veces.

¿Qué modelos usa? Valores predeterminados sólidos acordes a la marca por tipo de medio (p. ej., Nano Banana Pro para imágenes, Grok Imagine para video, MiniMax para música, ElevenLabs para voz), con un catálogo en vivo que puedes explorar y anular con --model.

Solución de problemas

No Distribea key / Not authenticated — ejecuta distribea login (o configura DISTRIBEA_MCP_KEY para una configuración MCP/alojada).

Unknown model "<name>" — ejecuta distribea models image|video|music|voice para el catálogo actual.

Una llamada dice que aún se está renderizando — video/música/voz tardan más; vuelve a ejecutar el mismo comando exacto para recoger el resultado. Nunca se te cobra dos veces.

Actualización

npm install -g distribea-mcp@latest

El servidor MCP obtiene @latest automáticamente a través de npx, por lo que las configuraciones de agentes se mantienen actualizadas por sí solas.

Soporte

Errores y solicitudes de funciones: github.com/Distribea/distribea-mcp/issues. Clave y documentación: distribea.com/account/mcp.

Licencia

MIT