AvataReel MCP
MCP-сервер AvataReel позволяет вашему ИИ-ассистенту работать с аккаунтом AvataReel. Он может выбирать аватаров, писать сценарии, создавать видео и покупать кредиты — с вашего подтверждения.
Обзор
MCP (Model Context Protocol) — открытый стандарт, который связывает ИИ-ассистентов с приложениями. AvataReel предоставляет MCP-сервер по HTTP. Вы подключаете его один раз с личным API-ключом, и ассистент получает те же функции, что и вы в приложении.
Быстрый старт
1. Создайте API-ключ
В AvataReel откройте Настройки, найдите "ИИ-ассистенты (MCP)", назовите ключ и создайте его. Сразу скопируйте его: мы показываем ключ только один раз. Открыть Настройки
2. Добавьте сервер в клиент
Вставьте это в MCP-конфигурацию клиента и замените avr_… своим ключом.
{ "mcpServers": { "avatareel": { "type": "http", "url": "https://api.avatareel.com/mcp", "headers": { "Authorization": "Bearer avr_…" } } } }В Claude Code выполните:
claude mcp add --transport http avatareel https://api.avatareel.com/mcp --header "Authorization: Bearer avr_…"
3. Попросите, что нужно
Пишите простыми словами. Ассистент сам выберет инструменты, покажет цену до списания кредитов и пришлёт ссылку на видео, когда оно будет готово.
Что можно попросить
| Вы просите | Ассистент |
|---|---|
| “Сделай 30-секундную рекламу моей кофейни с дружелюбным аватаром.” | Показывает аватаров, пишет сценарий, называет цену, создаёт видео и присылает ссылку для скачивания. |
| “Напиши сценарий по этой странице товара.” | Читает страницу и готовит UGC-сценарий и сцену. |
| “Сделай три версии с разными хуками.” | Пишет новые вступления и создаёт по видео для каждого. |
| “Сколько у меня кредитов? Купи ещё.” | Показывает баланс и предложения, затем даёт ссылку на оплату картой или код Pix. |
| “Создай аватара по этому фото.” | Загружает фото, создаёт аватара и сообщает, когда он готов. |
| “Отмени мой тариф.” | Начинает отмену и спрашивает вас перед подтверждением. |
Инструменты
Вот инструменты, которые предлагает сервер. Ассистент выбирает их за вас; названия пригодятся, если захотите попросить конкретный.
Видео
Расчёт цены, создание, отслеживание, повтор и публикация видео.
quote_videocreate_videowait_for_videolist_videosget_videoget_video_stepsretry_videodelete_videocreate_videos_from_briefcreate_hook_variationsgenerate_post_captioncreate_product_image_uploadcreate_character_swap_uploadcomplete_character_swap_uploadcreate_character_swap_image_uploadcomplete_character_swap_image_uploadclaim_video_guaranteeget_video_feedbacksend_video_feedbacksubmit_post_linklist_listing_imagescreate_listing_imagesregenerate_listing_image
Сценарии
Написание, переписывание и перевод сценариев или старт со страницы товара.
list_scriptsgenerate_scriptgenerate_guided_scriptscript_from_urlrewrite_scripttranslate_scriptgenerate_hookssuggest_avatarpreview_speechpreview_voicegenerate_batch_scripts
Аватары и голоса
Просмотр аватаров и голосов или создание аватара по фото или описанию.
list_avatarsget_avatarlist_voicesget_avatar_quotacreate_avatar_photo_uploadassess_avatar_photogenerate_avatar_facecreate_avatarconfirm_avatar_likenessget_avatar_source_photoreplace_avatar_photoset_avatar_voicecreate_voice_recording_uploadmerge_voice_takesretry_avatardelete_avatar
Редактирование
Смена одежды и фона, правка готовых видео и редактор движения.
classify_videocheck_product_scriptsuggest_wardrobecreate_background_uploadcreate_brand_logo_uploadcreate_scene_image_uploadpreview_appearancechange_appearanceget_video_captionsedit_videoget_motion_editor_accesscreate_motion_editcreate_automatic_motion_editget_motion_editget_video_motion_editsave_motion_editdirect_motion_editadd_motion_soundtrackexport_motion_edit
Пакеты
Создание и скачивание многих видео сразу. Нужны пакетные видео в аккаунте.
quote_video_batchcreate_video_batchget_video_batchget_video_batch_downloadcreate_batch_motion_editslist_batch_motion_edits
Бренд и товары
Брендбуки, логотипы и сохранённые фото товаров.
list_brand_kitscreate_brand_kitbrand_kit_from_briefupdate_brand_kitlist_brand_assetsgenerate_brand_assetdelete_brand_kitlist_product_assetscreate_product_asset_uploadcomplete_product_asset_upload
Кредиты и оплата
Баланс, история, пакеты кредитов, тарифы, Pix и отмена.
get_credit_balancelist_credit_transactionslist_unseen_refundsget_billing_offerscreate_pack_checkoutcreate_pix_chargeget_payment_orderget_subscriptioncreate_subscription_checkoutcreate_subscription_pixget_subscription_pixchange_subscriptionstart_subscription_cancelaccept_cancel_offerconfirm_subscription_cancelcreate_billing_portalget_billing_profileupdate_billing_profile
Аккаунт и помощь
Профиль, удаление аккаунта и поддержка.
get_profileupdate_profilecreate_profile_photo_uploaddelete_accountsend_support_reportask_support
Кредиты и оплата
Видео расходуют те же кредиты, что и в приложении. Ассистент сначала узнаёт цену и показывает её до создания видео.
Когда кредиты закончатся, ассистент покажет пакеты и тарифы для вашего аккаунта. Он даст ссылку на оплату картой или код Pix для оплаты в банковском приложении. Кредиты поступят сразу после подтверждения оплаты.
Безопасность
- API-ключ действует от вашего имени, в том числе тратит кредиты. Храните его в секрете, как пароль.
- Отозвать ключ можно в Настройках в любой момент. Он перестанет работать со следующего запроса.
- Хорошие ассистенты спрашивают перед оплатой, отменой или удалением. Проверяйте такие запросы перед одобрением.
- API-ключи дают доступ только к клиентским функциям. Они не могут создавать или отзывать другие ключи.
Ошибки
При сбое инструмент возвращает HTTP-статус и сообщение. Самые частые:
- 400
- Неверные данные. В сообщении сказано, что исправить.
- 401
- API-ключ отсутствует, неверен или отозван.
- 402
- Недостаточно кредитов. Купите кредиты и повторите.
- 403
- В вашем аккаунте нет этой функции.
- 429
- Слишком много запросов. Подождите немного и повторите.