Menú de la documentación

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.

Actualizado el 20 nov 2026

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

HerramientaQué hace
get_accountEl plan y los créditos ahora.
list_languagesLos pares de idiomas abiertos ahora.
list_projectsTus proyectos, del más reciente al más antiguo.
get_projectUn proyecto, con el estado de su archivo y sus doblajes.
create_projectCrea un proyecto con un doblaje para cada idioma de destino.
start_uploadAbre la subida del archivo y da las direcciones de las primeras partes.
get_upload_part_urlsDirecciones para más partes, o nuevas para las partes que fallaron.
complete_uploadTermina la subida; luego se revisa el archivo.
start_dubInicia un doblaje. Gasta créditos.
get_jobEl estado y el avance de un trabajo.
get_dubUn doblaje, con el último trabajo que se ejecutó en él.
get_segmentsLos segmentos del doblaje: tiempos, textos y avisos. Puede mostrar solo los que tienen avisos o ediciones.
edit_segmentGuarda un texto nuevo para un segmento.
quote_regenerationCuánto cuesta regenerar algunos segmentos.
regenerate_segmentsRegenera segmentos con sus textos guardados. Gasta créditos.
finish_dubTermina la edición y abre las descargas.
get_download_linksEnlaces a los archivos del doblaje, válidos durante 5 minutos.
get_subtitlesLos subtítulos como texto, en SRT o WebVTT.
delete_projectBorra 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.

Lee a continuación