Cómo crear motion graphics con Claude y TapVid MCP

01

Claude coordina y TapVid renderiza

La frase "generación de vídeo de Claude" puede sugerir que Claude pinta directamente marcos, anima capas, mezcla audio y exporta un MP4. Eso no es lo que pasa aquí. Claude lee el objetivo, decide a qué herramienta externa llamar, proporciona argumentos estructurados, observa el resultado y continúa el flujo de trabajo. TapVid recibe el material fuente, construye el vídeo explicativo, ejecuta el trabajo de generación y prepara la exportación. MCP es la conexión escrita entre esos dos sistemas. Este límite importa porque te dice dónde depurar. Un prompt débil es un problema de planificación. Un parámetro rechazado es un problema de llamada de herramienta. Un renderizado lento es un problema de servicio de generación. Una escena engañosa es un problema de fuente y revisión.

TapVid convierte el contenido existente, como un artículo, documento, guión, PDF, PRD o página de producto, en un vídeo informativo estructurado de varias escenas. Eso es diferente a pedirle a un modelo de texto a vídeo en bruto una toma cinematográfica de cinco segundos. La fuente le da al sistema hechos y estructura. El prompt proporciona audiencia, duración, dirección visual y exclusiones. Claude puede mantener esas restricciones visibles mientras llama a las herramientas, pero una persona todavía posee la aprobación fáctica, el ritmo, los derechos y la liberación final. Para las agencias y pequeñas empresas, el valor práctico es la escala: un límite de fuente claro y las repeticiones a nivel de escena reducen la cantidad de revisión y reconstrucción de vídeo completo requerida cuando una escena necesita corrección.

El clip insertado es una referencia externa de Motion MCP creada por Motion, no el resultado de nuestra prueba con TapVid. Las pruebas verificadas de TapVid aparecen después en las capturas y el registro de tiempos.

02

Conecta Claude con una API key Bearer

La configuración pública actual utiliza la misma clave API Bearer de TapVid para REST y MCP. Crea una clave en la página de claves API, cópiala cuando aparezca y guárdala según las indicaciones de seguridad del cliente. En Claude Code, añade un conector HTTP personalizado que apunte a https://mcp.tapvid.ai/mcp y configura el encabezado Authorization al crear el conector, nunca en el prompt del chat. La comprobación real `claude mcp list` devolvió `tapvid … Connected`. El servidor usa Streamable HTTP sin estado, por lo que cada llamada a una herramienta es una solicitud autenticada independiente. Empieza con una comprobación de cuenta de solo lectura antes de subir material o gastar créditos. Si falla, corrige la conexión en lugar de enviar una generación a ciegas.

• Crea la API key en `/developer/apikey` y guárdala fuera del prompt.
• Añade el conector `https://mcp.tapvid.ai/mcp` con header Bearer.
• Valida cuenta y créditos con `get_account`.
• Cargue una URL de origen HTTPS aprobada con `upload_material`; use un archivo Base64 solo cuando una URL no esté disponible.
• Define duración, formato, idioma, audiencia y prohibiciones antes de crear.

03

Las herramientas MCP observadas

La ejecución controlada de creación y exportación utilizó cinco herramientas: `get_account`, `upload_material`, `create_video`, `get_video_status` y `get_video_download`. El conector actual y la página oficial de MCP también exponen `edit_video`, que inicia una edición en un vídeo completado y devuelve un ID de edición para la encuesta de estado. Esa sexta herramienta no fue llamada en la ejecución cronometrada. Para demostrar que un cliente de IA, en lugar de un script HTTP escrito a mano, podría invocar el servidor, una sesión de Codex llamada `get_video_status` con el ID de vídeo en vivo y recibió el estado de ejecución al 50 por ciento. La captura de pantalla conserva el nombre de la herramienta, los argumentos, el resultado y el estado del terminal al tiempo que omite las credenciales y las URL firmadas.

El resumen compartido fue intencionalmente específico: crear una explicación concisa de gráficos en movimiento en inglés de 30 segundos, 16:9 para desarrolladores que evalúan la API de TapVid y el acceso a MCP; usar la página de TapVid suministrada como fuente de hecho; explicar que TapVid convierte el contenido existente en un vídeo explicativo estructurado; mostrar la carga de material, la generación asíncrona y la descarga; terminar con una CTA de documentación restringida; no inventar afirmaciones de rendimiento, resultados de clientes o funciones no compatibles. Ese resumen le da a Claude una audiencia, una fuente, una duración, un formato, ritmos requeridos y un límite fáctico. Es mucho más fácil revisar que "hacer un vídeo de producto genial".

04

Qué ocurrió en la prueba real de 30 segundos

El primer flujo controlado con MCP y API se ejecutó contra `https://tapvid.ai/api-mcp` el 7 de agosto de 2026. La comprobación de la cuenta confirmó la capacidad sin mostrar el correo. La carga de la URL respondió en unos 0.4 segundos y `create_video` devolvió un trabajo en cola en unos 0.3 segundos. Terminó tras unos 28 minutos y 20 segundos, y el uso aumentó en 90 créditos. Para esta revisión, una segunda ejecución subió el borrador Markdown completo y solicitó un resumen en inglés de 30 segundos, formato 16:9 y con subtítulos. Entró en cola a las 21:24:33 GMT+8 y terminó a las 21:53:04, unos 28 minutos y 30 segundos después. Una consulta de estado encontró un error transitorio de transporte y funcionó al reintentar dentro del límite. El uso diario subió de 180 a 270 créditos, otra diferencia de 90. TapVid Studio mostró `Video ready`, un reproductor de 0:30, subtítulos y la salida con marca de agua.

Ese resultado es más útil que reemplazar los números con una historia de éxito pulido. Muestra que el progreso no es un reloj lineal y que "50 por ciento" no significa que el tiempo restante sea igual al tiempo transcurrido. Un flujo de trabajo de Claude debe honrar `pollAfterSeconds`, usar un tiempo de espera general razonable, preservar el ID del vídeo e informar al usuario del último estado conocido. Nunca debería declarar la finalización simplemente porque la generación comenzó. La herramienta de descarga pertenece después de un estado completado, no después de un período de espera adivinado.

05

Cómo resolver fallos de MCP

La primera llamada a la cuenta también encontró un fallo de transporte transitorio al punto final de MCP antes de que se lograra un nuevo intento. Los errores de conexión transitorios, los errores de autenticación, el material no válido, los valores de enumeración no compatibles, los créditos insuficientes y los trabajos de larga duración requieren respuestas diferentes. Volver a intentarlo cada fallo no es seguro. Vuelva a intentar fallas de red con retroceso limitado. Arregla un argumento rechazado antes de llamar de nuevo. Detener los créditos insuficientes. Sigue encuestando un trabajo aceptado en lugar de crear un duplicado. Muestra al usuario cuando un trabajo permanece activo más allá de la ventana interactiva normal.

El error costoso más común es tratar una respuesta faltante como prueba de que la llamada de creación falló. Si el servidor aceptó la solicitud pero el cliente perdió su conexión, enviar el mismo vídeo de nuevo puede gastar créditos dos veces. Persista el ID de material devuelto y el ID de vídeo inmediatamente en la aplicación propietaria del flujo de trabajo. En una sesión conversacional, pídale a Claude que repita la última operación de lectura segura, como el estado, antes de permitir otra escritura. Para el código de producción, adjunte su propio registro de idempotencia a la solicitud y registre la respuesta del servidor sin registrar credenciales.

06

Revisa el video antes de publicarlo

Una exportación completada aún necesita revisión editorial. Compare la narración y el texto en pantalla con la página de origen. Comprueba si las escenas explican el flujo de trabajo en el orden prometido. Verifique que un resumen de 30 segundos esté realmente cerca de los 30 segundos. Inspeccione los subtítulos y las referencias clave de la interfaz de usuario en la relación de aspecto prevista. Confirma que la música y el movimiento apoyan la comprensión. Trate el archivo generado como un borrador hasta que esas comprobaciones pasen. Claude puede ayudar a crear una lista de verificación y resumir las diferencias, pero no puede aceptar la responsabilidad legal, fáctica o de marca para el creador.

• Hechos trazables a la fuente.
• Orden correcto de escenas.
• Duración cercana al brief.
• Texto legible en 16:9.
• Derechos y marca revisados.
• Aprobación humana final.

07

MCP para conversación y REST para producción

El MCP es más fuerte cuando el trabajo es exploratorio y conversacional. Puedes darle a Claude una fuente, pedirle que explique las herramientas disponibles, refinar el resumen, ejecutar la secuencia y discutir un fallo en el mismo hilo. REST es más fuerte cuando un producto necesita código estable, almacenamiento de trabajo duradero, reintentos explícitos, métricas e integración con colas o webhooks. Ambas rutas alcanzan los mismos tipos de trabajo subyacentes. La diferencia es quién es el dueño de la orquestación: el cliente de IA en una sesión de MCP, o su aplicación en el código REST.

Para un creador en solitario o comercializador de productos, una secuencia práctica es crear un prototipo de la lista de verificación de prompt y aceptación a través de MCP, y luego mover trabajos repetibles de alto volumen a REST. Para un equipo de ingeniería, REST suele ser la ruta de producción, mientras que MCP se adapta a la depuración, las operaciones internas y la experimentación asistida. No elijas MCP porque suena más nuevo. Elígelo cuando la planificación del lenguaje natural y el uso de herramientas interactivas reduzcan el trabajo real. Elija REST cuando el control determinista, la persistencia y la observabilidad sean más importantes.

08

Protege la clave y los créditos

Una clave API puede gastar créditos y acceder a los recursos propiedad de la cuenta, así que trátala como una credencial de producción. No lo pegue en la conversación, una captura de pantalla, un problema público o el control de código fuente. Limite quién puede crear y revocar claves. Confirme el costo antes de la generación. Mantenga la lectura de la fuente separada del permiso de publicación. Solicite una URL de descarga firmada solo cuando sea necesario, y recuerde que las URL firmadas caducan. La guía de seguridad de MCP es una línea de base útil, pero su aplicación aún necesita su propia autorización, registro y límites de revisión.

• Guardar la clave como secreto.
• No publicar clave, email, IDs ni URL firmada.
• Separar lectura y gasto.
• Persistir IDs aceptados.
• Limitar reintentos.
• Registrar estado sin headers.

09

Empieza con una fuente y un resultado medible

Un buen primer proyecto de generación de vídeo de Claude es lo suficientemente pequeño como para inspeccionarlo, pero lo suficientemente completo como para exponer todo el flujo de trabajo. Elija un artículo o página de producto aprobado, una audiencia, un mensaje, una relación de aspecto y una duración de 30 segundos. Pídele a Claude que indique las llamadas de herramientas planificadas antes de la creación. Registre la respuesta de carga, el trabajo aceptado, las transiciones de estado, los créditos y el resultado del terminal. Luego revise la salida con la fuente en lugar de preguntar si simplemente se ve impresionante. Puede comenzar desde el público TapVid API y MCP overview y mantener el primer experimento intencionalmente estrecho.

10

Preguntas frecuentes