Documentación

Vecipp Editor es un editor de video para publicidad, con dos mitades sobre el mismo proyecto: vos editás con el mouse, Claude edita con herramientas, y cada uno ve lo que hizo el otro.

Qué es

El caso que manda sobre todas las decisiones del producto es un aviso vertical de 15 a 30 segundos para Reels, TikTok o Shorts: gancho en los primeros dos segundos, texto legible sin sonido, ritmo cortado y un cierre con llamada a la acción.

Un modelo de lenguaje no ve ni oye el video. Por eso el editor no expone "un comando de ffmpeg por herramienta", sino tres cosas distintas:

Percepción antes que acción. Claude puede mirar el resultado: una imagen con todos los frames del timeline, un frame puntual, la geometría del texto medida en píxeles, el mapa de silencios del audio.
El timeline es estado, no comandos. El proyecto es un JSON con clips, textos y audio. Editar es gratis y reversible; nada se renderiza hasta que se pide.
El candado. La exportación final se bloquea si el timeline actual no pasó por una revisión visual. Lo impide el servidor, no una recomendación.

Primeros pasos

Creá un proyecto. En Proyectos → Proyecto nuevo. Elegí formato (vertical 9:16 para Reels y TikTok), resolución y cuadros por segundo. Todo esto se puede cambiar después sin perder la edición.
Importá material. Con el botón Importar, arrastrando archivos sobre la ventana, o pegando el link directo de un archivo con URL. Los videos entran al timeline; los audios entran como pista de fondo al 25%.
Montá. Arrastrá los bordes de un bloque para recortarlo, movelo, dividí en el cursor con S, borrá con Supr. Si el material es hablado, Quitar silencios rehace la pista dejando sólo los tramos con voz.
Si el material es horizontal, poné el encuadre en blur: rellena las bandas con el mismo plano ampliado y desenfocado, que es lo que se usa en vertical. Evitá las bandas negras.
Ritmo. Acelerá un plano que se arrastra desde Velocidad, y poné una transición de entrada donde el corte seco no funcione — dissolve para encadenar, whip_pan para el corte rápido de vertical. Los dos clips se solapan, así que el video se acorta esa cantidad.
Poné el texto. Botón Texto. En vertical, la franja segura es y entre 0.15 y 0.78 — fuera de ahí lo tapa la interfaz de la app. El panel de propiedades avisa.
Mirá antes de exportar. El botón de reproducir renderiza un preview con marca de agua. Exportar hace el render final y lo descarga.

El editor

Tres paneles y una línea de tiempo, como cualquier editor no lineal:

Panel	Qué hay
Proyecto (izquierda)	Datos de la secuencia, biblioteca de archivos importados con miniatura, y las acciones que no dependen de la selección.
Programa (centro)	El frame real del instante donde esté el cursor, con los textos ya dibujados encima. No es una maqueta: es el mismo motor que exporta.
Propiedades (derecha)	Lo que se puede tocar del bloque seleccionado: recorte, encuadre, velocidad y transición de entrada de un clip; contenido, posición y aspecto de un texto; volumen y fundidos de un audio.
Línea de tiempo (abajo)	Tres pistas — V1 video, T1 texto, A1 audio — con regla, zoom y cursor de reproducción.

La biblioteca guarda cada archivo importado: se puede volver a usar sin subirlo de nuevo, con el botón + de su miniatura. Sólo se puede sacar un archivo si ninguna pista lo usa.

Atajos de teclado

Tecla	Qué hace
S	Dividir el clip en el cursor
Supr	Borrar lo seleccionado
← →	Mover el cursor un cuadro
Shift + ← →	Mover el cursor un segundo
Inicio Fin	Ir al principio o al final
Esc	Cerrar el diálogo abierto

Conectar Claude

El editor también es un servidor MCP remoto. Pegando una URL en Claude, Claude puede crear proyectos, importar videos, cambiar el formato, cortar, poner textos y música, mirar el resultado y exportar — sobre los mismos proyectos que ves en la interfaz.

Funciona desde claude.ai (Configuración → Conectores → Agregar conector personalizado), desde Claude de escritorio y desde Claude Code. La URL con el token, los pasos y el comando están en la página de conexión.

Esa URL lleva un token secreto: quien la tenga puede editar y exportar tus videos. No la publiques. Si se filtró, generá una nueva desde la misma página — la anterior queda invalidada al instante.

Cómo se arma un aviso

El servidor da los primitivos; el criterio lo pone la skill vecipp-ads, que se instala junto al conector. Este es el resumen de lo que aplica:

Estructura de 15 segundos

Tramo	Función
`0.0 – 1.5s`	Gancho — el problema, o la imagen más fuerte que tengas
`1.5 – 4.0s`	Tensión — por qué eso molesta
`4.0 – 9.0s`	Producto — qué es y cómo lo resuelve
`9.0 – 12.5s`	Prueba — beneficio concreto, cifra, resultado
`12.5 – 15s`	Cierre — marca, acción clara y dónde

Reglas que más cambian el resultado

Los primeros 1,5 segundos deciden si el resto se ve. El mejor plano va primero, no al final. Nunca abrir con el logo.
Ritmo: ningún plano de más de 2,5 segundos sin que algo cambie. En 15 segundos, entre 6 y 9 cortes.
Se ve sin sonido. Si el mensaje sólo existe en el audio, el aviso no comunica.
Máximo 6 palabras por pantalla, mínimo 1,2 segundos en pantalla, nunca dos textos a la vez.
Zonas seguras en vertical: arriba de y=0.12 está la barra de estado, debajo de y=0.80 están el usuario y la descripción, y a la derecha de x=0.82 los botones de la app.
Música bajo una voz: volumen entre 0.15 y 0.25, nunca más de 0.3, con un fundido de salida de al menos un segundo.
Mirar antes de exportar, siempre: la revisión visual es lo que separa un aviso presentable de uno que "técnicamente se armó".

Si edita Claude

Tres herramientas cambian el resultado más que las demás:

timeline_batch arma el aviso entero en una sola llamada, todo o nada. Con dry_run simula primero. Es la diferencia entre una conversación de veinte pasos y una de uno.
timeline_validate encuentra los problemas típicos antes de renderizar: planos que se arrastran, texto que no se llega a leer, dos textos a la vez, música más corta que el video.
safe_area_check dice qué cae bajo la interfaz de cada plataforma. Es el error más caro y el más difícil de ver en un frame suelto.

Herramientas MCP

Esta lista se genera del servidor en vivo: es exactamente lo que Claude ve al conectarse. Hacé clic en una para ver sus parámetros.

cargando…

API REST

La interfaz web usa esta API. Sirve igual para automatizar desde afuera.

Ruta	Qué hace
`GET /api/projects`	Lista de proyectos
`POST /api/projects`	Crear — `name`, `preset`, `resolution`, `fps`
`GET /api/p/:id`	Proyecto completo, resumen, estado del candado y renders
`PATCH /api/p/:id`	Nombre y lienzo (formato, resolución, fps, fondo)
`POST /api/p/:id/duplicate`	Copia con IDs nuevos
`DELETE /api/p/:id`	Borrar
`POST /api/p/:id/media`	Subir archivos (multipart, varios a la vez)
`POST /api/p/:id/media/url`	Importar desde un link directo
`GET /api/p/:id/media/:mid/thumb`	Miniatura de un archivo
`POST /api/p/:id/clip`	Agregar al timeline un medio de la biblioteca
`PATCH /api/p/:id/clip/:cid`	Recorte, encuadre y volumen
`POST /api/p/:id/cut-silences`	Rehacer la pista dejando sólo la voz
`GET /api/p/:id/frame?t=`	Frame compuesto de un instante
`GET /api/p/:id/layout`	Geometría real de los textos
`POST /api/p/:id/render`	`{"kind":"preview"}` o `{"kind":"final"}`
`GET /api/tools`	Catálogo de herramientas MCP (lo que muestra esta página)
`GET /health`	Estado del servicio

Límites y preguntas

¿Genera video?

No. Vecipp edita. El material entra desde archivos, desde un link directo, o desde otra herramienta de generación conectada a la misma sesión de Claude.

¿Hay subtítulos automáticos?

Todavía no. Transcribir audio necesita un modelo de unos 2 GB y esta máquina no los tiene libres. El corte por silencios cubre la parte de ritmo sin necesidad de texto.

¿Cuánto tarda un render?

Un aviso vertical de 15 segundos, unos segundos. El render final bloquea hasta terminar: sirve para clips cortos, no para videos largos. No hay GPU en esta máquina.

¿Quién puede entrar?

Hoy, cualquiera que conozca la dirección: el editor web todavía no tiene login. Está anotado como la prioridad siguiente. El servidor MCP sí exige token.

¿Qué tipografías hay?

Inter, Montserrat, Open Sans, Roboto, Liberation y DejaVu, con sus pesos de light a black. La lista exacta la da font_list. Para títulos de aviso, Montserrat Black o Inter Black; para frases largas, las condensadas. Todavía no se puede subir la tipografía de una marca.

¿Se pierde algo al cambiar la resolución?

No. El timeline queda igual y los textos se reescalan con la altura del lienzo para que se sigan viendo igual de grandes. Se puede deshacer.