Claude Code escribe tus páginas, pero no puede dibujar sus imágenes. Este artículo explica cómo registrar un servidor MCP de generación de imágenes, elegir el ámbito adecuado, comparar los servidores más usados y conectar PicassoIA para imágenes y video, con soluciones a los errores habituales.
Claude Code puede crear una página de inicio en minutos, pero no puede dibujar la imagen principal. Pídele un banner, una maqueta de producto o un conjunto de miniaturas para el blog y obtendrás código SVG, una ruta de marcador de posición o un educado «no puedo generar imágenes». Un servidor MCP de generación de imágenes cierra esa brecha. Una vez registrado, Claude Code llama a un modelo de imagen como si fuera una herramienta, guarda el archivo dentro de tu repositorio y lo integra en el HTML o en el markdown que ya está editando, todo en una sola sesión.
Este artículo muestra cómo se conectan las piezas, los comandos exactos para registrar un servidor, una comparativa lado a lado de las opciones que la gente realmente usa y cómo conectar el conector de PicassoIA para imágenes y video. Los comandos siguen la documentación actual de Claude Code. Lo que no pude confirmar, como la URL de un servidor privado, aparece como marcador de posición en lugar de una suposición.
Claude Code trabaja en tu terminal, lee tus archivos, ejecuta comandos y edita código. Ese ciclo es rápido hasta que llega la primera etiqueta <img>. Entonces sales de la sesión, abres un generador aparte, descargas un archivo, lo renombras, lo colocas en la carpeta correcta y pegas la ruta de vuelta. Cada salto rompe el flujo, y el prompt que escribiste nunca ve la página para la que estaba pensado.
MCP, el Model Context Protocol, es un estándar abierto que permite a un cliente de IA llamar a herramientas externas. Un servidor de imágenes expone una o más herramientas, normalmente algo como generate_image, y Claude Code las lista con un nombre predecible: mcp__<server-name>__<tool-name>. Un servidor llamado image-gen con una herramienta generate_image aparece como mcp__image-gen__generate_image.
Con eso en marcha, una sola petición hace todo el trabajo:
💡 Consejo: Mantén el nombre del servidor corto y en minúsculas. Aparecerá en cada llamada a herramienta y en cada solicitud de permiso, y
image-gense lee mejor que un nombre largo de producto.
Intervienen tres partes, y confundirlas causa la mayoría de los problemas de configuración.
| Parte | Qué es | Ejemplo |
|---|---|---|
| Cliente | La aplicación que llama a las herramientas | Claude Code |
| Servidor | Un proceso o endpoint alojado que habla MCP | mcp-image, un conector de PicassoIA |
| Proveedor | La plataforma que ejecuta el modelo de imagen | OpenAI, Google, Replicate, PicassoIA |
El servidor es el traductor. Acepta una llamada a herramienta de Claude Code, la convierte en una petición que el proveedor acepta y devuelve el resultado. Claude Code admite cuatro transportes: stdio, http, sse y ws. En la práctica eliges entre dos. stdio inicia un proceso local en tu equipo, normalmente a través de npx. http apunta a una URL remota que mantiene otra persona.
Los servidores gestionan la salida de dos maneras, y la diferencia importa. Algunos guardan el archivo en disco y devuelven la ruta. mcp-image escribe en una carpeta que tú defines, y create-image-mcp devuelve metadatos del archivo en lugar de datos base64. Otros devuelven una URL o datos de imagen en línea.
La documentación de Claude Code indica que las imágenes en los resultados de herramientas cuentan para el límite de MAX_MCP_OUTPUT_TOKENS. Aparece una advertencia a los 10.000 tokens y el máximo predeterminado es 25.000. Un servidor que devuelve una ruta corta o una URL se queda muy por debajo de ese límite. Uno que devuelve imágenes grandes en línea puede alcanzarlo muy rápido.
claude --version.claude mcp add.claude mcp list.Para un servidor stdio local, la estructura es:
claude mcp add --transport stdio --env <PROVIDER_VARIABLE>=<your-credential> --env IMAGE_OUTPUT_DIR=/absolute/path/to/public/images image-gen -- npx -y mcp-image
Todo lo que va antes de -- pertenece a Claude Code. Todo lo que va después se envía al servidor sin cambios. Si olvidas el --, la CLI intenta leer las opciones de tu servidor como propias. El nombre exacto de la variable viene del README del servidor, porque cada proveedor usa la suya.
Para un servidor alojado, cambia el transporte a http:
claude mcp add --transport http image-gen <server-url> --header "Authorization: Bearer <your-credential>"
⚠️ Usuarios de Windows: En Windows nativo, fuera de WSL, los servidores iniciados con
npxnecesitan un envoltorio:claude mcp add --transport stdio image-gen -- cmd /c npx -y mcp-image. Sin él, el servidor puede no arrancar.
| Ámbito | Se guarda en | Quién lo ve | Úsalo para |
|---|---|---|---|
local (predeterminado) | ~/.claude.json, dentro de tu proyecto | Solo tú, un proyecto | Probar un servidor nuevo |
project | .mcp.json en la raíz del repositorio | Todos los que clonen el repositorio | Herramientas estándar del equipo |
user | ~/.claude.json, nivel superior | Solo tú, en todos los proyectos | Herramientas personales |
Añade --scope project o --scope user al comando. Cuando el mismo nombre existe en varios ámbitos, local tiene prioridad sobre proyecto, y proyecto sobre usuario.
El ámbito de proyecto encaja bien con el trabajo de imágenes porque todo el equipo recibe la misma configuración. Eso sí, no incluyas credenciales en el repositorio. .mcp.json admite expansión de ${VAR} en command, args, env, url y headers, así que el archivo contiene una referencia y cada desarrollador aporta el valor desde su propia shell:
{
"mcpServers": {
"image-gen": {
"type": "stdio",
"command": "npx",
"args": ["-y", "mcp-image"],
"env": {
"IMAGE_OUTPUT_DIR": "${IMAGE_OUTPUT_DIR}",
"<PROVIDER_VARIABLE>": "${<PROVIDER_VARIABLE>}"
}
}
}
}
Claude Code pide aprobación antes de ejecutar un servidor desde un .mcp.json de proyecto, así que la primera sesión de un compañero muestra el estado Pending approval hasta que lo acepte.
Ejecuta claude mcp list. Cada servidor tiene un estado: Connected, Failed to connect, Needs authentication o Pending approval. claude mcp get image-gen muestra los detalles de un solo servidor. Dentro de una sesión, /mcp abre el mismo panel, y /mcp reconnect all reintenta lo que haya fallado.
Luego prueba con una petición pequeña: «Genera una imagen 16:9 de una taza de cerámica sobre un escritorio de madera y guárdala en public/images/test.jpg.» Si la llamada a la herramienta aparece como mcp__image-gen__generate_image y el archivo se ve en la carpeta, el servidor funciona.
La tabla siguiente procede del listado de cada proyecto, así que revisa el README para ver las opciones actuales antes de instalar. No he medido la calidad de imagen de cada uno, porque depende mucho más del modelo que hay detrás del servidor que del propio servidor.
| Servidor | Modelos detrás | Instalación | Salida | Mejor para |
|---|---|---|---|---|
mcp-image | Gemini (predeterminado), OpenAI, BytePlus Seedream | npx -y mcp-image | Guardado en IMAGE_OUTPUT_DIR | Un servidor, tres proveedores |
create-image-mcp | OpenAI GPT Image | npm install -g @gpriday/create-image-mcp | Guardado en disco, devuelve la ruta | Usuarios de OpenAI que necesitan máscaras e inpainting |
| Servidores comunitarios de Replicate | Modelos alojados en Replicate | Paquete de Python desde PyPI | Varía según el servidor | Amplia elección de modelos, trabajos por lotes |
| Servidores comunitarios de FLUX | Modelos FLUX | Script local de Python | Varía según el servidor | Configuraciones autogestionadas |
| Conector de PicassoIA | Modelos de imagen y video de PicassoIA | Conector o URL http | URL de resultados tras el sondeo | Imágenes y video en un solo lugar |
mcp-image expone una sola herramienta generate_image que gestiona la conversión de texto a imagen y la edición a partir de una imagen de entrada. Ofrece preajustes: rápido, equilibrado y de calidad, y relaciones de aspecto de hasta 21:9. Configuras una sola credencial para el proveedor que elijas, más una carpeta de salida absoluta.
create-image-mcp es solo para OpenAI. Su herramienta create_image admite tamaños de hasta 4K, ajustes de calidad, transparencia, varias variaciones por llamada y máscaras para inpainting. Guarda en disco y responde con una ruta, lo que mantiene bajo el costo en tokens.
Servidores comunitarios de Replicate, como mcp-server-replicate, exponen conversión de texto a imagen, de imagen a imagen y edición con cualquier modelo que aloje Replicate, y uno de ellos procesa hasta 5 imágenes a la vez. Elige esta vía cuando quieras cambiar de modelo a menudo.
La contrapartida de todos los servidores locales es el mantenimiento. Gestionas las versiones de Node o Python, pagas directamente al proveedor y actualizas el paquete tú mismo.
Un servidor alojado elimina el paso de instalación. Añades una URL y una credencial, y el proveedor se encarga de lo demás. Claude Code reintenta una conexión remota caída hasta cinco veces con retrasos crecientes, así que las caídas breves se recuperan sin tu ayuda. El costo es depender del tiempo de actividad y de las normas de plan de otra persona.
Claude Code también carga conectores de tu cuenta de claude.ai cuando inicias sesión con ella. Tienen la prioridad más baja, por debajo de los servidores locales, de proyecto y de usuario, y al definir ENABLE_CLAUDEAI_MCP_SERVERS=false se desactivan.
PicassoIA te ofrece generación de imágenes, edición y video tras un solo conector, lo que encaja con proyectos que necesitan una imagen fija y un clip corto que combine con ella.
El conector de PicassoIA ofrece nueve herramientas: generate_image, edit_image, generate_video_picassoia, generate_video_seedance, get_generation, list_generations, list_models, get_account y cancel_generation.
La generación es asíncrona. Una llamada de generación devuelve un predict_id en cuanto una GPU acepta el trabajo, y get_generation informa del estado hasta que aparece succeeded o failed. Claude Code ejecuta ese bucle de consultas por ti en cuanto pides el resultado.
La API para desarrolladores que hay detrás sigue un diseño al estilo de Replicate. La URL base es https://api.picassoia.com/v1, la autenticación es un secreto Bearer que empieza por pia_sk_, y los endpoints principales son POST /v1/models/{owner}/{name}/predictions y GET /v1/predictions/{id}. Ten en cuenta estos límites:
💡 Revisa primero tu plan. PicassoIA indica el acceso a la API y a MCP en su página de precios, y los detalles pueden variar entre planes. Confirma que tu plan lo incluye antes de montar un flujo de trabajo sobre ello.
| Modelo | Úsalo para |
|---|---|
| PicassoIA Image | Trabajo diario de texto a imagen |
| PicassoIA Image Editor Pro | Ediciones y retoques sobre una imagen existente |
| PicassoIA Video | Clips cortos a partir de texto o de una imagen fija |
| Seedance 2.5 Lite | Video con audio, indicado para clips de hasta 10 segundos |
El catálogo más amplio de PicassoIA incluye muchos más modelos de imagen, como GPT Image 2, Seedream 5 Lite, Flux 2 Pro y Nano Banana 2. Prueba primero un prompt en la aplicación web, elige el estilo que te guste y luego pide a Claude Code que lo reproduzca.
Para la parte de texto del trabajo, el mismo catálogo incluye Claude Sonnet 5 y Claude Opus 4.7, útiles para redactar variaciones de prompt antes de pegarlas en una sesión.
Una imagen fija y un clip corto suelen ir juntos, como una foto principal y un banner en bucle. Pide a Claude Code que genere la imagen fija con PicassoIA Image y luego pasa el resultado a una herramienta de video como fotograma inicial. Ejecuta un video a la vez, porque cada trabajo ocupa una de tus cinco plazas simultáneas.
http con la URL de la página de conexiones MCP de tu cuenta en picassoia.com/en/mcp/accounts. PicassoIA no publica esa URL en sus páginas públicas, así que cópiala desde tu cuenta.claude mcp list, o escribe /mcp en una sesión, y confirma que PicassoIA aparece como conectado.list_models.public/images/hero.jpg.»get_generation, luego descarga la URL del resultado en tu carpeta y actualiza el markup.edit_image con PicassoIA Image Editor Pro para cambios de tono y detalle.Los prompts de imagen dentro de Claude Code tienen una ventaja frente a un formulario web: el agente puede ver tu archivo. Aprovéchala. Describe el trabajo que debe hacer la imagen, no solo su contenido, y nombra la ruta del archivo y el tamaño para que nada requiera una segunda ronda.
| Petición débil | Petición sólida |
|---|---|
| "Haz una imagen de cabecera bonita" | "Cabecera 16:9 para la página de precios, una taza de cerámica sobre un escritorio de nogal, luz de ventana desde la izquierda, sin texto" |
| "Añade algunas fotos" | "Genera 3 imágenes, una por cada encabezado de sección en features.html, y guárdalas en public/images/" |
| "Arregla la imagen" | "Edita hero.jpg: tonos más cálidos, elimina el cable de la esquina inferior izquierda" |
Tres hábitos ahorran más tiempo:
CLAUDE.md de tu proyecto para que cada sesión empiece con los mismos valores predeterminados.## Images
- Generate images with the image-gen server, 16:9 unless the layout says otherwise
- Save to public/images/ with lowercase hyphenated names
- Write one-sentence alt text that describes the scene
- Photographic style, natural light, no text inside the image
💡 Consejo: Indica la carpeta de salida en
CLAUDE.md, no en cada prompt. Esa única línea evita que los archivos acaben en la raíz del repositorio.
Ejecuta el comando del servidor a mano en una terminal normal. Una instalación de Node que falta, un error tipográfico en el nombre del paquete o una variable de entorno sin definir se verán de inmediato. Después, comprueba que -- esté entre las opciones de Claude y el comando del servidor. En Windows, añade el envoltorio cmd /c que vimos antes. Si el servidor solo tarda en arrancar, aumenta el límite de inicio, por ejemplo MCP_TIMEOUT=10000 claude, que se mide en milisegundos. Luego ejecuta /mcp reconnect all.
Si un resultado de herramienta activa la advertencia de 10.000 tokens, es probable que el servidor esté devolviendo datos de imagen en línea. Cambia a un servidor que guarde en disco o devuelva una URL. Subir el límite con MAX_MCP_OUTPUT_TOKENS=50000 claude funciona como último recurso, pero consume contexto que preferirías reservar para el código.
Claude Code pasa a una tarea en segundo plano las llamadas a herramientas que tardan más de dos minutos, lo que puedes seguir en /tasks. Con un conector asíncrono, un trabajo lento suele deberse a una cola llena. Pedir doce imágenes a la vez con una cuenta limitada a cinco predicciones simultáneas significa que siete esperan. Pide cinco cada vez y usa cancel_generation para cancelar un trabajo que ya no necesites.
La configuración lleva unos diez minutos: un comando, una elección de ámbito y un prompt de prueba. Después, cada página que construya Claude Code puede incluir sus propias fotografías en lugar de cajas de marcador de posición.
Empieza poco a poco. Prueba un prompt en PicassoIA Image, refina un resultado con PicassoIA Image Editor Pro y luego anima tu favorito con PicassoIA Video. Cuando el estilo sea el adecuado, pasa ese mismo prompt a Claude Code y deja que ejecute el proceso dentro de tu proyecto. Explora la lista completa de modelos en picassoia.com/en/all-models y crea tus propias imágenes con Picasso IA hoy.
Elige tu idioma
