Подключить VocaLingo к ИИ-агентам (сервер MCP)
Предоставьте Клоду Коду, Курсору или любому другому ИИ-агенту доступ к VocaLingo: клонированию голоса, аудио- и видеопереводу, субтитрам и резюме через MCP.
Автор Umakhan Magomedov
Последнее обновление 1 день назад
VocaLingo имеет сервер MCP: подключите его к своему ИИ-агенту (Claude Code, Cursor, Claude Desktop и др.), и агент сможет сохранять ваш голос, преобразовывать голосовые записи в текст, переводить аудио и видео, добавлять субтитры и составлять краткие содержания видео. Оплата производится с вашего обычного баланса VocaLingo.
Шаг 1. Получите токен
Откройте приложение VocaLingo (веб-версия, iOS или Android) и войдите, указав свой адрес электронной почты. Гостевые учетные записи не могут создавать токены.
Перейдите в «Настройки», затем в раздел «API / MCP Token».
Выберите клиент (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 и заголовок.
Что может делать агент
Бесплатные инструменты: 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 часов; результаты остаются в истории приложения.
Часто задаваемые вопросы
В Claude Desktop нет поля для токена. Куда его ввести?
В Claude Desktop нет поля для токена. Куда его ввести?
Это ожидаемое поведение: интерфейс пользователя настраиваемого коннектора в настоящее время поддерживает только URL и OAuth. Используйте конфигурацию mcp-remote из шага 2 в файле claude_desktop_config.json и полностью перезапустите Claude Desktop.
Агент сообщает «недостаточный баланс». Что делать?
Агент сообщает «недостаточный баланс». Что делать?
Пополните баланс в приложении VocaLingo (Профиль, Баланс). Сервер MCP использует тот же баланс, что и приложение; отдельного биллинга через API нет.
Я закрыл чат во время выполнения длительного задания. Результат потерян?
Я закрыл чат во время выполнения длительного задания. Результат потерян?
Нет. Попросите агента вызвать list_jobs: он найдет задание и получит результат. Результат также сохраняется в истории вашего приложения.
Можно ли иметь несколько токенов?
Можно ли иметь несколько токенов?
Один токен на одну учетную запись. При повторном генерации старый токен заменяется везде.
Почему мой агент не может загрузить файл в Claude Desktop?
Почему мой агент не может загрузить файл в Claude Desktop?
Добавьте адресvocalingo.app в «Настройки», «Возможности», «Выполнение кода», «Дополнительные разрешенные домены». Без этого Claude не сможет загружать вложения в VocaLingo.
Срок действия ссылки на результат от агента истек. Файл пропал?
Срок действия ссылки на результат от агента истек. Файл пропал?
Нет. Ссылки действительны в течение 24 часов, но сам результат хранится в истории вашего приложения. Попросите агента вызвать check_job с тем же jobId, чтобы получить новую ссылку.
Связанные статьи
Ещё в разделе Учетная запись и настройки
Изменение языка приложенияСмена темыКак удалить свою учетную записьИзменение стартового экрана и порядка перехода по вкладкамНужна помощь? Предложить идею