Cómo conectar Higgsfield a Microsoft Copilot vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Higgsfield, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Higgsfield + Microsoft Copilot

Deja que tu IA cree imágenes y vídeos en Higgsfield con tu propia clave de API: retratos SOUL, imágenes de producto con Marketing Studio y Ads Studio, vídeos con Seedance, Kling 3.0 y Cinema Studio y más de 80 modelos más, con estimación del precio antes de cada generación, consulta del estado y cancelación.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

HIGGSFIELD_API_KEY_ID, HIGGSFIELD_API_KEY_SECRET

Paso 1 — Obtener credenciales

La configuración lleva unos 3 minutos. Necesitas una cuenta de Higgsfield Console con saldo de API y una clave de API. Cada generación se cobra de ese saldo.

1. Inicia sesión en https://console.higgsfield.ai y recarga el saldo de API (pay as you go). Sin saldo, las generaciones se rechazan con 403.
2. En la Console, abre API keys y crea una clave. Tiene dos partes: una key ID y un secret. El secret solo se muestra una vez, así que cópialo enseguida.
3. Pega la key ID en HIGGSFIELD_API_KEY_ID y el secret en HIGGSFIELD_API_KEY_SECRET, cada uno por separado, sin dos puntos y sin la palabra Key. El conector los une en la cabecera Authorization: Key <id>:<secret> y la envía solo a api.higgsfield.ai.
4. Instala el conector. La instalación comprueba la clave listando los estilos SOUL, lo que no cuesta nada; puedes repetir esa comprobación cuando quieras con higgsfield_list_soul_styles.

Qué crea: imágenes con SOUL V2 (retratos fotorrealistas, moda y editorial, opcionalmente en un estilo SOUL o con uno de tus personajes Soul ID entrenados), Marketing Studio (imágenes de campaña y de producto, ediciones con hasta 16 imágenes de referencia o anuncios a partir de un preset) y Ads Studio (un brief y fotos de producto opcionales se convierten en 1 a 8 conceptos de anuncio). Vídeos con Seedance 2.5 (desde texto, desde una imagen o desde medios de referencia), Kling 3.0 (nivel Standard, Pro o 4K, con sonido nativo) y Cinema Studio 4.0. Cualquier otro de los más de 80 modelos, como Wan, MiniMax, Hailuo, Grok Imagine, Recraft o Ideogram, funciona con higgsfield_generate mediante su endpoint ID de la página del modelo en docs.higgsfield.ai.

Qué lee, gratis: el estado y el resultado de una petición, las estimaciones de precio, los estilos SOUL, los presets de Marketing Studio y tus personajes Soul ID con su estado de entrenamiento.

Cada generación gasta créditos, así que la IA estima primero y pregunta: antes de higgsfield_soul_image, higgsfield_marketing_studio_image, higgsfield_ads_studio, higgsfield_seedance_text_to_video, higgsfield_seedance_image_to_video, higgsfield_seedance_reference_to_video, higgsfield_kling_text_to_video, higgsfield_kling_image_to_video, higgsfield_cinema_studio_video o higgsfield_generate, la IA ejecuta higgsfield_estimate_cost con el mismo modelo y la misma entrada, te dice qué modelo se usará y cuánto cuesta, y espera tu sí. Nunca lanza varias generaciones en bucle sin preguntar. El vídeo cuesta mucho más que las imágenes y sube con la duración, la resolución y el nivel; cuatro imágenes en un mismo lote cuestan unas cuatro veces una. Las peticiones fallidas y las que rechaza la moderación (nsfw) no se cobran. Antes de higgsfield_cancel_request la IA también pregunta.

Desactivadas al instalar: ninguna. Cada herramienta de pago pasa por la estimación del precio y tu confirmación, y cancelar solo funciona con peticiones que aún no han empezado.

De la petición al resultado: una generación responde al instante con un request_id y el estado queued. La IA consulta higgsfield_get_request_status cada 5 a 10 segundos; las imágenes tardan segundos, los vídeos normalmente minutos. Recibes enlaces a las imágenes, al vídeo o al audio, no archivos. Los enlaces siguen disponibles al menos siete días, así que descarga lo que quieras conservar. Una petición solo se puede cancelar mientras sigue en cola, y entonces se devuelven los créditos; si ya está en curso, se cobra al terminar. Tras un timeout, un reintento con el mismo idempotency_key devuelve la petición original en lugar de una segunda cobrada.

Las entradas son enlaces: las imágenes, vídeos y audios de referencia se pasan como URL HTTPS públicas. El conector no puede subir archivos desde tu ordenador.

Límites: el límite principal es la concurrencia, el número de peticiones en cola o en curso a la vez (a menudo 4). Un 400 que dice que se alcanzó el número máximo de peticiones simultáneas significa esperar a que termine una. Los límites de tu cuenta aparecen en la Console.

Errores comunes: 401 Invalid credentials significa que la key ID o el secret son incorrectos, están intercambiados o revocados: crea una clave nueva en la Console. 403 significa que no hay saldo suficiente. 404 significa que el id de la petición no existe o pertenece a otra cuenta, o que el modelo no está disponible para tu cuenta. 422 significa que falta un campo de entrada, está mal escrito o fuera de rango, y el error lo nombra. 423 o 503 significa que el modelo está bloqueado o desactivado temporalmente: inténtalo más tarde o elige otro modelo.

El conector no sube archivos, no recibe webhooks, no entrena personajes Soul ID, no usa la Agent API y no ve los proyectos ni el historial de la web app de Higgsfield.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Microsoft Copilot

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.

1. En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
2. Escribe un Server name (por ejemplo AnythingMCP), una Server description que diga qué hace el conector y la Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor.
3. En la autenticación, elige API key, pon Type en Header y X-API-Key como nombre de la cabecera, y selecciona Create.
4. En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
5. Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de Higgsfield.
6. Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.

¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.

¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.

Herramientas disponibles

Ejemplos de prompts

• "Crea con SOUL un retrato fotorrealista de una mujer con traje de lino en una azotea a la hora dorada. Dime el precio antes de empezar."
• "Esta es la foto de nuestra nueva zapatilla de running: https://example.com/zapatilla.jpg. Conviértela en 4 conceptos de anuncio para una campaña de Instagram."
• "Haz un vídeo corto con Kling 3.0 Pro de un barista sirviendo latte art a cámara lenta. ¿Cuánto costará?"
• "Anima esta foto de producto en un vídeo corto con Seedance: https://example.com/botella.jpg. Enséñame antes la estimación."
• "¿Ya está listo mi último vídeo? Pásame el enlace para descargarlo."

FAQ

¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.

¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.

El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Gemini
• Conectar a Meta Muse