Claude puede solicitar la creación de videos mediante un servicio conectado como AKOOL MCP. En este flujo, Claude Code envía una tarea de imagen a video, consulta su estado y recupera el resultado. AKOOL genera el video. Claude proporciona la interfaz de chat para describir, revisar y gestionar la tarea.
Si quieres generar video con IA desde Claude, la distinción clave es que Claude no es el modelo de renderizado. La plataforma de creación de video con IA de AKOOL proporciona las herramientas mediante su conexión Model Context Protocol.
Resumen rápido
- Conecta: añade el servidor AKOOL MCP a Claude Code con tu AKOOL Client ID y Client Secret.
- Prepara: comprueba que el flujo pueda acceder a la imagen de origen aprobada antes de enviar la generación.
- Genera: descubre primero las herramientas y los modelos; después envía una tarea
video_image2video_createy guarda su identificador. - Guarda: consulta el trabajo existente con
video_image2video_resultsy guarda el video terminado en vez de reenviar la solicitud.
Contenido
- ¿Puede Claude generar videos?
- ¿Qué necesitas para generar videos con Claude Code?
- ¿Cómo conectas el servidor AKOOL MCP?
- ¿Cómo se ejecuta una tarea MCP de imagen a video?
- ¿Qué prompts de video para Claude conviene usar?
- ¿Cómo solucionas problemas de automatización de video con IA?
- ¿Cómo funcionan los créditos y la selección de modelos?
- Preguntas frecuentes
¿Puede Claude generar videos?
Claude puede iniciar una generación de video cuando está conectado mediante MCP a un servicio de renderizado. Claude Code interpreta la solicitud, Model Context Protocol conecta Claude con las herramientas de AKOOL y AKOOL realiza la generación de imagen a video. Después, Claude consulta el trabajo asíncrono y devuelve el resultado terminado.
| Layer | Role | What it does |
|---|---|---|
| Claude Code | Client and conversational interface | Understands your instruction and invokes tools |
| Model Context Protocol | Connection layer | Exposes AKOOL functions as tools Claude can discover and call |
| AKOOL | Generation service | Runs the image-to-video job and returns its result |
La documentación oficial de AKOOL MCP incluye actualmente account_models, account_credit, video_image2video_create y video_image2video_results, entre otras herramientas. Para conocer otras integraciones, consulta servidores MCP para generar video con IA.
¿Qué necesitas para generar videos con Claude Code?
Necesitas Claude Code, una cuenta AKOOL con credenciales API válidas, suficientes créditos para la generación elegida y una imagen aprobada accesible desde el flujo conectado. El acceso a Claude y el pago de las generaciones de AKOOL son independientes.
Prepara estas cuatro cosas:
- Claude Code. Esta guía utiliza Claude Code, no Claude Desktop.
- AKOOL Client ID y Client Secret. AKOOL usa las cabeceras
x-client-idyx-client-secretpara autenticar MCP. - Créditos de generación. Usa
account_creditpara consultar tu saldo de AKOOL. - Una imagen aprobada. Utiliza una imagen propia o que tengas permiso para transformar.
Para preparar un recurso adecuado, consulta el flujo de imagen a video de AKOOL.
Una fotografía clara de un producto es una buena primera prueba: permite comprobar si el producto sigue siendo reconocible mientras se realiza el movimiento de cámara solicitado.
¿Cómo conectas el servidor AKOOL MCP?
Utiliza la vía documentada de AKOOL para Claude Code. El endpoint es https://openapi.akool.com/mcp/v1 y se autentica con las cabeceras x-client-id y x-client-secret. No incluyas estas credenciales en prompts, capturas, repositorios ni documentación publicada.
Instala Claude Code si es necesario:
npm install -g @anthropic-ai/claude-code
Después añade el servidor AKOOL MCP. Esta versión del comando documentado evita escribir las credenciales directamente:
claude mcp add akool-mcp https://openapi.akool.com/mcp/v1 \
--header "x-client-id: $AKOOL_CLIENT_ID" \
--header "x-client-secret: $AKOOL_CLIENT_SECRET"
AKOOL recomienda guardar los secretos en variables de entorno en lugar de incorporarlos al control de versiones.
Verifica la conexión:
claude mcp list
Deberías ver una entrada para el servidor AKOOL, por ejemplo:
akool-mcp http https://openapi.akool.com/mcp/v1
Consulta las instrucciones oficiales de configuración de AKOOL MCP para conocer el comando y los detalles actuales. No copies credenciales en una captura.
¿Cómo se ejecuta una tarea MCP de imagen a video?
El flujo más seguro separa descubrimiento, envío, consulta de estado y recuperación. Una nueva generación puede consumir créditos. Para consultar un trabajo existente, reutiliza su identificador en lugar de enviar otra generación.
1. Descubre las herramientas y los modelos disponibles
Pide a Claude:
Enumera las herramientas AKOOL disponibles en esta sesión. Identifica las herramientas de creación de imagen a video y de resultados, y muestra las entradas necesarias sin iniciar una generación.
Busca video_image2video_create y video_image2video_results. AKOOL también proporciona account_models para consultar los modelos disponibles en la cuenta conectada.
2. Prepara la imagen
Utiliza una imagen estable, con derechos de uso verificados y un sujeto claro.
Ejemplo:
/product-assets/blue-bottle-approved.png
No dependas de una ruta local salvo que Claude Code y la herramienta puedan acceder realmente a ella.
3. Planifica antes de enviar
Pide a Claude:
Usa mi imagen de producto aprobada como origen. Planifica un clip corto con un acercamiento lento y el producto inmóvil. Antes de enviarlo, muestra el modelo propuesto, los ajustes admitidos y cualquier información disponible sobre el coste.
Este paso es de planificación. No debe iniciar una generación de pago.
4. Envía una sola tarea
Tras revisar la propuesta:
Envía una vez la solicitud de imagen a video acordada. Usa un movimiento de cámara suave, mantén el producto inmóvil y devuelve el identificador de la tarea.
AKOOL documenta video_image2video_create como herramienta de creación.
Guarda inmediatamente el identificador devuelto:
Task ID: [SAVED_TASK_ID]
5. Consulta la misma tarea
Pide:
Consulta la tarea existente con su identificador guardado. Indica si está en cola, en proceso, completada o fallida. No crees otra tarea.
AKOOL explica que muchas herramientas MCP son asíncronas y usan herramientas de resultados para consultar su finalización.
6. Guarda el resultado
Una vez terminado:
Devuelve el enlace del video terminado y su ubicación de guardado. Compáralo con la imagen original. Propón un cambio de movimiento para otro intento, conservando el resultado original.
Un ciclo de vida sencillo es:
account_models
↓
video_image2video_create
↓
[SAVED_TASK_ID]
↓
video_image2video_results
↓
queued → processing → complete
↓
[RESULT_URL]
¿Qué prompts de video para Claude conviene usar?
Utiliza prompts que indiquen claramente el estado de la tarea. La diferencia de seguridad principal es si la instrucción solo revisa la sesión o crea una nueva generación de pago.
| Prompt | What it does | New generation? |
|---|---|---|
| 1. Discovery | Inspects tools and required inputs | No |
| 2. Planning | Reviews model/settings before submission | No |
| 3. Generation | Submits the image-to-video task | Yes |
| 4. Status | Checks the saved task | No |
| 5. Save and revise | Retrieves output and proposes a revision | No, unless you approve another run |
Prompt 1: descubrimiento
Enumera las herramientas AKOOL disponibles en esta sesión. Identifica las herramientas de creación de imagen a video y de resultados, y muestra las entradas necesarias sin iniciar una generación.
Prompt 2: planificación
Usa mi imagen de producto aprobada como origen. Planifica un clip corto con un acercamiento lento y el producto inmóvil. Antes de enviarlo, muestra el modelo propuesto, los ajustes admitidos y cualquier información disponible sobre el coste.
Prompt 3: generación
Envía una vez la solicitud de imagen a video acordada. Usa un movimiento de cámara suave, mantén el producto inmóvil y devuelve el identificador de la tarea.
Prompt 4: estado
Consulta la tarea existente con su identificador guardado. Indica si está en cola, en proceso, completada o fallida. No crees otra tarea.
Prompt 5: guardar y revisar
Devuelve el enlace del video terminado y su ubicación de guardado. Compáralo con la imagen original. Propón un cambio de movimiento para otro intento, conservando el resultado original.
Estos prompts de video para Claude separan deliberadamente la planificación de la ejecución. Resulta útil en cualquier flujo de automatización de video con IA donde un segundo envío accidental pueda consumir más créditos.
¿Cómo solucionas problemas de automatización de video con IA?
Comprueba la tarea actual y la conexión antes de reenviar nada. Muchos fallos son problemas de autenticación, acceso a archivos o estado asíncrono, no motivos para crear otra generación.
| Symptom | First check | Next action |
|---|---|---|
| AKOOL tools are missing | claude mcp list | Recheck MCP setup and restart Claude Code |
| Authentication fails | Client ID and secret | Verify credentials in AKOOL dashboard |
401 Unauthorized | MCP headers | Replace invalid credentials |
| Source image cannot be used | File accessibility | Move or upload the asset somewhere the workflow can access |
| Job stays queued | Saved task ID | Poll the same job later |
| Result says failed | Existing result response | Read the failure before changing inputs |
| No download available | Job status | Confirm task is actually complete |
| Download link expired | Stored output/state | Retrieve a fresh available result rather than blindly regenerate |
| Two jobs appear | Task history | Confirm whether generation was submitted twice |
AKOOL indica expresamente que 401 Unauthorized requiere verificar las credenciales de la cuenta.
¿Cómo funcionan los créditos y la selección de modelos?
Usa las herramientas de modelos y créditos de la cuenta conectada, sin asumir que todos los modelos del sitio de AKOOL están disponibles en la tarea MCP actual. La disponibilidad depende de la cuenta y el esquema de la herramienta; el coste puede variar por modelo y ajustes.
Utiliza:
account_modelspara descubrir los modelos disponibles.account_creditpara consultar el saldo actual.- Los ajustes o presupuestos devueltos por la herramienta de imagen a video, cuando existan, para entender la tarea pendiente.
La interfaz habitual Image-to-Video de AKOOL también indica que los precios varían según el modelo.
No publiques los créditos descontados en una respuesta API concreta como precio universal de la generación de video con Claude Code. El modelo, la resolución, la duración, la cuenta y los precios actuales pueden cambiar.
La plataforma principal de AKOOL ofrece más modelos, pero eso no demuestra que todos estén expuestos en cada flujo MCP.
Genera tu primer video mediante Claude Code
El patrón útil es sencillo: descubrir → planificar → enviar una vez → guardar el ID → consultar → recuperar.
Esto facilita depurar el flujo MCP de generación de video y reduce la confusión entre consultar el estado y generar un segundo video de pago.
Para explorar directamente estas funciones, abre la plataforma de creación de video con IA de AKOOL. Para configurarla, consulta la documentación oficial de AKOOL MCP.
