Servidor MCP de Voxdub

Qué hace el servidor MCP

Quién puede usarlo

El servidor MCP está disponible con un plan de Voxdub activo o durante una prueba. La prueba dura 7 días y pide una tarjeta. Después, el plan cuesta 12,99 € al mes o 99 € al año.

Obtener un token de acceso

1. Inicie sesión en Voxdub y abra Ajustes → Desarrollador.
2. Cree un token de acceso personal y dele un nombre (por ejemplo «Claude Code»).
3. Copie el token enseguida. Voxdub solo lo muestra una vez.
4. Guarde el token en secreto, como una contraseña. Si lo pierde, revóquelo y cree uno nuevo.

https://app-3.voxdub.com/settings?tab=developer

Configurar su agente

El servidor usa el transporte Streamable HTTP en https://mcp.voxdub.com/mcp. Cada solicitud envía el token en la cabecera Authorization: Bearer <token>. Sustituya <token> por su token.

claude mcp add --transport http voxdub https://mcp.voxdub.com/mcp \
  --header "Authorization: Bearer <token>"

# ~/.codex/config.toml
[mcp_servers.voxdub]
url = "https://mcp.voxdub.com/mcp"
bearer_token_env_var = "VOXDUB_TOKEN"

export VOXDUB_TOKEN="<token>"

{
  "mcpServers": {
    "voxdub": {
      "url": "https://mcp.voxdub.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:VOXDUB_TOKEN}"
      }
    }
  }
}

El inicio de sesión con OAuth (conectores de claude.ai y ChatGPT) aún no está disponible. Por ahora, use un cliente que acepte una cabecera Authorization.

Ejemplo paso a paso

Puede describir el resultado a su agente. Por ejemplo:

«Con Voxdub, crea una banda rítmica para escena.mp4 (en español, 2 personajes), corrige las erratas, aplica el estilo studio y exporta en 9:16.»

1. 1

   Comprobar la cuenta

   get_account muestra su correo, el estado de su plan y sus límites. El agente la llama primero.

2. 2

   Subir el vídeo

   create_upload recibe el nombre del archivo, su tamaño exacto en bytes, su tipo (video/mp4, video/quicktime o video/x-matroska) y el idioma hablado. Devuelve una put_url válida durante 15 minutos. El agente envía el archivo a esa dirección y luego llama a complete_upload, que devuelve el project_id.

   curl -X PUT -H "Content-Type: video/mp4" \
     --upload-file scene.mp4 "<put_url>"

3. 3

   Transcribir

   transcribe inicia la transcripción automática. El idioma se detecta automáticamente y la detección de hablantes crea un personaje por voz. Puede fijar min_speakers y max_speakers (de 1 a 20). El agente sigue la tarea con wait_for_job hasta que finished es true.

4. 4

   Corregir las líneas

   get_project da el id de la banda de origen y los personajes. list_lines lee las líneas (páginas de hasta 200). update_lines corrige hasta 100 líneas a la vez: texto, start_ms, end_ms y personaje. assign_character y update_character ajustan los personajes, sus nombres y sus colores.

5. 5

   Ajustar el estilo

   set_band_style aplica un ajuste predefinido (standard, large, studio, comic o reset) o valores exactos: fuente, tamaño, color, velocidad de desplazamiento, número de pistas y altura de la banda. translate_band también puede crear bandas en 1 a 5 idiomas más.

6. 6

   Exportar

   export_video genera el vídeo con la banda rítmica incrustada, en 16:9, 9:16 o cuadrado, a 720p o 1080p, a 24, 25, 30 o 60 imágenes por segundo. La opción remove_voice quita las voces originales.

7. 7

   Descargar

   Cuando wait_for_job indica que la exportación ha terminado, get_download_url da un enlace de descarga válido durante 1 hora.

Referencia de herramientas

Límites

• Como máximo 1 exportación en curso y 2 tareas abiertas a la vez, por cuenta.
• Vídeos de hasta 5 GB, en mp4, mov o mkv.
• Exportaciones hasta 1080p.
• Solo subida de archivos: la importación desde una URL aún no está disponible.

Solución de problemas