Перейти к основному содержимому
Учетная запись и настройки

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

Предоставьте Клоду Коду, Курсору или любому другому ИИ-агенту доступ к VocaLingo: клонированию голоса, аудио- и видеопереводу, субтитрам и резюме через MCP.

Автор Umakhan Magomedov

Последнее обновление 1 день назад

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


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

  1. Откройте приложение VocaLingo (веб-версия, iOS или Android) и войдите, указав свой адрес электронной почты. Гостевые учетные записи не могут создавать токены.

  2. Перейдите в «Настройки», затем в раздел «API / MCP Token».

  3. Выберите клиент (Cursor, Claude Code, Claude Desktop или «Другой») и нажмите «Копировать конфигурацию для вашего агента»: вы получите готовый фрагмент кода JSON в формате, подходящем для данного клиента.

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


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

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

Код Claude

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

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

{  "mcpServers": {    "vocalingo": {      "url": "https://nodejs.vocalingo.app/mcp",      "headers": { "Authorization": "Bearer vlmcp_YOUR_TOKEN" }    }  }}

Claude Desktop: в настройках коннектора пока нет поля для заголовка авторизации, поэтому подключайтесь через мост mcp-remote (требуется Node.js). Откройте «Настройки», «Разработчик», «Редактировать конфигурацию» (файл 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_YOUR_TOKEN" }    }  }}

Примечание: Authorization:${AUTH_HEADER} написано без пробела специально. После сохранения полностью перезапустите Claude Desktop (выберите «Quit», а не просто закройте окно). Чтобы Claude мог загружать вложения из вашего чата, также добавьте sb.vocalingo.app в «Настройки», «Возможности», «Выполнение кода», «Дополнительные разрешенные домены».

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 часов; результаты остаются в истории приложения.


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

Это ожидаемое поведение: интерфейс пользователя настраиваемого коннектора в настоящее время поддерживает только URL и OAuth. Используйте конфигурацию mcp-remote из шага 2 в файле claude_desktop_config.json и полностью перезапустите Claude Desktop.

Пополните баланс в приложении VocaLingo (Профиль, Баланс). Сервер MCP использует тот же баланс, что и приложение; отдельного биллинга через API нет.

Нет. Попросите агента вызвать list_jobs: он найдет задание и получит результат. Результат также сохраняется в истории вашего приложения.

Один токен на одну учетную запись. При повторном генерации старый токен заменяется везде.

Добавьте адресvocalingo.app в «Настройки», «Возможности», «Выполнение кода», «Дополнительные разрешенные домены». Без этого Claude не сможет загружать вложения в VocaLingo.

Нет. Ссылки действительны в течение 24 часов, но сам результат хранится в истории вашего приложения. Попросите агента вызвать check_job с тем же jobId, чтобы получить новую ссылку.