Añade el servidor MCP remoto de HeyGen a Claude en unos cinco minutos: pega una URL, aprueba el inicio de sesión OAuth y deja que Claude escriba, renderice y traduzca videos con avatar a partir de un solo prompt. Incluye comandos de Claude Code, patrones de prompts, datos de créditos y límites de tasa, una tabla de solución de problemas y un tutorial para ejecutar Avatar V en PicassoIA.
Escribes una frase en Claude, te vas a tomar un café y, al volver, tienes un video con avatar terminado y un enlace para enviarle a un cliente. Esa es la promesa del servidor MCP remoto de HeyGen, y la configuración lleva unos cinco minutos porque no hay que instalar nada. Ni servidor local, ni credencial de API pegada en un archivo de configuración, ni facturación aparte. Inicias sesión una vez con OAuth y Claude puede trabajar dentro de tu cuenta de HeyGen.
Esta guía te lleva por la configuración de HeyGen MCP en Claude para los tres lugares donde la gente usa Claude de verdad: la aplicación web, la aplicación de escritorio y Claude Code. Obtienes el endpoint exacto, el comando de terminal exacto, prompts que generan videos utilizables, los datos de créditos y límites de tasa de la propia documentación de HeyGen, y una lista de soluciones para los errores que más confunden. Hacia el final hay un tutorial breve para ejecutar el motor Avatar V de HeyGen directamente en PicassoIA, para los días en que quieres un presentador que habla sin abrir un asistente.
💡 Respuesta rápida: el endpoint es
https://mcp.heygen.com/mcp/v1/. Añádelo a Claude como conector personalizado (o ejecuta el comandoclaude mcp adden Claude Code), aprueba el inicio de sesión OAuth y luego pide un video.
MCP son las siglas de Model Context Protocol, el estándar abierto que permite a un asistente de IA llamar a herramientas dentro de otras aplicaciones. HeyGen ejecuta su servidor en su propia infraestructura, así que Claude se conecta a un endpoint alojado en lugar de a un programa en tu equipo. Según la documentación, el uso consume los créditos que ya incluye tu plan de HeyGen, y el conector funciona en todos los planes.
Una vez conectado, Claude puede encargarse de trabajo de producción real desde una ventana de chat:
HeyGen cuenta más de 48 funciones en el servidor y lista compatibilidad con Claude (web, escritorio y Code), Cursor, Gemini CLI, Codex CLI, Lovable, Manus, Superhuman y agentes basados en OpenAI, además de cualquier cliente MCP personalizado.
Los servidores de HeyGen creados por la comunidad que se publicaron antes se ejecutan en tu propia máquina y necesitan una credencial de API en una variable de entorno. El servidor remoto elimina ambas tareas. La autenticación es OAuth, así que ningún secreto queda en un archivo de configuración, y HeyGen mantiene las herramientas de su lado. Pegas una URL y apruebas una pantalla de inicio de sesión.
HeyGen documenta tres formas de que un agente trabaje con la plataforma. En todos los casos, los créditos salen de tu plan.
| Vía | Cómo inicias sesión | Ideal para | Origen del costo |
|---|---|---|---|
| MCP remoto | OAuth, un solo inicio de sesión | Trabajo guiado por chat en Claude | Créditos del plan existente |
| HeyGen CLI | Credencial de API en una variable de entorno | Scripts y agentes sin interfaz | Créditos del plan existente |
| API directa | Credencial de API en una variable de entorno | Backends personalizados, POST /v3/video-agents y luego sondeo de GET /v3/videos/{video_id} | Créditos del plan existente |
💡 El consejo de HeyGen para los agentes es directo: prueba primero el servidor MCP, pasa a la CLI si hace falta y usa las llamadas directas a la API como último recurso. Nunca pegues una credencial de API en una ventana de chat.
Los nombres de los menús cambian un poco entre versiones de la aplicación, pero el flujo es siempre el mismo.
HeyGen y pega https://mcp.heygen.com/mcp/v1/.
El paso de OAuth es el más importante. Los créditos pertenecen a la cuenta que apruebes, así que comprueba dos veces que has iniciado sesión en el espacio de trabajo correcto antes de seguir adelante.
💡 ¿Ejecutas un agente personalizado en su propio dominio? HeyGen pide que envíes ese dominio a través de su formulario de integración para que se incluya en la lista de permitidos.
Ejecuta esto una vez en tu terminal:
claude mcp add --transport http heygen https://mcp.heygen.com/mcp/v1/
Después abre Claude Code, escribe /mcp, elige heygen y termina el inicio de sesión OAuth en tu navegador. Añade --scope user si quieres que el servidor esté disponible en todos los proyectos y no solo en el actual.
Los equipos que comparten un repositorio pueden guardar una configuración de proyecto en su lugar:
{
"mcpServers": {
"heygen": {
"type": "http",
"url": "https://mcp.heygen.com/mcp/v1/"
}
}
}
El archivo no contiene credenciales, así que cada compañero se autentica por su cuenta y los créditos quedan asociados a la persona que pidió el video.
Pídele a Claude: "Llama a la herramienta get_current_user de HeyGen y dime qué cuenta está conectada." La documentación de HeyGen usa esta llamada como comprobación de estado. En Claude Code, la herramienta aparece como mcp__heygen__get_current_user. Si el nombre de la cuenta coincide con el que esperas, estás listo. Si Claude dice que no tiene herramientas de HeyGen, ve a la tabla de soluciones más abajo.
El renderizado es asíncrono. HeyGen indica que los videos suelen terminar en 1 a 5 minutos, y Claude tiene que llamar a una herramienta de estado para saber cuándo. Dilo en tu prompt, o el asistente podría darte un ID y detenerse.
El Video Agent es la ruta más corta de la idea al video. Tiene dos modos: generate funciona en una sola pasada, mientras que chat te permite refinar a lo largo de varios turnos. Un buen prompt indica seis cosas:
"Usa HeyGen Video Agent para hacer un video explicativo de producto de 30 segundos sobre un escritorio de pie. Presentadora femenina y amable, tono calmado, vertical 9:16, estilo oficina limpia. Sigue comprobando el estado hasta que el video esté listo y luego dame el enlace."
Antes de renderizar, pídele a Claude que llame a list_video_agent_styles. Los estilos son plantillas seleccionadas que controlan la composición de las escenas, el ritmo y el aspecto, y puedes filtrarlos por etiquetas como "cinematic" o "retro-tech".
Cuando la redacción debe ser exacta, como una lista de precios o un aviso legal, omite el agente y usa create_video. Un avatar elegido o una imagen fija dice tu guion o audio con sincronización labial. Eliges Avatar III, Avatar IV o Avatar V como motor, y Avatar IV es el predeterminado. Avatar V solo funciona con avatares que lo admiten.
"Usa create_video con mi avatar de marca y este guion exacto. Motor Avatar V, 1080p, 16:9. Devuelve el video_url cuando esté listo."
La herramienta get_video devuelve el estado, video_url, thumbnail_url, la duración y los detalles de cualquier fallo, así que es la que hay que llamar cuando un render parece atascado.
La traducción usa tres herramientas: list_video_translate_languages para consultar los códigos válidos, create_video_translate para iniciar el trabajo y get_video_translate_caption para obtener después los subtítulos. HeyGen ofrece modos de velocidad y de precisión, así que un borrador rápido y una versión final pulida pueden salir del mismo video original. PicassoIA incluye la misma familia como Video Translate para doblar a más de 150 idiomas, además de Lipsync Precision y Lipsync Speed.
Los lotes de traducción aceptan hasta 100 elementos por solicitud, lo que hace realista localizar una biblioteca de formación completa en una tarde.
| Grupo | Qué hace | Solicitud de ejemplo |
|---|---|---|
| Video Agent | Videos de una sola toma y de varios turnos, lista de estilos, detener una ejecución | "Haz un video de incorporación de 45 segundos" |
| Creación de videos | Videos con avatar y sincronización labial, listar, consultar, eliminar | "Renderiza este guion con mi avatar" |
| Plantillas | Crear, actualizar, rellenar variables, generar a partir de una plantilla | "Rellena mi plantilla de webinar con este título" |
| Voces | Voces del catálogo de más de 500, diseño de voz, clonación, voz con marcas de tiempo | "Diseña una voz cálida y grave para narración" |
| Lotes | Hasta 100 elementos para videos, traducciones, sincronización labial y cargas | "Traduce estos 40 videos al español" |
| Extras | Recorte con IA, búsqueda de audio, creación de avatares, kits de marca, glosarios, eliminación de muletillas, carpetas | "Corta tres clips cortos de este webinar" |
Retry-After.
| Síntoma | Causa probable | Solución |
|---|---|---|
| La pestaña OAuth se abre pero Claude sigue mostrando desconectado | Ventana emergente bloqueada o cuenta incorrecta | Permite las ventanas emergentes, vuelve a conectar y luego ejecuta get_current_user |
| Faltan herramientas de HeyGen en un chat | El conector no está activado en esa conversación | Actívalo en el menú de herramientas del chat |
| HTTP 409 en un documento del editor de video | El documento todavía se está preparando | Espera un momento y vuelve a intentarlo |
| HTTP 403 en una voz de ElevenLabs | La política del proveedor del espacio de trabajo bloquea ese motor | Elige otro motor de voz o pide ayuda al administrador del espacio de trabajo |
| HTTP 404 en un avatar o una voz | El elemento se eliminó | Vuelve a listar y elige un ID nuevo |
| HTTP 429 | Se alcanzó el límite de tasa | Espera y respeta Retry-After |
| Claude informa de éxito pero no da enlace | No se consultó el estado | Pídele que llame a get_video e imprima video_url |
Los motores de HeyGen no están encerrados dentro de la aplicación de HeyGen. PicassoIA incluye varios de ellos junto a otros modelos de video que hablan, lo que resulta útil para hacer pruebas A/B con el mismo guion.
| Modelo | Qué hace | Enlace |
|---|---|---|
| Avatar V | Avatar que habla a partir de un guion escrito, hasta 4K | Abrir Avatar V |
| Avatar IV | Avatar que habla, motor anterior de HeyGen | Abrir Avatar IV |
| Video Agent | Video pulido a partir de un prompt de texto | Abrir Video Agent |
| Video Translate | Dobla un video a más de 150 idiomas | Abrir Video Translate |
| Omni Human 1.5 | Video realista con sincronización labial a partir de una sola foto | Abrir Omni Human 1.5 |
| P Video Avatar | Videos con avatar que habla, de Pruna | Abrir P Video Avatar |
| Kling Avatar v2 | Anima un rostro para convertirlo en un video que habla | Abrir Kling Avatar v2 |
Los guiones importan tanto como los renders. Los modelos de lenguaje de PicassoIA, como Claude Sonnet 5, Claude Fable 5 y Claude Opus 4.7, pueden redactar y pulir un guion antes de que llegue a cualquier herramienta de avatares. Así tienes una división clara: escribe con un modelo de lenguaje, renderiza con un modelo de avatar y mantén cada paso fácil de repetir.
La ruta MCP encaja con quienes viven dentro de Claude. Si prefieres rellenar un formulario, Avatar V en PicassoIA convierte un guion escrito en un video de cabeza parlante sin cámara, estudio ni actores.
| Ajuste | Opciones | Predeterminado | Consejo |
|---|---|---|---|
| resolution | 720p, 1080p, 4k | 1080p | Haz borradores a 720p y entrega a 1080p o 4k |
| aspect_ratio | 16:9, 9:16 | 16:9 | Usa 9:16 para clips sociales de formato corto |
| voice_speed | 0,5 a 1,5 | 1 | Baja a 0,9 para guiones técnicos densos |
| caption | activado o desactivado | desactivado | Actívalo para espectadores que ven el video sin sonido |
| title | texto libre | vacío | Pon nombre a cada versión para que las pruebas se ordenen |
💡 Dos hábitos con guion que compensan: mantén las frases lo bastante cortas para decirlas de un tirón y escribe los números y las siglas tal como quieres que se pronuncien.
Ahora tienes dos caminos hacia el mismo resultado. Conecta HeyGen a Claude cuando quieras que la creación de videos ocurra dentro de una conversación, con una frase que lance un render. Usa PicassoIA cuando prefieras elegir los ajustes tú mismo y comparar motores lado a lado.
Elige un guion corto que ya tengas, quizá una introducción de producto o un paso de formación, y pásalo por Avatar V a 720p. Luego envía el mismo material a Video Translate para escucharlo en un segundo idioma. Diez minutos de experimentación en PicassoIA te dirán más sobre tu propio flujo de trabajo que cualquier ficha técnica. Abre la plataforma, prueba un modelo y crea tu primer video con avatar hoy.
Elige tu idioma
