Servidor MCP
El servidor MCP permite que un asistente de IA trabaje en tu cuenta de Evocal: enviar un video, iniciar el doblaje, revisar y corregir segmentos y descargar los archivos. Usa tu clave de API, con los mismos créditos y reglas que la app.
Antes de empezar
- El servidor MCP forma parte de los planes Pro, Studio y Enterprise, como la API.
- Crea una clave en la app, en Cuenta, API. Dale al asistente una clave propia, para poder revocarla sin detener nada más.
- Tu asistente debe permitirte añadir un servidor MCP remoto con un encabezado. Los agentes que trabajan en una terminal y los editores de código lo permiten; las apps de chat que solo se conectan iniciando sesión todavía no pueden usarlo.
Cómo conectarlo
La dirección del servidor es https://www.evocal.app/api/mcp (Streamable HTTP). Recibe la clave en el encabezado Authorization. Por ejemplo, en Claude Code:
claude mcp add --transport http evocal https://www.evocal.app/api/mcp \
--header "Authorization: Bearer evk_..."Los editores que guardan sus servidores en un archivo JSON aceptan una entrada como esta. Consulta la guía de tu editor para saber el nombre del archivo y su forma exacta.
{
"mcpServers": {
"evocal": {
"url": "https://www.evocal.app/api/mcp",
"headers": { "Authorization": "Bearer evk_..." }
}
}
}Luego pide, por ejemplo: «Dobla lesson-4.mp4 del portugués al inglés y dime cuánto cuesta antes de empezar».
Lo que puede hacer el asistente
| Herramienta | Qué hace |
|---|---|
get_account | El plan y los créditos ahora. |
list_languages | Los pares de idiomas abiertos ahora. |
list_projects | Tus proyectos, del más reciente al más antiguo. |
get_project | Un proyecto, con el estado de su archivo y sus doblajes. |
create_project | Crea un proyecto con un doblaje para cada idioma de destino. |
start_upload | Abre la subida del archivo y da las direcciones de las primeras partes. |
get_upload_part_urls | Direcciones para más partes, o nuevas para las partes que fallaron. |
complete_upload | Termina la subida; luego se revisa el archivo. |
start_dub | Inicia un doblaje. Gasta créditos. |
get_job | El estado y el avance de un trabajo. |
get_dub | Un doblaje, con el último trabajo que se ejecutó en él. |
get_segments | Los segmentos del doblaje: tiempos, textos y avisos. Puede mostrar solo los que tienen avisos o ediciones. |
edit_segment | Guarda un texto nuevo para un segmento. |
quote_regeneration | Cuánto cuesta regenerar algunos segmentos. |
regenerate_segments | Regenera segmentos con sus textos guardados. Gasta créditos. |
finish_dub | Termina la edición y abre las descargas. |
get_download_links | Enlaces a los archivos del doblaje, válidos durante 5 minutos. |
get_subtitles | Los subtítulos como texto, en SRT o WebVTT. |
delete_project | Borra un proyecto con sus archivos y doblajes. |
Cómo enviar el archivo
El asistente lee el archivo en tu computadora y lo envía por partes, así que debe ejecutarse donde está el archivo, con una terminal o acceso a tus archivos. Corta el archivo en partes de part_size bytes y envía cada una con un PUT a su dirección.
Un asistente que no puede llegar a tus archivos aún puede trabajar en los proyectos que envías en la app: leer los segmentos, corregirlos, regenerar y descargar.
Créditos y seguridad
- El asistente gasta tus créditos: un doblaje cuesta un crédito por segundo de video (mínimo 30) y una regeneración, los segundos de sus segmentos (mínimo 15). El servidor le indica que te diga el costo y espere tu sí antes de cualquiera de los dos, pero respondes por cada llamada hecha con tu clave.
- Terminar un doblaje y borrar un proyecto no se pueden deshacer. Al asistente se le indica que te pregunte antes.
- Cada archivo sigue las mismas reglas que en la app: envía solo voces que sean tuyas o de personas que te dieron permiso por escrito. La confirmación de voz de la clave cubre cada archivo.
- Sus llamadas cuentan en los límites de la API: 120 por minuto y 3.600 por hora para toda la cuenta.
- El asistente ve lo que muestra la API: tus proyectos, doblajes, segmentos y créditos. Si la clave se filtra, revócala en Cuenta, API.