Как подключить HeyGen к Claude через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → HeyGen, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

HeyGen + Claude

Дайте своему ИИ создавать видео с аватарами HeyGen по вашему собственному ключу: выбирать аватары и голоса, превращать сценарий или запрос в видео с говорящим ведущим, заполнять ваши шаблоны, переводить видео на другие языки с синхронизацией губ, создавать фотоаватары и проверять рендеры и баланс.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

HEYGEN_API_KEY

Шаг 1 — Получите учётные данные

1. Войдите на https://app.heygen.com и откройте панель API (https://app.heygen.com/developers/api).
2. Создайте API-ключ и скопируйте его. Использование API оплачивается отдельно от веб-подписки HeyGen: если в аккаунте нет баланса или способа оплаты, добавьте их там.
3. Вставьте ключ в HEYGEN_API_KEY и установите коннектор. Ключ отправляется только в HeyGen. Ключу с ограниченными правами нужен доступ на чтение к аватарам, голосам, видео, шаблонам, переводам и пользователю, а также доступ на запись для инструментов, которые что-то создают.
4. Начните с heygen_get_account: он показывает тип оплаты и сколько средств у вас осталось.

Оплата с вашего API-баланса HeyGen: видео, переводы и аватары оплачиваются с вашего API-баланса (кошелёк с оплатой по факту использования или кредиты вашего плана). HeyGen тарифицирует видео по длительности и движку; актуальные цены указаны в панели API, а отклонённый вызов (402) сообщает, какая сумма была нужна. Просмотр списков и проверки бесплатны.

Сначала подтверждение: перед heygen_create_video, heygen_generate_from_template, heygen_create_agent_video или heygen_translate_video ИИ рассказывает, что будет создано (аватар, голос, длина сценария, формат, языки, движок), и ждёт вашего согласия. heygen_create_photo_avatar принимает только фото человека, который дал на это согласие, например ваше собственное, и ИИ просит подтвердить, что у вас есть такое право. heygen_delete_video при установке отключён.

Как создаётся видео:

1. ИИ выбирает персонажа через heygen_list_avatar_groups и один из его образов через heygen_list_avatar_looks; образ и есть ведущий. Голос из heygen_list_voices не обязателен, иначе говорит собственный голос аватара.
2. heygen_create_video принимает сценарий (до 5 000 символов), формат (например, 9:16 для шортсов) и движок и сразу возвращает id видео.
3. Видео рендерится в фоновом режиме. ИИ проверяет heygen_get_video примерно каждые 30 секунд; рендер занимает от минуты до нескольких минут, для длинных сценариев дольше.
4. Готовое видео приходит со ссылкой на MP4, версией с субтитрами, субтитрами SRT и ссылкой на видео в HeyGen. Ссылки для скачивания истекают; попросите новые, если нужно.

Другие способы создать видео:

• Шаблоны: heygen_list_templates и heygen_get_template показывают ваши шаблоны, готовые для API, и их переменные; heygen_generate_from_template заполняет все текстовые переменные и рендерит видео.
• Video Agent: heygen_create_agent_video превращает запрос в целое видео (сценарий, сцены, аватар); heygen_get_agent_session отслеживает его, пока видео не отрендерится.
• Перевод: heygen_translate_video переводит видео по публичной ссылке на один или несколько языков, с клонированным голосом спикера и синхронизацией губ или только аудиодорожкой; heygen_list_translation_languages перечисляет целевые языки.
• Фотоаватар: heygen_create_photo_avatar создаёт ведущего из одного портрета; heygen_get_avatar_look показывает, когда он готов к использованию.

Движки: avatar_iv используется по умолчанию. avatar_v даёт самые естественные движения, но только для образов, которые его поддерживают. avatar_iii поддерживает 4K для цифровых двойников и студийных аватаров.

Ограничения: 10 видео, переводов или сессий агента, рендерящихся одновременно, при оплате по факту использования (больше на Enterprise), 300 запросов списков и 500 проверок статуса в минуту. Исходные файлы должны быть доступны по публичным ссылкам: видео до 100 МБ, аудио до 50 МБ и 10 минут.

Частые ошибки: 401: ключ неверный или отозван. 402 insufficient_credit: баланса не хватает на это видео, и в сообщении указано, сколько нужно. usage_limit_reached или trial_limit_exceeded: лимит рабочего пространства или пробного периода, который снимает администратор или платный план. 403 insufficient_api_key_scope: права ключа ограничены; выдайте ему перечисленные выше права. 400 invalid_parameter: в сообщении указано поле, например движок, который образ не поддерживает. 404: несуществующий id; ИИ проверяет его с помощью инструментов для списков. 429: слишком много запросов; подождите и позже повторите попытку один раз.

Коннектор использует API v3 HeyGen (HeyGen отключает старые эндпоинты v1 и v2 31 октября 2026 года). Он не охватывает многосценовые студийные видео, создание видео из изображений, синхронизацию губ для готовых видео, клонирование и дизайн голосов, отдельный синтез речи из текста, интерактивные потоковые аватары, загрузку файлов (источники должны быть публичными ссылками), вычитку переводов, вебхуки, брендбуки, папки и пакетную обработку.

Шаг 2 — Установите адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавьте коннектор в Claude

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Рекомендуемый путь: работает в claude.ai web без редактирования конфигурационных файлов.

1. Открой в Claude Customize → Connectors.
2. Нажми +, затем Add custom connector.
3. Введи название, например HeyGen, и URL удалённого MCP-сервера https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, затем нажми Add.
4. Нажми Connect и войди в AnythingMCP (OAuth), чтобы разрешить доступ.

Все инструменты ниже появятся в чате: начинайте писать промпты.

Доступные инструменты

Примеры запросов

• «Сколько осталось на моём API-балансе HeyGen?»
• «Покажи мои собственные аватары и какие из их образов лучше всего подходят для 9:16.»
• «Сделай 45-секундное видео в формате 9:16, где мой цифровой двойник читает этот сценарий. Сначала согласуй со мной аватар, голос и длину, потом пришли ссылку на MP4, когда оно будет готово.»
• «Заполни наш шаблон еженедельного обзора этими тремя новостями и отрендери его.»
• «Переведи это демо-видео продукта на испанский (Испания) и японский с синхронизацией губ и сообщи, когда обе версии будут готовы.»

FAQ

Работает ли с Claude Code так же как с Claude Desktop? Да, оба указывайте на https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

Следующие шаги

• Страница коннектора
• Подключить к ChatGPT
• Подключить к Cursor
• Подключить к Gemini
• Подключить к Meta Muse