Подключение VocaLingo к AI-агентам (MCP-сервер)

Дайте Claude Code, Cursor или любому AI-агенту доступ к VocaLingo: клонирование голоса, перевод аудио и видео, субтитры и выжимки через MCP.

Автор Umakhan Magomedov

Последнее обновление 3 дня назад

У VocaLingo есть MCP-сервер: подключите его к своему AI-агенту (Claude Code, Cursor, Claude Desktop и другие), и агент сможет сохранять ваш голос, озвучивать тексты, переводить аудио и видео, накладывать субтитры и делать выжимки видео. Оплата идёт с вашего обычного баланса VocaLingo.

Шаг 1. Получите токен

  1. Откройте приложение VocaLingo (web, iOS или Android) и войдите с email. Гостевым аккаунтам токен недоступен.

  2. Перейдите в Настройки, затем API / MCP-токен.

  3. Выберите свой клиент (Cursor, Claude Code, Claude Desktop или Other) и нажмите Скопировать конфиг для агента: вы получите готовый JSON в нужном формате для этого клиента.

⚠️ Любой, у кого есть этот токен, может тратить токены с вашего баланса. Держите его в секрете. При утечке нажмите Перегенерировать токен: старый перестанет работать в течение минуты. Можно и полностью выключить доступ агентов кнопкой Отключить MCP-доступ на той же странице.

Шаг 2. Подключите агента

Адрес сервера: https://nodejs.vocalingo.app/mcp. Это удалённый сервер, устанавливать ничего не нужно.

Claude Code

claude mcp add --transport http vocalingo https://nodejs.vocalingo.app/mcp --header "Authorization: Bearer vlmcp_ВАШ_ТОКЕН"

Cursor: добавьте в ~/.cursor/mcp.json:

{  "mcpServers": {    "vocalingo": {      "url": "https://nodejs.vocalingo.app/mcp",      "headers": { "Authorization": "Bearer vlmcp_ВАШ_ТОКЕН" }    }  }}

Claude Desktop: в настройках коннекторов пока нет поля для заголовка Authorization, поэтому подключение идёт через мост mcp-remote (нужен установленный Node.js). Откройте Settings, Developer, Edit Config (файл claude_desktop_config.json) и добавьте:

{  "mcpServers": {    "vocalingo": {      "command": "npx",      "args": ["-y", "mcp-remote", "https://nodejs.vocalingo.app/mcp", "--header", "Authorization:${AUTH_HEADER}"],      "env": { "AUTH_HEADER": "Bearer vlmcp_ВАШ_ТОКЕН" }    }  }}

Обратите внимание: Authorization:${AUTH_HEADER} пишется без пробела, это не опечатка. После сохранения полностью перезапустите Claude Desktop (Quit, а не просто закрыть окно). Чтобы Claude мог загружать вложения из чата, добавьте также sb.vocalingo.app в Settings, Capabilities, Code execution, Additional allowed domains.

Claude.ai в браузере пока не поддерживается: он не умеет передавать заголовок Authorization кастомным коннекторам. Используйте Claude Desktop.

Другие клиенты (Windsurf, VS Code, OpenClaw, Hermes и любой MCP-клиент с поддержкой удалённых серверов): те же URL и заголовок.

Что умеет агент

Инструмент

Что делает

Цена

save_voice

Сохраняет ваш голос из аудиозаписи

~150 токенов

text_to_speech

Озвучивает любой текст вашим голосом, голосами OpenAI или ElevenLabs

~10 токенов за 1 000 символов

speech_to_text

Расшифровывает аудио в текст

~1 токен за 2 мин

translate_audio

Переводит аудио, может сохранить исходный голос

зависит от длины

summarize_media

Расшифровка и выжимка видео или аудио, включая ссылки YouTube, TikTok и Instagram

~1 токен за 2,5 мин

translate_video

Дублирует видео на другой язык с клонированием голоса и липсинком

~220 токенов за минуту

caption_video

Накладывает стильные субтитры, может их переводить

~1-2 токена за минуту

Бесплатные инструменты: get_upload_url, check_upload, list_voices, delete_voice, check_job, list_jobs, get_balance, get_history, get_transactions.

Всё, что делает агент, появляется и в истории приложения: запустите перевод видео с компьютера, получите результат на телефоне.

💡 Перед дорогими операциями агент может запросить смету (dryRun) и покажет её вам до списания токенов. Можно и напрямую спросить: «сколько это будет стоить?»

Как передавать файлы агенту

  • Ссылки: YouTube, TikTok, Instagram и прямые ссылки на файлы работают как есть, просто вставьте их в чат.

  • Локальные файлы: агенты с терминалом (Claude Code, Cursor) загружают их автоматически по защищённой одноразовой ссылке.

  • Без терминала: агент пришлёт вам браузерную страницу загрузки, перетащите туда файл и продолжите диалог.

  • Telegram-бот-ассистент: голосовые, пересланные вашему боту, передаются прямой ссылкой без лишних шагов. Это самый удобный вариант.

Правила использования

Клонирование голоса через API подчиняется той же политике, что и в приложении: клонируйте только свой голос или голос человека, давшего явное согласие. Загруженные файлы автоматически удаляются через 48 часов; результаты остаются в истории приложения.

Часто задаваемые вопросы