Conectar o VocaLingo ao Claude, ChatGPT e Cursor via MCP

Depois de conectar o VocaLingo, o seu assistente de IA pode traduzir uma mensagem de voz com a voz do próprio autor, resumir um vídeo do YouTube, narrar um texto com a sua própria voz, dublar um vídeo ou adicionar legendas. O agente consome tokens do seu saldo normal do VocaLingo, e todos os resultados também aparecem no histórico do app: comece uma dublagem no computador e continue no celular.

Detalhes do servidor

Passo 1. Abra a tela de agentes de IA

1. Abra o VocaLingo no iOS, Android ou web.vocalingo.app e faça login.

2. Vá em Ajustes → Agentes de IA (MCP). A tela se chama “Conectar o VocaLingo à sua IA”.

3. Em “Escolha sua IA”, toque no seu assistente: Claude, ChatGPT, Cursor, VS Code, Claude Code ou Outro. A tela mostrará os passos correspondentes.

Conectar o Claude

Funciona para claude.ai, Claude Desktop e os aplicativos móveis do Claude.

1. Na tela de agentes de IA, toque em Abrir Claude. A janela “Adicionar conector personalizado” se abrirá com o nome e o endereço já preenchidos.

2. Toque em Adicionar e depois em Conectar.

3. O Claude abrirá a página de login do VocaLingo. Entre da mesma forma que no aplicativo: com um código enviado ao seu e-mail, com o Google ou com um código do aplicativo.

Manualmente: no Claude, abra Personalizar → Conectores → Adicionar conector personalizado, cole https://nodejs.vocalingo.app/mcp e toque em Conectar. Depois disso, o VocaLingo funcionará no Claude em todos os seus dispositivos.

Conectar o ChatGPT

1. Copie o endereço do servidor na tela de agentes de IA.

2. Abra chatgpt.com/plugins no navegador, no seu celular ou computador.

3. Toque em + → Adicionar servidor MCP personalizado.

4. Digite o nome VocaLingo, cole o endereço, selecione o login OAuth, confirme “Eu entendo e desejo continuar” e toque em Criar.

5. Faça login no VocaLingo na página que se abrir.

Servidores MCP personalizados não estão disponíveis em todos os planos do ChatGPT.

Como fazer login a partir do Claude ou ChatGPT

A página de login aceita os mesmos métodos do aplicativo: um código enviado ao seu e-mail ou Google. Se você acessa o app com a Apple ou não se lembra de como entrou, toque em Obter um código de login na tela de agentes de IA. Na página de login, escolha “Entrar com código do app VocaLingo” e digite o código de 8 caracteres. O código funciona apenas uma vez e é válido por 10 minutos.

Conectar o Cursor ou VS Code

1. Abra web.vocalingo.app no computador onde o Cursor ou VS Code está instalado e faça login.

2. Vá em Ajustes → Agentes de IA (MCP) e escolha Cursor ou VS Code.

3. Clique em Instalar no Cursor ou Instalar no VS Code. O editor se abrirá e perguntará se deseja adicionar o servidor do VocaLingo: confirme.

A instalação com um clique funciona apenas no computador. Você também pode tocar em Copiar configuração e colar o texto em ~/.cursor/mcp.json para o Cursor, ou em mcp.json para o VS Code (comando “MCP: Open User Configuration”). O arquivo de configuração já contém o seu token.

Conectar o Claude Code

1. Na tela de agentes de IA, escolha Claude Code e toque em Copiar comando.

2. Execute-o no terminal. O comando se parece com isto:

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

Reinicie o Claude Code. O VocaLingo aparecerá na lista /mcp.

Outros clientes MCP

Windsurf, Cline e qualquer cliente compatível com servidores MCP remotos se conectam usando o endereço https://nodejs.vocalingo.app/mcp e o cabeçalho Authorization: Bearer vlmcp_…. Escolha Outro na tela de agentes de IA para copiar seu token e uma configuração pronta. Plugins para Claude Code, Cursor, Codex e Gemini CLI com habilidades prontas estão disponíveis no repositório vocalingo-mcp no GitHub.

Ferramentas MCP do VocaLingo

O agente seleciona a ferramenta correta com base no seu pedido. Ferramentas pagas consomem tokens do VocaLingo, a moeda do aplicativo.

As ferramentas translate_video, caption_video e change_voice precisam de um arquivo. Para links do YouTube ou TikTok, o agente primeiro chama download_media e envia o arquivo baixado em seguida. Os preços das ferramentas pagas são os mesmos do aplicativo, consulte os preços em tokens para cada ferramenta.

Como o agente pergunta sobre os custos

• Uma operação que custe 50 tokens ou mais informa o preço antes de começar, e a tarefa só tem início após a sua confirmação. O agente não pode confirmar por você.

• Você pode perguntar o valor com antecedência: “Quanto custa dublar este vídeo?”. O agente calcula uma estimativa sem iniciar nenhuma ação.

• Repetir o mesmo pedido em até 10 minutos não gera cobrança duplicada: o agente recupera a mesma tarefa.

• Se o saldo acabar, o agente informará “saldo insuficiente”. Recarregue no aplicativo, consulte como comprar tokens. Não há cobrança separada para o MCP.

Como enviar áudio, fotos e vídeos para o agente

Um arquivo enviado fica salvo por 48 horas, e o agente pode reutilizá-lo sem novo upload. Limites de tamanho: até 150 MB para translate_audio, 50 MB para speech_to_text e save_voice, 100 MB para ferramentas de vídeo e change_voice, 20 MB para imagens.

Se você precisa apenas ler ou traduzir o texto em uma foto, o Claude e o ChatGPT fazem isso sozinhos de graça. A ferramenta translate_image serve para quando você precisa da própria imagem com o texto redesenhado.

Tarefas demoradas

Ferramentas que levam mais tempo aguardam cerca de 25 segundos e retornam o resultado se ele já estiver pronto. Caso contrário, o agente recebe um jobId e monitora o progresso com check_job. A dublagem pode levar até 30 minutos. Se você fechar o chat durante o processo, peça ao agente para chamar check_job sem um jobId: ele listará as tarefas recentes. Os links para arquivos de resultado são válidos por 24 horas; os resultados em si permanecem no histórico do app (sem Premium, os últimos 3 itens de cada ferramenta).

Acesso, token e como desativar

Qualquer pessoa que tenha seu token pode consumir tokens do seu saldo, portanto mantenha-o em segredo. A seção Acesso e tokens na tela de agentes de IA oferece duas ações:

• Criar novo token: o token antigo deixa de funcionar em até um minuto. Atualize-o nos agentes conectados via token.

• Desativar acesso MCP: todos os agentes perdem o acesso em até um minuto, incluindo os conectores do Claude e do ChatGPT. Para conectar novamente, toque em Ativar acesso MCP, e um novo token será gerado.

Clone apenas a sua própria voz ou uma voz que você tenha autorização explícita para usar. A mesma regra se aplica ao aplicativo.

Perguntas frequentes