Conecta Claude al servidor MCP alojado de Replicate y usa Flux 2 para generar imágenes y Flux Kontext para editarlas sin salir del chat. Pasos de configuración para Claude.ai, Claude Desktop y Claude Code, una tabla comparativa de modelos, prompts que funcionan y los errores que desperdician créditos.
Si alguna vez has copiado un prompt de Claude, lo has pegado en otra herramienta de imágenes, has descargado el resultado y has vuelto al chat para pedir un ajuste, conoces la molestia. El chat sabe lo que quieres. El modelo de imágenes vive en otra pestaña. Una configuración del servidor MCP de Flux cierra esa brecha: Claude escribe el prompt, llama al modelo en Replicate y devuelve la URL de la imagen terminada dentro de la misma conversación.
Primero una aclaración, porque los resultados de búsqueda la confunden. No existe un producto independiente llamado "el servidor MCP de Flux". Lo que la gente quiere decir es el servidor MCP alojado oficial de Replicate, que abre la biblioteca de modelos de Replicate a Claude, combinado con los modelos de Black Forest Labs que se ejecutan allí: la familia Flux 2 para generar imágenes y la familia Flux Kontext para editarlas. Este artículo muestra cómo conectar ambos, qué modelo usar para cada tarea y los prompts que funcionan bien en la práctica.
Replicate ejecuta un servidor MCP alojado en https://mcp.replicate.com/sse. Su página de configuración indica que permite a aplicaciones como Claude, Cursor, Codex, Gemini y VS Code acceder a la API HTTP de Replicate, para que puedan encontrar, comparar y ejecutar modelos. Las herramientas que enumera incluyen search_models, create_predictions y list_hardware. En términos sencillos, Claude puede buscar en el catálogo, leer qué datos de entrada acepta un modelo y lanzar una predicción con tu prompt.
Flux es solo una parte de ese catálogo. Black Forest Labs publica sus modelos en Replicate, así que pedir a Claude un modelo Flux usa el mismo mecanismo que pedir cualquier otro modelo de imágenes. Eso es útil: los hábitos que adquieres aquí se trasladan a cualquier otro modelo de la plataforma.
Puedes llamar a Replicate desde un script de Python o de Node, y mucha gente lo hace. La vía MCP se justifica en algunas situaciones:
La contrapartida son el costo y el control. Cada ejecución se factura a tu cuenta de Replicate, y Claude decide cuántas llamadas hacer, a menos que se lo indiques. Más sobre eso en la sección de errores.
Empieza por iniciar sesión en Replicate y crear un token de API desde la configuración de tu cuenta. Trátalo como una contraseña. El token se factura a tu cuenta, así que nunca lo pegues en un prompt ni lo subas a un repositorio. Los flujos de conexión que aparecen abajo lo piden en un campo específico.
claude.ai/settings/connectors.https://mcp.replicate.com/sse.
Si trabajas en una terminal, un comando registra el servidor para tu cuenta de usuario:
claude mcp add replicate https://mcp.replicate.com/sse --transport sse --scope user
--scope user hace que el servidor esté disponible en todos los proyectos, en lugar de solo en la carpeta donde ejecutaste el comando. Te autenticas con el mismo token de API de Replicate.
Otros clientes también funcionan, con una conexión ligeramente distinta:
| Cliente | Cómo se conecta |
|---|---|
| Cursor | Edita ~/.cursor/mcp.json con una entrada npx -y mcp-remote@latest |
| Windsurf | Edita ~/.codeium/windsurf/mcp_config.json con el mismo tipo de entrada npx |
| Codex CLI | Ejecuta codex mcp add replicate y luego abre /mcp dentro de codex |
| Gemini CLI | Añade la URL del servidor a ~/.gemini/settings.json y luego ejecuta /mcp auth replicate |
En Cursor y Windsurf, copia el bloque JSON exacto de la página MCP de Replicate en lugar de reescribirlo de memoria. Un corchete mal colocado y el servidor no se carga, sin ningún aviso.
Abre un chat nuevo y pregunta: "Busca black-forest-labs/flux-2-pro en Replicate y enumera los datos de entrada que acepta." Si la conexión está activa, Claude llama a la herramienta de búsqueda e informa de campos como prompt, input_images, aspect_ratio, resolution, output_format, seed y safety_tolerance. Si Claude dice que no tiene herramientas para eso, reinicia el cliente y confirma que el conector aparece como conectado.
La página de Black Forest Labs en Replicate enumera una larga serie de modelos Flux 2 y Kontext. No necesitas todos. Esta tabla incluye los que vale la pena conocer, con cada descripción tomada del propio texto de Replicate.
| Modelo | Lo que dice Replicate | Úsalo cuando |
|---|---|---|
| Flux 2 Max | El modelo de imagen de mayor fidelidad de Black Forest Labs | La imagen es el entregable final |
| Flux 2 Flex | Generación y edición de máxima calidad, con hasta diez imágenes de referencia | Mezclas muchas referencias |
| Flux 2 Pro | Generación y edición de alta calidad, con hasta ocho imágenes de referencia | Quieres una opción predeterminada sólida |
| Flux 2 Dev | Generación y edición de calidad con soporte de imágenes de referencia | Borradores habituales con referencias |
| Flux 2 Klein 4B | Destilado de 4 pasos, inferencia en menos de un segundo | Necesitas muchos borradores rápidos |
| Flux Kontext Pro | Edición basada en texto con excelente seguimiento del prompt | Estás cambiando una parte de una foto |
| Flux Kontext Max | Edición premium con tipografía mejorada | La edición implica letras |
| Flux Kontext Dev | Versión de pesos abiertos de Kontext | Quieres el modelo abierto |
Flux 2 para generar. Flux 2 Pro es el caballo de batalla. Crea imágenes solo a partir de un prompt de texto, o a partir de un prompt y hasta ocho imágenes de referencia que orientan el estilo, el sujeto o la composición. La salida llega hasta 4 MP, con un máximo de 2048x2048, y puedes elegir WebP, JPEG o PNG. La variante Flux 2 Klein 4B sacrifica algo de acabado a cambio de velocidad, lo que la convierte en el modelo adecuado para las primeras rondas de un prompt.
Kontext para editar. Flux Kontext Pro toma una imagen de entrada y una instrucción escrita en lenguaje sencillo. Sin máscaras ni herramientas de selección. También puede generar desde cero si dejas vacío el campo de imagen, aunque Flux 2 es la mejor primera opción para esa tarea.
Claude no necesita una sintaxis especial. Necesita el nombre del modelo, los ajustes que te importan y una descripción clara. Todo lo que sigue es un patrón, no una regla.
Una petición que suele funcionar al primer intento:
Usa Replicate para ejecutar black-forest-labs/flux-2-pro con aspect_ratio 16:9, resolution 2 MP y output_format jpg. Prompt: una tetera de cerámica sobre un paño de lino junto a una ventana, luz suave de la mañana desde la izquierda, objetivo de 85mm, profundidad de campo poco profunda, grano fino de película. Devuelve la URL de la imagen.
Nombrar el modelo elimina las conjeturas. Indicar la relación de aspecto y la resolución evita que Claude recurra a los valores por defecto, que para Flux 2 Pro significan una imagen cuadrada de 1 MP.
💡 El esquema de Flux 2 Pro indica que son posibles hasta 4 MP, pero se recomienda 2 MP o menos, y que resoluciones muy altas pueden no respetarse cuando la relación de aspecto no es 1:1. Empieza con 1 o 2 MP.
Las imágenes de referencia son el punto en el que Flux 2 supera a los modelos anteriores. El truco es referirse a ellas por número. Un prompt de la propia galería de ejemplos del modelo:
La persona de la imagen 1 está acariciando al gato de la imagen 2, el pájaro de la imagen 3 está junto a ellos.
Dale a Claude tres URL de imágenes, enuméralas en orden y usa "imagen 1", "imagen 2" e "imagen 3" en el prompt. Para una imagen de marca, incluye de tres a cinco ejemplos del estilo objetivo y describe la nueva escena en una frase.
Los prompts de edición funcionan mejor cuando indican el cambio y lo que debe permanecer igual. Este procede de la galería de Flux Kontext Pro:
Cambia el fondo por una playa manteniendo a la persona exactamente en la misma posición, escala y pose. Mantén idénticos la ubicación del sujeto, el ángulo de cámara, el encuadre y la perspectiva. Solo reemplaza el entorno que los rodea.
Las instrucciones cortas también sirven para tareas pequeñas. "Cambia el coche a azul" es un ejemplo real de la página de Flux 2 Pro, y "conviértelo en una foto" aparece en la galería de Kontext Pro. Ambas son un solo cambio, claramente indicado.
Texto en la imagen. Escribe las palabras exactas entre comillas y mantenlas cortas. La galería de Kontext Pro muestra un prompt de reemplazo puro: Reemplaza 'joy' por 'Pro'. Para letras más largas, Flux Kontext Max es el modelo que Replicate describe como de tipografía mejorada. La galería de Flux 2 Pro incluye incluso una infografía etiquetada de un monumento con medidas, así que el texto denso también es posible allí, pero revisa cada carácter antes de publicar.
Claude completará estos valores si los omites. Ajustarlos tú mismo te ahorra un intento. Los valores de abajo proceden de los esquemas de entrada de Flux 2 Pro y Flux Kontext Pro.
| Parámetro | Flux 2 Pro | Flux Kontext Pro |
|---|---|---|
aspect_ratio | Por defecto 1:1; también admite 16:9, 3:2, 4:5, 9:16 y más, además de custom | Por defecto match_input_image; 14 preajustes |
resolution | 0,5, 1 (por defecto), 2 o 4 MP | No se ofrece, sigue la entrada |
output_format | webp (por defecto), jpg o png | png (por defecto) o jpg |
output_quality | De 0 a 100, por defecto 80, se ignora en png | No se ofrece |
seed | Un valor fijo reproduce un resultado | Un valor fijo reproduce un resultado |
safety_tolerance | De 1 (estricto) a 5 (permisivo), por defecto 2 | Por defecto 2, que es además el máximo cuando se usan imágenes de entrada |
prompt_upsampling | No aparece en el esquema | Desactivado por defecto, mejora el prompt automáticamente |
Las semillas hacen comparables las ediciones. Si cambias el prompt y la semilla al mismo tiempo, no puedes saber cuál causó la diferencia. Pide a Claude que reutilice la semilla de la ejecución anterior y cambie solo la redacción. Es lo más parecido a un experimento controlado que se puede hacer en la generación de imágenes.
Deja que Claude redacte, pero lee el prompt. Claude es bueno ampliando "una tetera" hasta convertirla en una descripción de iluminación y lente. Es menos bueno recordando que querías que no hubiera texto en la imagen. Pídele que muestre el prompt final antes de lanzar la predicción, sobre todo con los modelos más grandes.
Esta secuencia encaja con una tienda pequeña o con un autónomo que construye un catálogo. Mantén cada paso en el mismo chat para que el historial lleve el registro por ti.
Cuando la tarea es "pon este producto junto a esta persona", una herramienta específica ayuda. Multi Image Kontext Max fusiona dos fotos en una sola escena, y es una opción útil cuando no necesitas toda la flexibilidad de ocho referencias.
Como todo el proceso vive en un mismo hilo, un compañero puede abrirlo, leer los prompts y repetir o ajustar cualquier paso. Compáralo con una carpeta de descargas sin nombre.
"Cambia el fondo, pon la camisa roja, añade gafas, suaviza la luz y recorta más de cerca" obliga al modelo a adivinar las prioridades. Divídelo en cinco ediciones breves y revisa cada una. Gastarás más mensajes, pero menos créditos en resultados malos.
No hay ninguna razón para gastar en Flux 2 Max con un prompt que todavía no has cerrado. Usa un modelo rápido para encontrar la idea y reserva el gasto para la versión final.
Indica a Claude cuántas generaciones puede ejecutar por petición, por ejemplo "no más de cuatro". Cada predicción se factura a tu cuenta de Replicate, y la página de cada modelo muestra su precio actual. Compruébalo antes de pedir treinta variaciones.
Mantén también el token fuera del chat. Debe estar en el campo de autenticación del conector, no en un mensaje. Si alguna vez acaba en una conversación o en una captura de pantalla, revócalo en la configuración de Replicate y crea uno nuevo.
La vía MCP de Replicate recompensa a quienes disfrutan con terminales, esquemas y registros. Si prefieres saltarte la configuración y ver primero los resultados, abre una página de modelo y escribe un prompt. Empieza con Flux 2 Pro para una imagen nueva, y luego lleva el resultado a Flux Kontext Pro y cambia una cosa: el fondo, el color de una chaqueta o la hora del día. Dos o tres rondas bastan para notar lo distintas que son las dos familias. Las páginas de los modelos también muestran prompts y entradas de ejemplo, que es una forma rápida de ver cómo interpreta cada uno las instrucciones.
La calidad del prompt decide la mayoría de los resultados, y no necesitas un conector para mejorarla. Claude Sonnet 5 está disponible en PicassoIA, así que puedes redactar allí un prompt y pegarlo directamente en la página de un modelo Flux.
Una imagen fija sólida también puede convertirse en el primer fotograma de un clip corto. Los modelos de imagen a video, como Wan 2.7 I2V, toman una foto y la animan, así que un render de Flux puede convertirse en un bucle de producto o en un avance para redes sociales sin empezar de cero. PicassoIA también tiene su propia API para desarrolladores y su conexión MCP para sus modelos de imagen y video, documentadas en picassoia.com/en/api, si quieres una sola cuenta que sirva tanto para el navegador como para tus herramientas.
Elige una escena que realmente necesites, ya sea una foto de producto, un retrato o la cabecera de un blog, y crea tu primera imagen hoy. Ejecuta el mismo prompt en un modelo rápido y en uno premium, y guarda el resultado que publicarías con gusto.
Elige tu idioma
