Saltar al contenido principal
Youka tiene un servidor MCP. MCP (Model Context Protocol) es la forma estándar en la que los asistentes de IA se conectan a herramientas externas. Una vez que lo conectas, puedes pedirle a tu asistente cosas como “make a karaoke video of ~/Music/song.mp3” y crea el proyecto en tu cuenta de Youka, espera a que termine y te da el enlace del editor o un enlace de descarga. El servidor funciona con cualquier cliente MCP que admita servidores remotos (Streamable HTTP) con un encabezado personalizado, como Claude Code, Cursor y Codex.
Las apps oficiales de Youka para ChatGPT y Claude llegarán pronto. Hasta entonces, usa un cliente de esta página con una clave de API de Youka.

Lo que necesitas

Detalles del servidor:
Tu clave de API da acceso total a tu cuenta de Youka y a sus créditos. No la incluyas en archivos y repositorios compartidos. Si una clave se filtra, elimínala en la página de tu cuenta y crea una nueva.

Conecta tu asistente

Ejecuta esto en tu terminal, reemplazando YOUR_API_KEY por tu clave:
Comprueba que se conectó:
Deberías ver youka: https://mcp.youka.io/mcp (HTTP) - ✔ Connected.De forma predeterminada, el servidor se añade solo para la carpeta actual. Añade --scope user para usar Youka en todas las carpetas.

Pruébalo

Pídele a tu asistente en lenguaje natural. Por ejemplo:
Una solicitud típica de karaoke va así:
1

Upload

El asistente le pide a Youka un enlace de carga y sube tu archivo. La subida es gratuita.
2

Check the cost

Comprueba cuántos créditos usará el proyecto y lo compara con tu saldo.
3

Create the project

Youka elimina las voces y sincroniza la letra. Esto tarda unos minutos. El asistente comprueba el estado hasta que el proyecto esté listo.
4

Edit or export

Obtienes un enlace para abrir el proyecto en el editor de Youka. Si pides el archivo de video, el asistente lo exporta y te da un enlace de descarga.
Crear un proyecto nunca renderiza un video por sí solo. Tú decides cuándo exportar, así que puedes corregir la letra o el estilo primero, ya sea en el chat o en el Youka editor.

Lo que el asistente puede hacer

Créditos y seguridad

  • Los mismos créditos que la app web. Crear un proyecto, volver a sincronizar la letra y exportar cuestan lo mismo que en online.youka.io.
  • El costo se comprueba primero. Si no tienes suficientes créditos, Youka rechaza la solicitud y lo indica. No se cobra nada.
  • Sin cargos duplicados. Si el asistente reintenta una solicitud tras un timeout, Youka reconoce el reintento y devuelve el resultado original en lugar de cobrar de nuevo.
  • Los créditos se compran en Youka. El asistente no puede comprar créditos. Para añadir más, consulta Buy more credits.
  • Las herramientas de pago solo se ejecutan cuando tú lo pides. Se le indica al asistente que cree proyectos, sincronice letras o exporte solo cuando se lo pidas.

Solución de problemas

Falta la clave de API o no es válida. Comprueba que el encabezado sea exactamente Authorization: Bearer yk_..., con un espacio después de Bearer y sin espacios extra ni comillas dentro de la clave. Si eliminaste la clave en la página de tu cuenta, crea una nueva y actualiza tu cliente. En configuraciones de Codex y Cursor que leen YOUKA_API_KEY, asegúrate de que la variable esté definida en el entorno desde el que se inicia la app.
Pídele al asistente tu saldo o consúltalo en online.youka.io. Luego buy more credits y vuelve a intentarlo.
Pídele al asistente que muestre el proyecto. Incluye el error. Asegúrate de que el archivo sea un archivo de audio o video compatible y que esté dentro de los límites de subida que muestra tu cuenta.
Dile al asistente la letra correcta y pídele que la sincronice de nuevo, o abre el enlace del editor y edit the lyrics tú mismo. Luego exporta de nuevo.

Documentación relacionada