Conectar HeyGen con Microsoft Copilot vía HeyGen 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 + Microsoft Copilot

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 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 HeyGen.
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

• "¿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

¿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