Account at Settings

Ikonekta ang VocaLingo sa Claude, ChatGPT at Cursor gamit ang MCP

Ang MCP server https://nodejs.vocalingo.app/mcp ay nagbibigay sa iyong AI ng 15 VocaLingo tools. Ang Claude at ChatGPT ay nagla-log in gamit ang OAuth, ang Cursor at Claude Code naman ay gumagamit ng token.

Na-update noong Nobyembre 2, 20269 min basahin

Pagkatapos mong ikonekta ang VocaLingo, kaya nang mag-translate ng iyong AI assistant ng voice message gamit ang boses ng nagsasalita, mag-summarize ng YouTube video, magbasa ng text gamit ang sarili mong boses, mag-dub ng video o magdagdag ng subtitles. Ang agent ay gumagamit ng tokens mula sa iyong regular na VocaLingo balance, at bawat resulta ay lumalabas din sa history ng app: simulan ang dub sa iyong computer at ituloy ito sa iyong phone.

Mga detalye ng server

ParameterValue

Address ng server

https://nodejs.vocalingo.app/mcp

Transport

Streamable HTTP

Sign-in para sa Claude at ChatGPT

OAuth: magsa-sign in ka sa iyong VocaLingo account, hindi kailangan ng token

Sign-in para sa Cursor, VS Code, Claude Code at iba pang clients

Personal na token sa header na Authorization: Bearer vlmcp_…

Mga Tool

15, nakalista sa talahanayan sa ibaba

Rate limit

hanggang 60 calls bawat minuto

Account

isang naka-sign in na account na may email; hindi pwedeng magkonekta ng agents ang mga guest

Hakbang 1. Buksan ang AI agents screen

  1. Buksan ang VocaLingo sa iOS, Android o web.vocalingo.app at mag-sign in.

  2. Pumunta sa Settings → AI agents (MCP). Ang screen ay pinangalanang “Connect VocaLingo to your AI”.

  3. Sa ilalim ng “Choose your AI”, i-tap ang iyong assistant: Claude, ChatGPT, Cursor, VS Code, Claude Code o Other. Ipapakita sa screen ang mga hakbang para dito.

Ikonekta ang Claude

Gumagana ito para sa claude.ai, Claude Desktop at ang Claude mobile apps.

  1. Sa AI agents screen, i-tap ang Open Claude. Bubukas ang “Add custom connector” window kung saan nakalagay na agad ang pangalan at address.

  2. I-tap ang Add, pagkatapos ay Connect.

  3. Bubuksan ng Claude ang VocaLingo sign-in page. Mag-sign in gamit ang parehong paraan tulad sa app: gamit ang code na ipinadala sa iyong email, gamit ang Google, o gamit ang code mula sa app.

Manual: sa Claude, buksan ang Customize → Connectors → Add custom connector, i-paste ang https://nodejs.vocalingo.app/mcp at i-tap ang Connect. Pagkatapos nito, gagana na ang VocaLingo sa Claude sa lahat ng iyong device.

Ikonekta ang ChatGPT

  1. Kopyahin ang server address sa AI agents screen.

  2. Buksan ang chatgpt.com/plugins sa isang browser, sa iyong phone o computer.

  3. I-tap ang + → Add custom MCP server.

  4. Ilagay ang pangalang VocaLingo, i-paste ang address, piliin ang OAuth sign-in, kumpirmahin ang “I understand and want to continue” at i-tap ang Create.

  5. Mag-sign in sa VocaLingo sa pahinang magbubukas.

Ang custom MCP servers ay hindi available sa lahat ng ChatGPT plans.

Paano mag-sign in mula sa Claude o ChatGPT

Tinatanggap ng sign-in page ang parehong mga paraan tulad sa app: isang code na ipinadala sa iyong email, o Google. Kung nag-sign in ka sa app gamit ang Apple o hindi mo na matandaan kung paano ka nag-sign in, i-tap ang Get a sign-in code sa AI agents screen. Sa sign-in page, piliin ang “Sign in with a code from the VocaLingo app” at ilagay ang 8-character code. Minsan lang magagamit ang code at valid ito sa loob ng 10 minuto.

Ikonekta ang Cursor o VS Code

  1. Buksan ang web.vocalingo.app sa computer kung saan naka-install ang Cursor o VS Code at mag-sign in.

  2. Pumunta sa Settings → AI agents (MCP) at piliin ang Cursor o VS Code.

  3. I-click ang Install in Cursor o Install in VS Code. Bubukas ang editor at mag-aalok na idagdag ang VocaLingo server: kumpirmahin ito.

Ang one-click install ay gumagana lang sa computer. Pwede mo ring i-tap ang Copy config at i-paste ito sa ~/.cursor/mcp.json para sa Cursor, o sa mcp.json para sa VS Code (command na “MCP: Open User Configuration”). Kasama na sa config ang iyong token.

Ikonekta ang Claude Code

  1. Sa AI agents screen, piliin ang Claude Code at i-tap ang Copy command.

  2. I-run ito sa terminal. Ganito ang itsura nito:

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

I-restart ang Claude Code. Lalabas ang VocaLingo sa /mcp list.

Iba pang MCP clients

Ang Windsurf, Cline at anumang client na sumusuporta sa remote MCP servers ay kumokonekta gamit ang address na https://nodejs.vocalingo.app/mcp at ang header na Authorization: Bearer vlmcp_…. Piliin ang Other sa AI agents screen para makopya ang iyong token at ang handang config. Ang mga plugin para sa Claude Code, Cursor, Codex at Gemini CLI na may ready-made skills ay nasa vocalingo-mcp repository sa GitHub.

Mga VocaLingo MCP tool

Pipiliin ng agent ang tool batay sa iyong request. Ang mga may bayad na tool ay gumagamit ng VocaLingo tokens, ang in-app currency.

ToolAno ang ginagawa nitoPresyo

get_upload_url

Nagbibigay ng file upload button sa chat, link sa upload page o isang curl command. Nagbabalik ng fileId para sa iba pang tools

libre

speech_to_text

Nagta-transcribe ng voice message o recording at inaalam ang wika

may bayad, depende sa haba

translate_audio

Nagsasalin ng boses sa ibang wika: transcript, translation, summary at default na voice-over gamit ang sariling boses ng nagsasalita

may bayad, depende sa haba

summarize_media

Nagta-transcribe ng video o audio at nagbabalik ng summary: mahahalagang bahagi na may timecodes, quotes, chapters. Tumatanggap ng mga link mula sa YouTube, TikTok, Instagram, X at Vimeo

may bayad, depende sa haba

translate_video

Nagdu-dub ng video sa ibang wika gamit ang na-clone na boses ng nagsasalita at opsyonal na lip sync, hanggang 30 minuto ng video

may bayad, ang pinakamahal na tool

caption_video

Naglalagay ng subtitles direkta sa video, isinalin kung hihilingin mo

may bayad, depende sa haba

download_media

Nagda-download ng video (MP4) o audio nito (MP3) mula sa YouTube, TikTok, Instagram, X, Vimeo at iba pang sites

libre, kailangan ng positive balance

change_voice

Pinapalitan ang boses sa audio o video recording na hanggang 5 minuto gamit ang ElevenLabs voice, pinapanatili ang intonation at timing

may bayad, depende sa haba

text_to_speech

Binabasa ang text gamit ang iyong na-save na boses, isang OpenAI voice o isang ElevenLabs voice

may bayad, depende sa haba ng text

save_voice

Kino-clone ang boses mula sa 10–60 segundo ng malinaw na pananalita patungo sa iyong library, katulad ng My Voices sa app

humigit-kumulang 1 token

list_voices

Inililista ang iyong mga na-save na boses at stock voices

libre

delete_voice

Permanenteng nagbubura ng na-save na boses

libre

translate_image

Muling isinusulat ang text sa litrato ng menu, signage o dokumento sa ibang wika, pinapanatili ang layout

4–6 tokens bawat larawan

check_job

Ipinapakita ang status at resulta ng mahabang job; kung walang jobId, inililista ang mga kamakailang jobs

libre

get_account

Ipinapakita ang token balance, status ng Premium at mga kamakailang charges

libre

Kailangan ng file para sa translate_video, caption_video at change_voice. Para sa link ng YouTube o TikTok, tatawagan muna ng agent ang download_media at ipapasa ang na-download na file. Ang presyo ng mga may bayad na tools ay pareho sa app, tingnan ang presyo ng tokens para sa bawat tool.

Paano nagtatanong ang agent tungkol sa gastos

  • Ang operasyon na nagkakahalaga ng 50 tokens o higit pa ay unang magpapakita ng presyo, at magsisimula lang ang job kapag sumang-ayon ka. Hindi pwedeng magkumpirma ang agent para sa iyo.

  • Maaari mong itanong ang presyo nang maaga: “Magkano ang aabutin para i-dub ang video na ito?”. Kukuha ang agent ng pagtatantya nang walang sinisimulang proseso.

  • Ang pag-uulit ng parehong request sa loob ng 10 minuto ay hindi sisingilin nang dalawang beses: makukuha ng agent ang parehong job.

  • Kung maubos ang balance, sasabihin ng agent na “insufficient balance”. Mag-top up sa app, tingnan ang paano bumili ng tokens. Walang hiwalay na billing para sa MCP.

Paano magpadala ng audio, litrato at video sa agent

SaanPaano

Kahit anong agent, link

YouTube, TikTok, Instagram, Telegram o direktang link papunta sa file: i-paste ito sa mensahe

ChatGPT, file

I-attach ang file sa mensahe, ipapasa ito ng ChatGPT. Kung hindi kaya, magbibigay ito ng link papunta sa upload page

Claude, file

Sabihan ang Claude na i-upload ang file. May lalabas na upload button sa chat: i-tap ito at piliin ang file. Ang file na naka-attach sa mensahe gamit ang paperclip ay hindi makakarating sa VocaLingo. Kung walang button, magbibigay ang Claude ng link sa upload page

Claude Code, Cursor at iba pang agents sa computer

Ibigay ang path papunta sa file, halimbawa ~/Downloads/voice.ogg. Ang agent na mismo ang mag-a-upload nito

Ang na-upload na file ay itatago sa loob ng 48 oras, at pwedeng gamitin itong muli ng agent nang hindi na kailangang mag-upload ulit. Mga limitasyon sa sukat: hanggang 150 MB para sa translate_audio, 50 MB para sa speech_to_text at save_voice, 100 MB para sa video tools at change_voice, 20 MB para sa mga larawan.

Kung kailangan mo lang basahin o isalin ang text sa isang litrato, kaya na itong gawin ng Claude at ChatGPT nang libre. Ang translate_image ay para sa sitwasyon kung saan gusto mo mismong makuha ang larawan na may muling naisulat na text.

Mahahabang jobs

Ang mga matatagal na tool ay maghihintay nang humigit-kumulang 25 segundo at ibabalik ang resulta kung handa na ito. Kung hindi pa, makakatanggap ang agent ng jobId at susuriin ito gamit ang check_job. Ang pag-dub ay maaaring tumagal nang hanggang 30 minuto. Kung naisara mo ang chat habang may ginagawang job, sabihan ang agent na tawagan ang check_job nang walang jobId: ililista nito ang mga kamakailang jobs. Ang mga link sa result files ay valid sa loob ng 24 oras; ang mga resulta mismo ay mananatili sa history ng app (kung walang Premium, ang huling 3 items sa bawat tool).

Access, token at paano ito i-off

Kahit sino na may hawak ng iyong token ay maaaring gumastos ng tokens mula sa iyong balance, kaya panatilihin itong lihim. Ang Access and tokens section ng AI agents screen ay may dalawang action:

  • Create a new token: titigil sa paggana ang lumang token sa loob ng isang minuto. Palitan ito sa mga agent na nakakonekta gamit ang token.

  • Disable MCP access: mawawalan ng access ang lahat ng agent sa loob ng isang minuto, kabilang ang mga connector ng Claude at ChatGPT. Para kumonekta ulit, i-tap ang Enable MCP access, at magbibigay ito ng bagong token.

I-clone lamang ang sarili mong boses o boses na mayroon kang malinaw na pahintulot na gamitin. Parehong patakaran ang ipinapatupad sa app.

Mga madalas itanong

Nag-attach ako ng litrato sa Claude, pero hinihiling ng agent na i-upload ko ito ulit. Bakit?

Hindi ipinapasa ng Claude ang mga chat attachment sa mga connector. I-tap ang upload button na lumalabas sa chat at piliin ang parehong file. Sa ChatGPT, direktang pumapasok ang naka-attach na file.

Hindi lumalabas ang VocaLingo sa Cursor o Claude Code pagkatapos ng setup. Ano ang dapat kong gawin?

I-restart ang agent. Kung wala pa rin ito, suriin kung naglalaman ang config ng kasalukuyang token: pagkatapos ng Create a new token, hindi na gagana ang luma.

I-contact ang support

Ilarawan ang problema at sasagot kami sa email. Isama ang file name o job ID kung mayroon ka.

Sumulat sa support