Higgsfield MCP en Claude Code: asígnale una tarea y obtén un vídeo

Higgsfield se conecta a Claude Code con un solo comando, claude mcp add, y la dirección https://mcp.higgsfield.ai/mcp. Después, le das una tarea en lenguaje natural y el agente accede a Higgsfield por su cuenta, genera una imagen o un vídeo y te lo devuelve directamente en la ventana. Pagas dos veces: con créditos de Higgsfield por las generaciones y con los límites de Claude Code por mantener el servidor en el contexto. Así que mi regla es sencilla: si no usas MCP, apágalo.

Antes el proceso era largo: ir al sitio web de Higgsfield, entender la interfaz, escribir un prompt, generar, descargar y subir el resultado a tu proyecto. Ahora Higgsfield ha publicado su propio MCP, así que ya no hace falta entrar en Higgsfield ni entender esas interfaces.

Cuesta imaginar que alguien vaya ahora a Higgsfield para generar algo, cuando puede generar de todo a través de su propio Claude Code.

Con esta configuración he creado una presentación entera, incluidos todos los vídeos que contiene. Describí toda la tarea y se la encargué al agente.

Hay un riesgo: el agente podría ponerse a producir 100 imágenes y tendrías que pagar por cada una. Por eso, incluye en cada tarea una condición sobre el coste y el número de intentos.

Vamos a verlo en orden: cómo conectar el servidor, cómo asignarle una primera tarea, con qué pagas y cuándo apagar el servidor.

Paso 1: añadir Higgsfield al agente de inteligencia artificial Claude Code mediante MCP#

Abre una terminal en la carpeta del proyecto donde generarás imágenes y vídeos, y ejecuta:

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

La dirección aparece en la página oficial higgsfield.ai/mcp; cópiala con el botón Copy connector URL.

Sin la opción --scope, el servidor se añade solo al proyecto actual. Con --scope project, estará disponible para todo el equipo en ese proyecto; con --scope user, estará disponible en todos tus proyectos.

Añade Higgsfield donde lo uses. En un proyecto donde escribas código o texto, ocupará espacio en el contexto sin hacer nada.

He hablado de otros servidores para Claude Code en un artículo aparte.

Paso 2. Inicia sesión en tu cuenta de Higgsfield desde /mcp#

Inicia Claude Code y escribe /mcp. Selecciona higgsfield en la lista; se abrirá un navegador. Inicia sesión en tu cuenta de Higgsfield.

Las generaciones se cargarán a esa cuenta. Hasta que inicies sesión, el servidor devuelve un error 401: Claude Code puede verlo, pero no usarlo.

Paso 3. Comprueba que el servidor se haya conectado#

Ejecuta esto en la terminal:

claude mcp list

El servidor higgsfield debería mostrar el estado ✔ Connected.

Si el estado es distinto, comprueba los detalles: la dirección, el alcance y el estado del servidor.

claude mcp get higgsfield

Si eso no ayuda, elimina el servidor y vuelve a añadirlo:

claude mcp remove higgsfield
claude mcp add --transport http higgsfield https://mcp.higgsfield.ai/mcp

Después, inicia sesión otra vez desde /mcp. Claude Code también borra las credenciales guardadas al eliminar el servidor, así que volverás a recibir el mismo error 401 si no inicias sesión de nuevo.

Cómo asignarle una primera tarea para crear una imagen y un vídeo#

Empieza con una tarea que no genere nada. Pídele al agente que te muestre lo que puede hacer el servidor antes de gastar nada:

Muéstrame qué herramientas y modelos tiene el servidor de Higgsfield y cuántos créditos cuesta generar con cada modelo. No generes nada.

Después, asígnale la tarea propiamente dicha. Añade al final de cada tarea esta condición: antes de generar con coste, debe mostrarte el precio y acordar el número de intentos.

Un prompt de /goal con un límite de intentos funciona según el mismo principio: el agente tiene un número de intentos limitado de antemano.

Tarea para una imagen destinada a la sección hero de un sitio web:

Prepara una imagen en Higgsfield para la sección hero del sitio web de mi producto. Producto: [link]. Sugiere un objeto, un ángulo, un color y un entorno que ayuden a explicar el producto. Deja espacio en el encuadre para el encabezado y el botón de la página. Formato horizontal. Guarda el archivo terminado en la carpeta images del proyecto.
Antes de generar con coste, muéstrame el precio, acuerda el número de intentos y espera mi «sí».

Tarea para crear un vídeo a partir de esta imagen:

Haz un vídeo corto en Higgsfield a partir de esta imagen: images/hero.png. La cámara se acerca lentamente al producto y el fondo se mueve un poco. Sugiere un modelo y pregúntame cuánto debe durar el vídeo. Haz 1 versión.
Antes de generar con coste, muéstrame el precio, acuerda el número de intentos y espera mi «sí».

El agente accede a Higgsfield por su cuenta, escribe un prompt, genera y obtiene una imagen o un vídeo, y te lo entrega en la ventana de Claude Code. También puedes decirle en lenguaje natural qué quieres cambiar.

Qué modelos hay disponibles y cuánto cuestan las generaciones#

Higgsfield me funciona bien porque incorpora todas las herramientas de IA, incluidas en la suscripción, aunque se pague con créditos.

Pídele al agente la lista de modelos con la primera tarea de la sección anterior; obtendrás los modelos y sus precios en créditos a fecha de hoy.

Las generaciones a través de MCP se cobran en créditos a tu cuenta de Higgsfield. El servidor en sí consume los límites de Claude Code, así que tienes dos contadores de uso. En un artículo aparte expliqué dónde se consumen los tokens de Claude Code:

Cuánto consumo genera el servidor MCP y cuándo apagarlo#

Todos los servidores MCP consumen límites: las descripciones de sus herramientas se añaden al contexto del modelo.

La búsqueda de herramientas está activada de forma predeterminada en Claude Code. Al inicio de una sesión se cargan los nombres de las herramientas del servidor y sus instrucciones; las descripciones completas se cargan cuando hacen falta. Si Claude Code funciona con tu propio ANTHROPIC_BASE_URL, la búsqueda está desactivada y las descripciones se cargan completas. En ambos casos, el servidor ocupa espacio en el contexto de cada sesión.

Si tienes instaladas muchísimas herramientas MCP, consumen tus límites sin aportarte nada. Por eso, hay una regla importante: si no usas MCP, apágalo para que no sobrecargue la ventana de contexto.

Puedes apagar y volver a encender el servidor así:

• Temporalmente. Usa el interruptor que aparece junto a higgsfield en /mcp. Claude Code deja de conectarse al servidor, guarda el ajuste y recuerda la selección para este proyecto.
• Por completo. Ejecuta claude mcp remove higgsfield. Se borrará el inicio de sesión guardado junto con el servidor.
• Volver a encenderlo. Usa el mismo interruptor en /mcp o ejecuta otra vez claude mcp add e inicia sesión desde /mcp.

Mantén el servidor encendido mientras trabajes con imágenes y vídeos. Si estás escribiendo código o texto y no tienes nada que generar, apágalo.

Por cierto, he preparado una guía completa para configurar tu primer agente con Hermes; no te la pierdas:

En ella explico qué es MCP, cómo evitar instalar uno malicioso y cuánto cuestan. Después de verla, entenderás qué conexiones necesita realmente un agente.

¿Qué opción elegir: MCP, el programa de Higgsfield o un servidor no oficial?#

Hay tres maneras de conectar Higgsfield a un agente:

Empieza con el servidor MCP: se instala con un comando y se apaga con un interruptor. Si generas a diario y no quieres que un servidor ocupe espacio en el contexto, echa un vistazo al programa de Higgsfield con skills.

Siguiente paso: en la cuenta Higgsfield conectada, comprueba herramientas, modelos y costes en créditos como se explica arriba, sin generar nada. Elige un resultado previsto y un presupuesto de intentos antes de generar. Para un flujo independiente con la API Ailoot, consulta la guía de solicitudes de imágenes o la guía de tareas de vídeo y resultados; describen llamadas API Ailoot, no esta cuenta MCP Higgsfield.