Conectar VocaLingo a Claude, ChatGPT y Cursor mediante MCP

Tras conectar VocaLingo, tu asistente de IA puede traducir un mensaje de voz con la voz de quien habla, resumir un video de YouTube, locutar un texto con tu propia voz, doblar un video o agregar subtítulos. El agente gasta tokens de tu saldo habitual de VocaLingo y cada resultado también aparece en el historial de la app: inicia un doblaje desde tu computadora y continúa en tu teléfono.

Detalles del servidor

Paso 1. Abrir la pantalla de agentes de IA

1. Abre VocaLingo en iOS, Android o web.vocalingo.app e inicia sesión.

2. Ve a Ajustes → Agentes de IA (MCP). La pantalla se llama “Conecta VocaLingo a tu IA”.

3. En “Elige tu IA”, toca tu asistente: Claude, ChatGPT, Cursor, VS Code, Claude Code u Otro. La pantalla mostrará los pasos correspondientes.

Conectar Claude

Esto funciona para claude.ai, Claude Desktop y las apps móviles de Claude.

1. En la pantalla de agentes de IA toca Abrir Claude. Se abrirá la ventana “Agregar conector personalizado” con el nombre y la dirección ya completados.

2. Toca Agregar, luego Conectar.

3. Claude abrirá la página de inicio de sesión de VocaLingo. Inicia sesión del mismo modo que en la app: con un código enviado a tu correo, con Google o con un código desde la app.

Manualmente: en Claude abre Personalizar → Conectores → Agregar conector personalizado, pega https://nodejs.vocalingo.app/mcp y toca Conectar. Después de eso, VocaLingo funcionará en Claude en todos tus dispositivos.

Conectar ChatGPT

1. Copia la dirección del servidor en la pantalla de agentes de IA.

2. Abre chatgpt.com/plugins en un navegador, en tu teléfono o computadora.

3. Toca + → Agregar servidor MCP personalizado.

4. Ingresa el nombre VocaLingo, pega la dirección, elige inicio de sesión por OAuth, confirma “Entiendo y deseo continuar” y toca Crear.

5. Inicia sesión en VocaLingo en la página que se abre.

Los servidores MCP personalizados no están disponibles en todos los planes de ChatGPT.

Cómo iniciar sesión desde Claude o ChatGPT

La página de inicio de sesión admite los mismos métodos que la app: un código enviado a tu correo electrónico o Google. Si inicias sesión en la app con Apple o no recuerdas cómo lo hiciste, toca Obtener código de inicio de sesión en la pantalla de agentes de IA. En la página de inicio de sesión elige “Iniciar sesión con un código de la app VocaLingo” e ingresa el código de 8 caracteres. El código funciona una sola vez y es válido durante 10 minutos.

Conectar Cursor o VS Code

1. Abre web.vocalingo.app en la computadora donde tengas instalado Cursor o VS Code e inicia sesión.

2. Ve a Ajustes → Agentes de IA (MCP) y elige Cursor o VS Code.

3. Haz clic en Instalar en Cursor o Instalar en VS Code. El editor se abrirá y te propondrá agregar el servidor de VocaLingo: confirma la acción.

La instalación en un clic solo funciona en computadoras. También puedes tocar Copiar configuración y pegarla en ~/.cursor/mcp.json para Cursor, o en mcp.json para VS Code (comando “MCP: Open User Configuration”). La configuración ya incluye tu token.

Conectar Claude Code

1. En la pantalla de agentes de IA elige Claude Code y toca Copiar comando.

2. Ejecútalo en la terminal. Se ve así:

claude mcp add --transport http vocalingo https://nodejs.vocalingo.app/mcp --header "Authorization: Bearer vlmcp_YOUR_TOKEN"

Reinicia Claude Code. VocaLingo aparecerá en la lista de /mcp.

Otros clientes MCP

Windsurf, Cline y cualquier cliente compatible con servidores MCP remotos se conectan con la dirección https://nodejs.vocalingo.app/mcp y el encabezado Authorization: Bearer vlmcp_…. Elige Otro en la pantalla de agentes de IA para copiar tu token y una configuración lista. Los complementos para Claude Code, Cursor, Codex y Gemini CLI con habilidades ya configuradas están en el repositorio vocalingo-mcp en GitHub.

Herramientas MCP de VocaLingo

El agente elige la herramienta según tu solicitud. Las herramientas de pago consumen tokens de VocaLingo, la moneda de la app.

translate_video, caption_video y change_voice necesitan un archivo. Para un enlace de YouTube o TikTok, el agente llama primero a download_media y transfiere el archivo descargado. Los precios de las herramientas de pago son los mismos que en la app; consulta los precios en tokens de cada herramienta.

Cómo consulta el costo el agente

• Una operación que cuesta 50 tokens o más muestra primero el precio, y la tarea comienza solo tras tu confirmación. El agente no puede confirmar por ti.

• Puedes preguntar el precio por adelantado: “¿Cuánto costará doblar este video?”. El agente obtendrá un estimado sin iniciar ninguna tarea.

• Repetir la misma solicitud dentro de un periodo de 10 minutos no genera un cobro doble: el agente recibe la misma tarea.

• Si el saldo se agota, el agente indicará “saldo insuficiente”. Recarga en la app; consulta cómo comprar tokens. No existe una facturación independiente para MCP.

Cómo enviar audios, fotos y videos al agente

Los archivos subidos se conservan durante 48 horas y el agente puede reutilizarlos sin tener que subirlos de nuevo. Límites de tamaño: hasta 150 MB para translate_audio, 50 MB para speech_to_text y save_voice, 100 MB para herramientas de video y change_voice, 20 MB para imágenes.

Si solo necesitas leer o traducir el texto de una foto, Claude y ChatGPT lo hacen por su cuenta de forma gratuita. translate_image está pensada para cuando deseas la imagen con el texto rediseñado.

Tareas largas

Las herramientas que tardan más esperan cerca de 25 segundos y devuelven el resultado si ya está listo. De lo contrario, el agente recibe un jobId y revisa su estado con check_job. El doblaje puede tardar hasta 30 minutos. Si cerraste el chat durante un proceso, pídele al agente que llame a check_job sin un jobId: listará las tareas recientes. Los enlaces a los archivos resultantes son válidos por 24 horas; los resultados se conservan en el historial de la app (sin Premium, los últimos 3 elementos de cada herramienta).

Acceso, token y cómo desactivarlo

Cualquier persona con tu token puede gastar tokens de tu saldo, así que mantenlo en secreto. La sección Acceso y tokens en la pantalla de agentes de IA ofrece dos acciones:

• Crear nuevo token: el token anterior deja de funcionar en un minuto. Reemplázalo en los agentes conectados mediante token.

• Desactivar acceso MCP: todos los agentes pierden acceso en un minuto, incluidos los conectores de Claude y ChatGPT. Para conectarlos de nuevo, toca Activar acceso MCP y se generará un nuevo token.

Clona únicamente tu propia voz o una voz para la que tengas permiso explícito. La misma regla rige dentro de la app.

Preguntas frecuentes