higgsfield-mcp-server

Servidor MCP remoto que permite a Claude generar imágenes y vídeos a través de la API de Higgsfield AI — fotos fotorrealistas (Soul), imágenes guiadas por referencias (Popcorn) y vídeo (Google Veo 3.1, Kling, ByteDance Seedance) — directamente desde el chat.

Herramientas expuestas

Todas las herramientas de generación son asíncronas: devuelven un request_id inmediatamente; llama a higgsfield_check_status (Claude lo hará automáticamente) hasta que el trabajo esté completed.

Related MCP server: higgsfield-mcp

1. Obtén tus claves de API de Higgsfield

1. Ve a https://cloud.higgsfield.ai e inicia sesión.

2. Crea una clave de API (ya lo hiciste si estás leyendo esto después de pedir ayuda a Claude) — obtienes un API Key ID y un API Key Secret. Copia ambos, solo se muestran una vez.

2. Despliega este servidor (el plan gratuito funciona)

Necesitas un lugar que mantenga un proceso de Node ejecutándose 24/7 y accesible a través de HTTPS. Dos opciones gratuitas que no requieren tarjeta de crédito para un servidor pequeño como este:

Opción A: Render.com

1. Sube esta carpeta a un nuevo repositorio de GitHub (puede ser privado).

2. En https://render.com → Nuevo + → Servicio web → conecta ese repositorio.

3. Configuración:

   • Runtime: Node

   • Comando de compilación: npm install

   • Comando de inicio: npm start

4. En Entorno, añade estas tres variables:

   • HF_API_KEY_ID = tu Higgsfield API Key ID

   • HF_API_KEY_SECRET = tu Higgsfield API Key Secret

   • MCP_ACCESS_TOKEN = cualquier cadena aleatoria larga que inventes (p. ej. ejecuta openssl rand -hex 32 localmente, o simplemente teclea al azar 40+ caracteres) — esta es la contraseña que Claude usará para hablar con tu servidor, para que nadie más pueda gastar tus créditos de Higgsfield.

5. Despliega. Render te da una URL como https://higgsfield-mcp-server.onrender.com. Tu endpoint MCP es esa URL + /mcp, p. ej. https://higgsfield-mcp-server.onrender.com/mcp.

Nota: los servicios web gratuitos de Render se duermen tras la inactividad y tardan unos segundos en despertarse en la siguiente solicitud — suficiente para un uso ocasional.

Opción B: Railway.app

Misma idea: nuevo proyecto desde este repositorio de GitHub, configura las mismas tres variables de entorno, Railway auto-detecta npm start. Obtienes una URL como https://higgsfield-mcp-server-production.up.railway.app, el endpoint es esa + /mcp.

3. Añádelo a Claude como conector personalizado

En Claude (claude.ai / aplicación de escritorio) → Configuración → Conectores → Añadir conector personalizado:

• Nombre: Higgsfield

• URL: https://<your-deployed-url>/mcp

• Autenticación: Bearer token → pega el valor de MCP_ACCESS_TOKEN que configuraste en el paso 2.

Actívalo para tu chat, y Claude podrá llamar a las herramientas anteriores.

Pruebas locales (opcional)

cp .env.example .env   # fill in real values
npm install
npm start

El servidor escucha en http://localhost:3000/mcp (o $PORT).

Notas de seguridad

• HF_API_KEY_ID / HF_API_KEY_SECRET dan acceso completo a tu cuenta y facturación de Higgsfield. Viven solo en las variables de entorno del host — nunca los hagas commit, nunca los pongas en la URL.

• MCP_ACCESS_TOKEN es lo que impide que una persona al azar que encuentre la URL de tu servidor genere contenido con tus créditos de Higgsfield. Trátalo como una contraseña.

• Cada llamada de generación gasta créditos de Higgsfield según el precio de tu plan.