The short version
Tutorial práctico con una fuente pública, cinco herramientas MCP reales, un brief de 30 segundos y una prueba honesta.
Claude puede coordinar el flujo, pero no renderiza el video. Conecté Claude a TapVid MCP, usé la página pública de API y MCP como fuente y pedí un explainer en inglés de 30 segundos y 16:9. La prueba revela la secuencia, el estado asíncrono y los controles humanos.
Review TapVid API and MCP access
01
Claude coordina y TapVid renderiza
“Claude video generation” no significa que Claude dibuje fotogramas o exporte el MP4. Claude interpreta el objetivo, llama herramientas y observa respuestas. TapVid procesa la fuente, estructura escenas y renderiza. MCP conecta ambos sistemas y ayuda a localizar si un fallo pertenece al brief, los argumentos, el render o la revisión.
TapVid transforma artículos, documentos, guiones, PDF, PRD o páginas de producto existentes en videos informativos estructurados. La fuente aporta hechos y el prompt aporta audiencia y límites. Una persona conserva la responsabilidad sobre precisión, derechos, ritmo y publicación. Una escena se puede regenerar sin reconstruir el resto del video.
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 usa la misma API key Bearer para REST y MCP. Créala en API Keys, guárdala como secreto y conecta Claude a https://mcp.tapvid.ai/mcp. Ejecuta primero `get_account` para validar la conexión antes de gastar créditos.
- 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`.
- Carga una URL HTTPS aprobada con `upload_material`.
- Define duración, formato, idioma, audiencia y prohibiciones antes de crear.
03
Las herramientas MCP observadas
La prueba medida de creación y exportación usó cinco herramientas. El conector actual también incluye `edit_video`; esa sexta herramienta no se llamó en la prueba.
| Herramienta | Función | Límite |
|---|---|---|
| `get_account` | Validar conexión | Ocultar email |
| `upload_material` | Ingerir URL | ID privado |
| `create_video` | Iniciar trabajo | ID privado |
| `get_video_status` | Consultar estado | Respetar intervalo |
| `get_video_download` | Preparar export | URL temporal |
| `edit_video` | Editar un video completado | No usado en la prueba medida |
El brief fijó 30 segundos, 16:9, inglés, audiencia desarrolladora, la página de TapVid como fuente, las etapas de material, generación asíncrona y descarga, y prohibió cifras o resultados inventados.
04
Qué ocurrió en la prueba real
El 7 de agosto de 2026, la carga de URL tardó unos 0,4 segundos y `create_video` unos 0,3. El trabajo llegó a running 50 por ciento cerca del segundo 60, permaneció allí más de 18 minutos y terminó a los 28 minutos 20 segundos. El primer export siguió en recording 36 segundos; una consulta posterior entregó la URL firmada. El uso aumentó 90 créditos.
El progreso no es un reloj lineal. El cliente debe respetar `pollAfterSeconds`, conservar el video ID, aplicar un tiempo máximo global y comunicar el último estado. Solo debe pedir la descarga después de completed.
05
Cómo resolver fallos de MCP
La primera llamada de cuenta también tuvo un fallo transitorio de transporte. Red, autenticación, parámetros, créditos y trabajos largos necesitan respuestas distintas. Solo los fallos transitorios de lectura deben reintentarse con límites.
| Síntoma | Capa | Acción |
|---|---|---|
| Fallo de transporte | Red | Reintento limitado de lectura |
| 401 | Clave | Revisar secreto |
| 400 | Argumentos | Corregir campos |
| Sin créditos | Cuenta | Detener |
| 50 por ciento prolongado | Job asíncrono | Guardar ID, intervalo y timeout |
Una respuesta perdida no prueba que el create falló. Si el servidor lo aceptó, crear otro trabajo puede duplicar el gasto. Guarda material ID y video ID inmediatamente.
06
Revisa el video antes de publicarlo
Un export terminado sigue siendo un borrador. Compara narración y texto con la fuente, verifica orden, duración, subtítulos, formato, música, derechos y CTA. Claude ayuda con la lista, pero no sustituye la aprobación humana.
- 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
MCP funciona bien para exploración conversacional. REST funciona mejor para estado durable, reintentos, métricas, colas y programación. Cambia quién controla la orquestación, no el objetivo del trabajo.
| Necesidad | MCP | REST |
|---|---|---|
| Explorar prompt | Ideal | Manual |
| Diagnóstico interactivo | Ideal | UI propia |
| Estado durable | Depende de sesión | Propio de app |
| Reintentos y métricas | Depende del cliente | Programable |
| Volumen | No predeterminado | Ideal |
Probaría el prompt y los criterios mediante MCP y movería trabajos repetibles a REST. Elige según la necesidad de diálogo o control determinista.
08
Protege la clave y los créditos
La API key puede gastar créditos y acceder a recursos. No la pegues en prompts, capturas o repositorios. Separa lectura, generación y publicación y consulta la guía de seguridad MCP.
- 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
Empieza con una página aprobada, una audiencia, un mensaje, un formato y 30 segundos. Pide a Claude la secuencia, registra estados y créditos y revisa el resultado contra la fuente. Consulta la visión general de TapVid API y MCP.
10
Preguntas frecuentes
¿Claude genera el video por sí solo?
No. Claude planifica y llama a TapVid mediante MCP; TapVid renderiza.
¿Qué herramientas estaban disponibles?
El conector actual incluye get_account, upload_material, create_video, get_video_status, get_video_download y edit_video. La prueba medida usó las primeras cinco.
¿Usa OAuth?
La configuración actual probada usa una API key Bearer. Verifica la documentación vigente.
¿Por qué hacer polling?
La generación es asíncrona. Respeta pollAfterSeconds hasta un estado terminal.
¿Cuándo usar REST?
Cuando necesitas estado durable, programación, reintentos y métricas.
Kenneth Chen te invita a conversar con otros creadores de vídeo en Discord.
Únete a Kenneth en DiscordTurn them into a clear, publishable video
Keep reading
Related stories
Generación de vídeo con Claude: ¿Seedance 2.5 o TapVid?
La generación de vídeo de Claude necesita una herramienta de renderización. Aprende cuándo emparejar a Claude con Seedance 2.5 o TapVid, con indicaciones y un flujo de trabajo práctico.
Aug 8, 2026
API de texto a video: integración en 10 minutos
Integra el flujo REST en unos diez minutos y trata el render como un trabajo asíncrono durable.
Aug 7, 2026
¿Qué es un video explicativo? Tipos, usos y cómo hacer uno
¿Qué es un video explicativo? Un video corto que explica un producto o una idea rápido. Conoce los tipos, cuándo usar cada uno y cómo hacer el tuyo.
Jul 17, 2026