Cómo conectar HeyGen a Gemini vía MCP

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

HeyGen + Gemini

Deja que tu IA cree vídeos con avatares de HeyGen con tu propia clave: elige avatares y voces, convierte un guion o un prompt en un vídeo con un avatar que habla, rellena tus plantillas, traduce vídeos a otros idiomas con sincronización labial, crea avatares a partir de fotos y consulta los renderizados y tu saldo.

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:

HEYGEN_API_KEY

Paso 1 — Obtener credenciales

1. Inicia sesión en https://app.heygen.com y abre el panel de la API (https://app.heygen.com/developers/api).
2. Genera una API key y cópiala. El uso de la API se factura aparte de una suscripción web de HeyGen: añade saldo o un método de pago allí si la cuenta no tiene ninguno.
3. Pega la clave en HEYGEN_API_KEY e instala el conector. La clave solo se envía a HeyGen. Una clave limitada a ciertos permisos necesita acceso de lectura a avatares, voces, vídeos, plantillas, traducciones y usuario, y acceso de escritura para las herramientas que crean contenido.
4. Empieza con heygen_get_account: muestra tu tipo de facturación y lo que te queda por gastar.

Se cobra de tu saldo de API de HeyGen: los vídeos, las traducciones y los avatares se pagan con tu saldo de API (un monedero de pago por uso o los créditos de tu plan). HeyGen factura el vídeo según la duración y el motor; los precios actuales están en el panel de la API, y una llamada rechazada (402) indica cuánto hacía falta. Listar y consultar es gratis.

Confirma primero: antes de heygen_create_video, heygen_generate_from_template, heygen_create_agent_video o heygen_translate_video, la IA te dice qué se va a crear (avatar, voz, longitud del guion, formato, idiomas, motor) y espera tu sí. heygen_create_photo_avatar solo acepta la foto de alguien que haya dado su consentimiento, como tú mismo, y la IA te pide que confirmes que tienes ese derecho. heygen_delete_video está desactivada al instalar.

Cómo se crea un vídeo:

1. La IA elige un personaje con heygen_list_avatar_groups y uno de sus looks con heygen_list_avatar_looks; el look es el presentador. Una voz de heygen_list_voices es opcional; si no eliges ninguna, habla la voz propia del avatar.
2. heygen_create_video recibe el guion (hasta 5.000 caracteres), el formato (por ejemplo 9:16 para shorts) y el motor, y devuelve un id de vídeo al instante.
3. El vídeo se renderiza en segundo plano. La IA consulta heygen_get_video cada 30 segundos aproximadamente; un renderizado tarda desde un minuto hasta varios minutos, más con guiones largos.
4. El vídeo terminado incluye un enlace MP4, una versión con subtítulos, subtítulos SRT y un enlace al vídeo en HeyGen. Los enlaces de descarga caducan; pide unos nuevos.

Otras formas de crear un vídeo:

• Plantillas: heygen_list_templates y heygen_get_template muestran tus plantillas preparadas para la API y sus variables; heygen_generate_from_template rellena todas las variables de texto y renderiza el vídeo.
• Video Agent: heygen_create_agent_video convierte un prompt en un vídeo completo (guion, escenas, avatar); heygen_get_agent_session lo sigue hasta que el vídeo se renderiza.
• Traducción: heygen_translate_video traduce un vídeo desde un enlace público a uno o varios idiomas, con la voz clonada del hablante y sincronización labial o solo como audio; heygen_list_translation_languages muestra los idiomas de destino.
• Avatar de foto: heygen_create_photo_avatar crea un presentador a partir de un solo retrato; heygen_get_avatar_look indica cuándo está listo para usarse.

Motores: avatar_iv es el predeterminado. avatar_v ofrece el movimiento más natural, pero solo con los looks que lo admiten. avatar_iii admite 4K para gemelos digitales y avatares de estudio.

Límites: 10 vídeos, traducciones o sesiones de agente renderizándose a la vez con pago por uso (más en Enterprise), 300 llamadas de listado y 500 consultas de estado por minuto. Los archivos de origen deben ser enlaces públicos: vídeo de hasta 100 MB, audio de hasta 50 MB y 10 minutos.

Errores habituales: 401: la clave es incorrecta o se revocó. 402 insufficient_credit: el saldo no cubre este vídeo, y el mensaje indica cuánto hace falta. usage_limit_reached o trial_limit_exceeded: un límite del espacio de trabajo o de la prueba que un administrador o un plan de pago puede levantar. 403 insufficient_api_key_scope: la clave está restringida; dale los permisos indicados arriba. 400 invalid_parameter: el mensaje indica el campo, por ejemplo un motor que el look no admite. 404: un id que no existe; la IA lo comprueba con las herramientas de listado. 429: demasiadas solicitudes; espera y reintenta una vez más tarde.

El conector usa la API v3 de HeyGen (HeyGen retira los endpoints antiguos v1 y v2 el 31 de octubre de 2026). No cubre vídeos de estudio con varias escenas, imagen a vídeo, sincronización labial de vídeos existentes, clonación y diseño de voces, texto a voz por separado, avatares interactivos en streaming, subida de archivos (las fuentes deben ser enlaces públicos), revisión de traducciones, webhooks, kits de marca, carpetas ni lotes.

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 Gemini

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.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de HeyGen.

Herramientas disponibles

Ejemplos de prompts

• "¿Cuánto me queda en el saldo de API de HeyGen?"
• "Muéstrame mis propios avatares y cuáles de sus looks funcionan mejor en 9:16."
• "Crea un vídeo 9:16 de 45 segundos con mi gemelo digital leyendo este guion. Confirma conmigo primero el avatar, la voz y la duración, y luego envíame el enlace MP4 cuando esté listo."
• "Rellena nuestra plantilla de novedades semanales con estas tres noticias y renderízala."
• "Traduce este vídeo de demostración del producto al español (España) y al japonés con sincronización labial y avísame cuando las dos versiones estén listas."

FAQ

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT