ai-machine-learning

Higgsfield MCP para Claude Code: Instalación en 60 Segundos (y 5 Errores Frecuentes)

Escrito por Techsy Editorial Team
Actualizado Jun 6, 2026
22 lectura
Higgsfield MCP para Claude Code: Instalación en 60 Segundos (y 5 Errores Frecuentes)

Higgsfield MCP para Claude Code: Instalación en 60 Segundos (y 5 Errores Frecuentes)

Última actualización: 6 de junio de 2026. Comando de instalación y flujo OAuth reverificados. Roster de modelos (GPT Image 2, Soul V2, Veo 3.1, Kling 3.0, Flux 2, Nano Banana Pro, Seedance 2.0) confirmado como actual. Créditos del nivel gratuito (150/mes) siguen siendo correctos.

Para usar Higgsfield MCP con Claude Code, ejecuta claude mcp add --transport http --scope user higgsfield https://mcp.higgsfield.ai/mcp en tu terminal. Claude Code gestiona la autenticación mediante OAuth en el navegador, sin claves API. El servidor expone cinco herramientas (generate_image, generate_video, create_character, get_generation_status, list_characters) a través de siete modelos. La configuración se completa en menos de 60 segundos con una conexión normal.

Higgsfield lanzó su servidor MCP alojado el 30 de abril de 2026, hace ocho días mientras escribo esto. Si tienes Claude Code instalado, puedes conectar Higgsfield MCP a tu flujo de trabajo con un solo comando, sin claves API, sin paquete npm. Al terminar este artículo tendrás el servidor instalado en todos los clientes de IA que usas habitualmente, sabrás qué modelo elegir de los siete disponibles, y tendrás la receta de prompts que usamos en techsy.io para las imágenes de cabecera del blog.

En techsy.io ya usamos los cuatro skills de agente de Higgsfield — higgsfield-generate, higgsfield-product-photoshoot, higgsfield-soul-id y higgsfield-marketplace-cards — para imágenes de portada y lifestyle, y llevamos un tiempo conectando el servidor MCP junto a ellos para generación más rica dentro de la conversación. MCP es como la ingeniería de contexto se materializa a nivel de herramientas: en vez de pegar URLs y prompts en una interfaz aparte, el modelo elige el modelo y los parámetros en el mismo chat donde estás escribiendo.

Respuesta rápida

  • Higgsfield MCP es un servidor alojado en https://mcp.higgsfield.ai/mcp que expone siete modelos de imagen y video a cualquier cliente MCP.
  • Se instala en Claude Code con un solo comando; la autenticación es OAuth, sin claves API.
  • Funciona con Claude Code, Claude Desktop, Cursor, Windsurf, Cline y OpenCode.
  • Plan gratuito: 150 créditos/mes (vigente a mayo de 2026); más allá de eso, 1 USD = 16 créditos.

Qué hace realmente Higgsfield MCP

Higgsfield MCP es un servidor Model Context Protocol (MCP) alojado en https://mcp.higgsfield.ai/mcp que permite a cualquier cliente de IA compatible con MCP (Claude Code, Claude Desktop, Cursor, Windsurf, Cline, OpenCode) invocar siete modelos de imagen y video a través de cinco herramientas, con autenticación OAuth. Sin claves API, sin npm install, sin proxy.

El servidor MCP de Higgsfield se sitúa entre tu cliente de IA y un catálogo de más de 30 modelos generativos. El endpoint alojado expone los siete a los que acudimos más a menudo: Soul V2 para consistencia de personajes, Veo 3.1 y Kling 3.0 para video, GPT Image 2 para realismo fotográfico, Flux 2 para ilustración, Nano Banana Pro para iterar rápido, y Seedance 2.0 para clips cortos. Puedes llamar a cualquiera de ellos como modelos distintos dentro de Claude Code sin salir del chat.

ModeloTipoMejor paraCréditos aprox./generación
GPT Image 2ImagenRealismo fotográfico, fotos de producto~8
Nano Banana ProImagenIteraciones rápidas y baratas~2
Soul V2ImagenConsistencia de personajes (con create_character)~10
Seedance 2.0VideoClips cortos con movimiento~30
Veo 3.1VideoClips cinematográficos de 8-15 s~60
Kling 3.0VideoMovimiento fluido, acción de personajes~50
Flux 2ImagenEstilizado, ilustrativo~6

Plan gratuito: 150 créditos/mes, vigente a mayo de 2026 y sujeto a cambios.

Las cinco herramientas que expone el servidor son toda la superficie de la API:

  • generate_image: generación de imagen en una sola llamada
  • generate_video: generación de video asíncrona, devuelve un ID de trabajo
  • create_character: entrena un Soul Character para mantener consistencia
  • get_generation_status: sondea un trabajo asíncrono
  • list_characters: lista los personajes entrenados

Eso es todo. Cinco herramientas, sin claves API, sin escopos que memorizar. Compara eso con parchear media docena de APIs de proveedores y entenderás por qué la especificación MCP ha triunfado. Para la lista canónica de modelos, la página oficial de MCP de Higgsfield es la fuente de verdad.

¿Cómo añado Higgsfield MCP a Claude Code?

Para instalar Higgsfield MCP en Claude Code, ejecuta claude mcp add --transport http --scope user higgsfield https://mcp.higgsfield.ai/mcp. Claude Code abre un navegador para OAuth en el primer uso; inicia sesión en tu cuenta de Higgsfield, vuelve al terminal y verifica con claude mcp list o el comando slash /mcp. Eso es toda la configuración de higgsfield mcp.

Este es el punto que la mayoría de los tutoriales existentes tiene mal. Antes del 30 de abril no había servidor alojado, y los autores asumían que tenías que instalar un paquete con npm y pegar un HIGGSFIELD_API_KEY en tu shell. No hace falta. El MCP alojado corre en la infraestructura de Higgsfield y se autentica mediante OAuth en tu navegador.

Aquí está el comando de instalación. Pégalo en tu terminal:

bash
claude mcp add --transport http --scope user higgsfield https://mcp.higgsfield.ai/mcp

Dos flags que vale la pena conocer. --transport http le dice a Claude Code que este es un servidor alojado basado en HTTP, no un proceso stdio local. --scope user escribe la configuración en ~/.claude/mcp.json, de modo que el servidor esté disponible en todos los proyectos que abras. Si quieres limitarlo a un solo repositorio (y que quede en el control de versiones para que el equipo lo recoja), usa --scope project en su lugar. Eso escribe en .mcp.json en la raíz del repositorio.

Verifica que funcionó:

bash
claude mcp list
# Higgsfield   http   ✔ connected

La primera vez que llames a una herramienta de Higgsfield, Claude Code lanza un callback OAuth local en el puerto 8080 y abre tu navegador. Inicia sesión en tu cuenta de Higgsfield, vuelve al terminal, y listo. Dentro de cualquier sesión de Claude Code puedes ejecutar /mcp para ver el panel. Higgsfield debería aparecer con cinco herramientas listadas.

En el M3 Pro desde el que escribo esto, la instalación más el round-trip de OAuth se completó en 47 segundos. Tu experiencia variará según la red, pero si llevas más de dos minutos, pasa directamente a la sección de Errores frecuentes al final.

Un apunte rápido: si prefieres envolver el mismo MCP dentro de un skill de Claude Code, el repositorio higgsfield-skill de robonuggets hace exactamente eso. Cubrimos ese patrón en nuestro tutorial de skills de Claude Code. También puedes automatizar alrededor de servidores MCP con hooks — por ejemplo, ejecutar automáticamente una llamada a list_characters antes de cualquier generación de imagen de cabecera. Para la sintaxis canónica de configuración, la documentación de Anthropic sobre MCP para Claude Code cubre tipos de transporte, flags de scope y flujos de re-autenticación al completo.

Llamada a la herramienta generate_image dentro de una sesión de Claude Code.
Llamada a la herramienta generate_image dentro de una sesión de Claude Code.

¿Cómo añado Higgsfield MCP a Claude Desktop?

Claude Desktop usa un archivo de configuración JSON (claude_desktop_config.json) en lugar del CLI claude mcp add. La ubicación varía según el sistema operativo. Edita el archivo, añade el bloque de higgsfield y cierra completamente Claude Desktop antes de volver a abrirlo. OAuth se ejecuta en la primera invocación de una herramienta, no al cargar la configuración.

SORuta
macOS~/Library/Application Support/Claude/claude_desktop_config.json
Windows%APPDATA%\Claude\claude_desktop_config.json
Linux~/.config/Claude/claude_desktop_config.json

Añade esto:

json
{
  "mcpServers": {
    "higgsfield": {
      "transport": {
        "type": "http",
        "url": "https://mcp.higgsfield.ai/mcp"
      }
    }
  }
}

Si Claude Desktop dice que el servidor está en la lista pero las herramientas no aparecen, es que no lo cerraste del todo. Cmd-Q en macOS, no el botón rojo del semáforo. Cerrar la ventana deja el proceso corriendo con la configuración antigua en memoria.

Configuración de Higgsfield MCP en Cursor

Para usar higgsfield mcp cursor, edita ~/.cursor/mcp.json y añade el servidor de higgsfield con transporte HTTP apuntando a https://mcp.higgsfield.ai/mcp. Reinicia Cursor; el servidor aparece en Configuración → Servidores MCP y se autentica mediante OAuth en la primera solicitud de generación. El mismo JSON también funciona como .cursor/mcp.json en la raíz del proyecto.

Cursor detecta automáticamente el transporte HTTP a partir del campo url, así que no necesitas declararlo explícitamente. Aquí está la configuración:

json
{
  "mcpServers": {
    "higgsfield": {
      "url": "https://mcp.higgsfield.ai/mcp"
    }
  }
}

Guarda el archivo, reinicia Cursor y abre Configuración → Servidores MCP. Deberías ver "higgsfield" con un punto verde. La primera vez que le pidas a Cursor "Genera una imagen de cabecera de un zorro a la hora dorada usando Higgsfield", tu navegador se abrirá para OAuth y la generación se ejecutará en cuanto inicies sesión.

Combina esto con una regla de Cursor que siempre use Higgsfield para imágenes de cabecera. Añade una regla en .cursor/rules/blog-images.mdc que mapee las peticiones de "blog hero" u "OG image" a generate_image con tu relación de aspecto predeterminada. Consejo: si guardas .cursor/mcp.json en la raíz del repositorio en lugar del archivo de scope de usuario, todo el equipo recoge el servidor cuando hace pull. Sin configuración por desarrollador, sin hilo en Slack preguntando por qué no aparece la herramienta.

Cursor mcp.json con el servidor de Higgsfield registrado.
Cursor mcp.json con el servidor de Higgsfield registrado.

¿Cómo instalo Higgsfield MCP en Windsurf o Cline?

Ambos clientes usan la forma de mcp.json de estilo VS Code, así que el mismo JSON funciona en los dos. Windsurf lee ~/.codeium/windsurf/mcp_config.json; Cline (la extensión de VS Code) usa su interfaz de configuración o .vscode/mcp.json en el workspace.

json
{
  "mcpServers": {
    "higgsfield": {
      "type": "http",
      "url": "https://mcp.higgsfield.ai/mcp"
    }
  }
}

Un consejo de Cline que vale la pena grabarse en la memoria: activa "Auto-approve safe tools" solo para list_characters y get_generation_status. No actives la aprobación automática para generate_video. Cada llamada consume 30-60 créditos, y un agente autónomo en bucle puede agotar tu plan gratuito en cinco minutos. Herramientas de lectura, sí. Herramientas de generación, no.

¿Te preguntas cómo se comparan los dos clientes en el día a día? Nuestro análisis Windsurf vs Cursor cubre las diferencias. Para Higgsfield en concreto, la experiencia es idéntica una vez que el servidor está registrado. Ambos clientes hablan el mismo protocolo de cable MCP.

¿Funciona Higgsfield MCP con OpenCode?

Sí. OpenCode (la alternativa de código abierto sst/opencode a Claude Code) habla el mismo protocolo de cable MCP. La configuración va en .opencode/mcp.json en la raíz del repositorio, o en ~/.config/opencode/mcp.json para scope de usuario. Un nombre de campo difiere del de Claude Code, así que no copies tu bloque mcpServers tal cual.

json
{
  "servers": {
    "higgsfield": {
      "transport": "http",
      "url": "https://mcp.higgsfield.ai/mcp"
    }
  }
}

Fíjate en que el campo es servers, no mcpServers. Error fácil de cometer. Si tus herramientas no aparecen en OpenCode después de añadir la configuración, casi siempre es por eso. Ejecuta opencode mcp list para verificar; es el espejo de claude mcp list. El flujo OAuth es idéntico: abre el navegador, callback, listo.

¿Cuál es la mejor forma de hacer prompts con Higgsfield a través de MCP?

La receta de prompting más fiable que hemos encontrado es MCSLA: Model, Composition, Subject, Lighting, Aesthetic (Modelo, Composición, Sujeto, Iluminación, Estética). Viene del skill de prompt cinematográfico MCSLA y convierte un vago "hazme una imagen de cabecera" en un brief que los modelos de Higgsfield pueden ejecutar realmente. Cinco campos, cinco líneas, siempre.

  1. Model (Modelo): elige la herramienta correcta primero. GPT Image 2 para realismo, Soul V2 para personajes que se repiten, Flux 2 para trabajo estilizado.
  2. Composition (Composición): encuadra el plano ("composición de cabecera gran angular, sujeto en el tercio izquierdo, espacio negativo a la derecha").
  3. Subject (Sujeto): nombra lo que está en el plano, con atributos específicos ("una taza de cerámica negra, condensación formando gotas, sobre roble envejecido").
  4. Lighting (Iluminación): direccional y cualitativa ("luz de borde cálida desde arriba a la izquierda, relleno suave, sombras azul oscuro").
  5. Aesthetic (Estética): el acabado final ("editorial de revista, grano de película 35 mm, gradación de color para marketing SaaS").

El flujo de trabajo de encadenamiento de imágenes de referencia es donde el MCP se gana su lugar. Genera la v1 y luego pídele a Claude algo como "ahora repite con más contraste y una paleta más fría." El historial del chat retiene la URL de la imagen, así que la siguiente llamada a generate_image la pasa automáticamente como referencia. Iteras dentro de la conversación en lugar de hacer round-trips por una interfaz web.

Para la consistencia de personajes con higgsfield mcp, el flujo de trabajo Soul Character es el camino:

  1. Ejecuta create_character con 3-5 imágenes de referencia.
  2. Espera entre tres y cinco minutos a que complete el entrenamiento; sondea con get_generation_status.
  3. Referencia el ID de personaje devuelto en las llamadas posteriores a generate_image.
  4. Resultado: la misma cara en toda una serie de artículos, sin deriva.

Usamos exactamente este patrón en techsy.io. El skill higgsfield-product-photoshoot más el skill higgsfield-soul-id producen las ilustraciones de miembros del equipo y las tarjetas de marketplace por todo el sitio. El servidor MCP nos permite iterar dentro de una conversación de Claude Code en lugar de cambiar a otra interfaz cuando queremos una variante puntual. Para trabajo de personajes repetidos — la misma persona en diez artículos — higgsfield-soul-id es el skill al que acudimos. Para tarjetas de marketplace estacionales, higgsfield-marketplace-cards es más rápido.

Un último movimiento: guarda el estilo de la casa como una regla de CLAUDE.md para que cada prompt se mantenga dentro de la identidad visual sin que tengas que escribir las mismas cinco líneas una y otra vez. Y si quieres una biblioteca de inicio, los 19 paquetes de estilo de AKCodez empaqueta presets estéticos comunes como skills de Claude Code listos para usar.

¿Cómo se generan imágenes de cabecera para el blog con Higgsfield MCP?

Para generar imágenes de cabecera con higgsfield mcp, pídele a tu cliente de IA que llame a generate_image con una relación de aspecto 1200×630, un brief MCSLA y el modelo GPT Image 2. Guarda la URL devuelta, optimiza a WebP y súbelo a tu CMS. De extremo a extremo tarda unos 90 segundos cuando el MCP está conectado: del prompt al WebP subido a Sanity, una sola cabecera, sin pestaña adicional abierta.

Así funciona en este blog. Redactamos un prompt de cabecera dentro del skill .claude/skills/blog-hero-image del artículo (uno por artículo, con control de versiones). Dentro de Claude Code, trabajando en el artículo: "Genera una cabecera de diagrama de proceso para este artículo usando GPT Image 2, 1200×630, fondo azul marino, tres cajas etiquetadas." Eso invoca generate_image, Higgsfield devuelve una URL alojada, nuestra pipeline scripts/generate_image.py la reduce a WebP con calidad 85, y scripts/upload_hero_image.py la envía a Sanity.

Una llamada típica a la herramienta dentro de una sesión de Claude Code tiene este aspecto:

text
Tool call: generate_image
  model: "gpt-image-2"
  prompt: "Process diagram, three labeled boxes left-to-right..."
  aspect_ratio: "landscape_16_9"
  quality: "high"

Consejo: no pidas 1200x630 directamente. La mayoría de los modelos prefieren términos de ratio como landscape_16_9 y rechazarán especificaciones de píxeles exactos. Genera con el ratio más cercano y luego recorta ese 5% final para llegar a las dimensiones exactas. Te ahorrarás un crédito por cada reintento fallido.

Si quieres envolver estas llamadas en un script (generar diez cabeceras a partir de un CSV de prompts, por ejemplo), una implementación ligera en Python en GitHub replica las mismas llamadas fuera de la conversación. La usamos para rellenos masivos.

Para reutilizar el mismo asset en distintos canales, nuestra automatización Cover Image Prompter de la comunidad que convierte contenido del blog en briefs de imagen de cabecera se encarga del paso de redacción del brief. Combínala con el Social Banner Generator y una sola cabecera generada con MCP se convierte en cuatro variantes sociales sin volver a escribir el prompt.

Una cabecera de blog renderizada mediante generate_image vía MCP.
Una cabecera de blog renderizada mediante generate_image vía MCP.

¿Puede Higgsfield MCP generar videos cortos para resúmenes de artículos?

Técnicamente sí. Honestamente, con matices. La mecánica es generate_video con Veo 3.1 o Seedance 2.0, de 8 a 15 segundos, de forma asíncrona. La llamada devuelve un ID de trabajo y sondeas con get_generation_status hasta que cae la URL. Estamos experimentando con esto para clips de resumen de artículos, pero todavía no lo estamos publicando en cada post.

Dos aclaraciones honestas. Primera: la generación de video no es rápida. Veo 3.1 tarda 45-90 segundos para un clip de 8 segundos; Seedance 2.0 está más cerca de los 30 segundos. Cuenta con tomarte un café por cada renderizado. Y si estás sondeando en un bucle cerrado, solo estás pagando por respuestas vacías de processing. Pon un intervalo de sondeo de 5 segundos, no de 1.

Segunda: nuestro CMS Sanity todavía no tiene un tipo de bloque videoBlock en el cuerpo. Eso es lo que viene en nuestra pipeline, no lo que está publicado ahora. Por el momento incrustamos los MP4 generados con MCP como etiquetas HTML5 <video> dentro de un bloque personalizado. No vamos a pretender que hoy es una solución de un clic.

El caso de uso hacia el que trabajamos: una animación de resumen de artículo de 12 segundos, con el mismo brief MCSLA que la cabecera estática. La misma paleta de colores, la misma composición, solo animada. Para el contexto más amplio de producción de video con IA, nuestra guía en profundidad cubre el lado editorial.

Si necesitas acceso a modelos que el MCP alojado todavía no expone (Sora 2, por ejemplo), el fork de la comunidad que añade acceso a Sora 2 / Veo 3 merece un vistazo. Es un wrapper MCP auto-alojado, así que traes tus propias claves API para los modelos que no están en el catálogo de Higgsfield.

Depuración: 5 Errores que te Costarán 30 Minutos

Los cinco problemas más comunes de Higgsfield MCP son: token OAuth expirado (vuelve a autenticarte desde el panel /mcp), servidor bloqueado en "pending" (Claude Code reintenta cinco veces con backoff exponencial), flag de scope incorrecto (--scope user vs --scope project), modelo no encontrado (error tipográfico en el nombre del modelo) y video atascado en el sondeo asíncrono (llama a get_generation_status manualmente o reinicia). Cada corrección lleva menos de dos minutos una vez que sabes de qué se trata.

Token OAuth expirado

Síntoma: las herramientas aparecen en /mcp pero cada llamada devuelve "unauthorized." Corrección: en Claude Code, ejecuta /mcp, selecciona Higgsfield y elige "Re-authenticate." El navegador se vuelve a abrir, inicias sesión de nuevo y ya está. Los tokens tienen una vida útil limitada (normalmente unas pocas semanas) y no hay aviso proactivo.

El servidor se queda en "Pending" para siempre

Síntoma: claude mcp list muestra ⏳ junto a higgsfield en vez de ✔. Corrección: Claude Code reintenta HTTP/SSE con backoff exponencial (1 s → 2 s → 4 s → 8 s → 16 s) y se rinde después de cinco intentos. Ejecuta claude mcp restart higgsfield. Si sigue en pending, consulta https://status.higgsfield.ai. El MCP alojado está ocasionalmente degradado durante los despliegues de modelos.

Scope incorrecto (--scope user vs --scope project)

Síntoma: el servidor funciona en un repositorio pero no en otro. Corrección: --scope user escribe en ~/.claude/mcp.json (global, todos los proyectos). --scope project escribe en .mcp.json en el directorio actual (en control de versiones, compartido con el equipo). Si llevas más de dos minutos en la instalación, casi siempre es un problema con el flag de scope. Elige uno y borra el otro.

Modelo no encontrado

Síntoma: Error: model "veo-3" not found. Corrección: el nombre del modelo es veo-3.1, no veo-3. Ejecuta list_characters para ver los identificadores exactos de modelo en los metadatos de la respuesta, o consulta la tabla del primer H2. Los nombres de Higgsfield distinguen entre mayúsculas y minúsculas y llevan el número de versión, así que Soul y soul-v2 no son la misma cadena.

Video atascado en el sondeo asíncrono

Síntoma: generate_video devuelve un ID de trabajo pero get_generation_status sigue devolviendo processing pasados tres minutos. Corrección: los trabajos de Veo y Kling pueden tardar más de 90 segundos, pero pasados tres minutos el trabajo ha fallado silenciosamente o se ha atascado en la cola. Ejecuta claude mcp restart higgsfield y vuelve a emitir la solicitud. Las cuentas del plan gratuito tienen menor prioridad en la cola, así que los usuarios de pago sufren esto menos.

Si sigues teniendo timeouts de MCP en CI, el Higgsfield CLI funciona en modo headless y es más amigable para scripts. El MCP necesita un round-trip OAuth interactivo; el CLI usa tokens de API de larga duración, que es lo que quieres para pipelines no conversacionales.

Si tienes funciones de IA en tu hoja de ruta, esa es nuestra especialidad: el equipo de integración de IA de Techsy lleva los sistemas LLM del prototipo a producción.

Preguntas frecuentes

¿Qué es Higgsfield MCP?

Higgsfield MCP es un servidor Model Context Protocol alojado en https://mcp.higgsfield.ai/mcp que expone siete modelos de generación de imágenes y video (incluyendo GPT Image 2, Soul V2, Veo 3.1, Kling 3.0 y Flux 2) a cualquier cliente de IA compatible con MCP. La autenticación es OAuth mediante tu cuenta de Higgsfield; no se necesitan claves API para el servidor alojado.

¿Es Higgsfield MCP gratuito?

Sí, hay un plan gratuito de 150 créditos al mes, vigente a mayo de 2026. Más allá de eso, los créditos de prepago corren aproximadamente a 1 USD = 16 créditos, y las generaciones individuales cuestan entre 2 y 60 créditos según el modelo y la duración. Una imagen estática cuesta unos 2-10 créditos; un clip de Veo de 8 segundos, unos 60. Los planes de pago de Higgsfield cambian, así que consulta su página de facturación para los niveles de precios actuales.

¿Cómo instalo Higgsfield MCP en Claude Code?

Ejecuta claude mcp add --transport http --scope user higgsfield https://mcp.higgsfield.ai/mcp en tu terminal. Claude Code abre un navegador para OAuth en el primer uso; inicia sesión en tu cuenta de Higgsfield, vuelve al terminal y verifica con claude mcp list o el comando slash /mcp dentro de cualquier sesión de Claude Code. Todo el flujo tarda bastante menos de un minuto con una conexión normal.

¿Funciona Higgsfield MCP con Codex o ChatGPT Desktop?

Con el CLI de Codex de OpenAI sí: habla el protocolo de cable MCP estándar, así que la misma configuración de mcp.json funciona allí. Con ChatGPT Desktop no, a mayo de 2026. OpenAI todavía no ha publicado soporte MCP en la app de ChatGPT para consumidores. Si necesitas específicamente Sora 2 u otros modelos de OpenAI que el MCP alojado de Higgsfield no expone, el fork unificado de la comunidad puede cubrir ese hueco.

Higgsfield MCP vs CLI: ¿cuál usar?

Usa el MCP para generación conversacional dentro del chat, donde el modelo elige los parámetros según el contexto. Eso cubre la mayoría de los flujos de escritura de artículos e iteración de diseño. Usa el CLI para pipelines headless y con scripts, trabajos de CI o rellenos masivos donde quieres tokens de autenticación de larga duración en lugar de un flujo OAuth interactivo. También puedes envolver el MCP como un skill de Claude para patrones repetidos.

¿Qué modelos admite Higgsfield MCP?

El servidor alojado expone actualmente siete modelos principales: GPT Image 2 y Nano Banana Pro para trabajo de imagen general, Soul V2 para consistencia de personajes, Flux 2 para output estilizado, más Seedance 2.0, Veo 3.1 y Kling 3.0 para video. El catálogo completo de Higgsfield incluye más de 30 modelos, y el catálogo del MCP alojado se amplía con el tiempo a medida que nuevos modelos llegan a la plataforma.

¿Puedo ejecutar Higgsfield MCP en modo headless en CI?

No directamente. El MCP alojado requiere un round-trip OAuth interactivo en la primera autenticación, lo que no funciona en un entorno CI. Para CI usa el Higgsfield CLI (@higgsfield/cli), que utiliza tokens de API de larga duración que puedes almacenar como secreto de CI. El MCP es para sesiones interactivas; el CLI es para pipelines de automatización y trabajos de generación masiva.

¿Cómo consigo consistencia de personajes entre generaciones?

Usa create_character con 3-5 imágenes de referencia del sujeto. La herramienta devuelve un ID de personaje después de unos 3-5 minutos de entrenamiento. Referencia ese ID en las llamadas posteriores a generate_image con el modelo Soul V2, y la misma cara aparece en cada generación. Este es el patrón de trabajo para series de artículos, mascotas de producto y cualquier proyecto que necesite continuidad visual.

¿Cuesta más Higgsfield MCP que llamar directamente a Sora o Veo?

Aproximadamente comparable en la mayoría de los casos. Higgsfield compra capacidad de API al por mayor y la revende como créditos, así que los costos por generación están dentro del rango de los proveedores subyacentes. El intercambio es facturación consolidada, OAuth en lugar de una docena de claves API, y UX conversacional a través de MCP. Para scripts puntuales quizás ahorres un poco yendo directo; para trabajo creativo continuo, Higgsfield es el camino más sencillo.

¿Es Higgsfield MCP gratuito para usar con Claude Code?

Sí, el nivel gratuito ofrece 150 créditos al mes sin coste, lo que cubre aproximadamente 15 imágenes estáticas con GPT Image 2 o dos clips de vídeo con Veo 3.1. Claude Code en sí no cobra ningún cargo adicional por las llamadas a herramientas MCP. Por encima del cupo gratuito, los créditos de prepago cuestan alrededor de 1 USD por 16 créditos. Para equipos que generan imágenes de cabecera a gran escala, el plan de pago vale la inversión; para desarrolladores individuales, el nivel gratuito cubre un uso ligero a moderado.

¿Qué se puede generar con Higgsfield MCP en Claude Code?

El servidor expone generación de imágenes (fotografías únicas, sesiones de producto, ilustraciones estilizadas), generación de vídeo (clips cinematográficos de hasta 15 segundos con Veo 3.1 o Kling 3.0) y entrenamiento de personajes para coherencia visual. En la práctica, los equipos lo usan para imágenes de cabecera de blog, OG cards, maquetas de producto y animaciones cortas de resumen, todo ello directamente desde el flujo de trabajo de Claude Code sin necesidad de abrir una herramienta creativa aparte.

Resumen final

Eso es el recorrido completo: una instalación de una línea para Claude Code, snippets JSON para todos los demás clientes MCP importantes, la receta de prompting MCSLA, el flujo de trabajo Soul Character para consistencia, y los cinco errores que te harán perder la tarde si no los tienes en cuenta. Si todavía estás eligiendo tu cliente de IA, nuestra comparativa Claude Code vs Cursor vs Copilot cubre el panorama más amplio.

Si prefieres que te ayudemos a integrar Higgsfield MCP en la pipeline de contenidos de tu equipo junto a Sanity o tu CMS, solicita una consulta gratuita.

Etiquetas

higgsfield mcpclaude codeservidores mcpgeneración de imágenes con iageneración de video con ia

Compartir este artículo

Inicia Tu Proyecto

¿Listo para construir algo extraordinario?

Convirtamos tu visión en realidad. Nuestro equipo está listo para ayudarte a crear software que marque la diferencia.