MCP-сервер VlogMe для ИИ-агентов

MCP-сервер по адресу https://vlogme.ai/mcp даёт ИИ-агенту ту же работу, что и приложение VlogMe, — в вашем аккаунте, с вашим балансом кредитов и вашим Lab:

• Готовое видео из идеи. Director планирует сцены, пишет реплики, готовит картинки, голоса и музыку и собирает видео с субтитрами.
• Отдельные клипы и изображения. Модели «текст в видео» и «изображение в видео», говорящие фото, аватары, синхронизация губ, повышение качества и генерация изображений; каталог показывает каждую модель с её ограничениями и ценой.
• Голоса и звук. Озвучка, смена голоса, музыка, звуковые эффекты, расшифровка и субтитры; дубляж на другие языки.
• Монтаж ваших съёмок в Aisma и Новостные видео по выбранным вами статьям.
• Ваши файлы. Загрузка файла с компьютера, импорт по публичной ссылке, список и переименование файлов Lab, ссылки на скачивание результатов.

Каждый результат сохраняется в Lab, где его можно открыть в приложении. Всего инструментов 59; справочник REST API перечисляет каждый вместе с правом ключа, которое ему нужно.

Кредитами оплачиваются только запущенные задания: рендеры и другие генерации.

Без оплаты: подключение, список инструментов, каталог задач, расчёт цены, просмотр ваших файлов и задач, а также планирование, чат и бесплатная подготовка в Director. Планирование и подготовка расходуют тот же бесплатный лимит, что и в приложении; когда он на время исчерпан, ответ агенту содержит limited: true.

За кредиты: рендер, как и в приложении. Агент платит ровно столько же, сколько вы заплатили бы на сайте, и с того же баланса:

1. Агент запрашивает цену. Ничего не списывается.
2. Он показывает вам цену в кредитах и ждёт вашего согласия.
3. Он запускает задачу с этой ценой. По другой цене задача не запустится: если изменились цена или входные данные, запуск отклоняется, и ничего не списывается.

Задача, которая не удалась, не оплачивается. Кредиты покупаются на сайте, в разделе Account; ключ купить их не может. Если кредитов не хватает, агент получает отказ, в котором это сказано, со ссылкой на страницу пополнения. Пакеты и тарифы — на странице цен.

Вход без ключа. Клиентам, которые поддерживают вход в MCP (Claude Code, коннекторы claude.ai и ChatGPT, Cursor, VS Code), нужен только адрес https://vlogme.ai/mcp. Клиент откроет VlogMe в браузере: вы входите, выбираете, что можно агенту, и нажимаете Allow. Приложение появится в Account → API & MCP → Connected apps, где его можно отключить в любой момент.

Или используйте API-ключ для скриптов, n8n и клиентов без входа:

1. Создайте ключ в Account → API & MCP (кабинет пока доступен только на английском). Скопируйте его сразу: он начинается с vma_.
2. Храните его в переменной окружения, чтобы он не попал в файл, которым вы делитесь:

export VLOGME_API_KEY="vma_…"

3. Добавьте сервер в клиент с такими значениями:

Ниже — точные шаги для каждого клиента. Чтобы клиент загрузил все 59 инструментов отдельными пунктами, добавьте к адресу ?tools=all: https://vlogme.ai/mcp?tools=all.

Каталог задач (https://vlogme.ai/api/catalog) и документ OpenAPI (https://vlogme.ai/api/openapi.json) открыты всем без ключа, поэтому агент может спланировать работу ещё до подключения.

Со входом: выполните claude mcp add --transport http vlogme https://vlogme.ai/mcp, затем введите в Claude Code /mcp, выберите vlogme и пункт Authenticate. В браузере откроется VlogMe — нажмите Allow.

С ключом: Выполните один раз в терминале, где задана VLOGME_API_KEY:

claude mcp add --transport http vlogme https://vlogme.ai/mcp --header "Authorization: Bearer $VLOGME_API_KEY"

Проверьте командой claude mcp list, затем попросите: «Сделай в VlogMe 5-секундный клип с бумажным корабликом на пруду. Сначала назови цену». Claude Code спрашивает вас перед каждым вызовом инструмента, если вы не разрешили этот инструмент заранее.

Добавьте сервер в ~/.cursor/mcp.json (или в .cursor/mcp.json проекта). Cursor берёт ключ из переменной окружения:

{
  "mcpServers": {
    "vlogme": {
      "url": "https://vlogme.ai/mcp",
      "headers": { "Authorization": "Bearer ${env:VLOGME_API_KEY}" }
    }
  }
}

Сервер и его инструменты видны в Cursor Settings → MCP. Если инструменты не появились, запустите Cursor из терминала, где задана переменная.

Добавьте в рабочую папку .vscode/mcp.json. VS Code спросит ключ при первом запуске и сохранит его в защищённом хранилище:

{
  "inputs": [
    { "type": "promptString", "id": "vlogme-key", "description": "VlogMe API key", "password": true }
  ],
  "servers": {
    "vlogme": {
      "type": "http",
      "url": "https://vlogme.ai/mcp",
      "headers": { "Authorization": "Bearer ${input:vlogme-key}" }
    }
  }
}

Запустите сервер из этого файла или из панели MCP и пользуйтесь инструментами в режиме агента в Chat.

Выполните один раз. Одинарные кавычки сохраняют в пользовательских настройках ссылку на VLOGME_API_KEY, а не сам ключ; Gemini CLI читает переменную при запуске:

gemini mcp add --scope user --transport http vlogme https://vlogme.ai/mcp --header 'Authorization: Bearer $VLOGME_API_KEY'

Или добавьте сервер в ~/.gemini/settings.json вручную:

{
  "mcpServers": {
    "vlogme": {
      "httpUrl": "https://vlogme.ai/mcp",
      "headers": { "Authorization": "Bearer $VLOGME_API_KEY" }
    }
  }
}

В Gemini CLI команда /mcp показывает сервер и его инструменты.

Добавьте сервер в ~/.codex/config.toml. Codex отправляет ключ из указанной переменной:

[mcp_servers.vlogme]
url = "https://vlogme.ai/mcp"
bearer_token_env_var = "VLOGME_API_KEY"
tool_timeout_sec = 120

tool_timeout_sec даёт инструментам, которые ждут задачу (до 30 секунд за вызов), время ответить.

В сценарии с узлом AI Agent добавьте MCP Client Tool и укажите:

• Endpoint: https://vlogme.ai/mcp
• Server Transport: HTTP Streamable
• Authentication: Bearer Auth, с учётными данными, где хранится ваш ключ

После этого агент может запрашивать цену, запускать задачи и ждать их. Любой платный запуск по-прежнему требует свежего расчёта цены и его отпечатка, поэтому сценарий всегда платит рассчитанную цену. Для ежедневного видео пусть сценарий сравнивает цену в кредитах с заданным вами пределом, прежде чем запускать задачу.

Ключ делает то, что вы отметили при его создании, и ничего больше:

• read (есть у каждого ключа): каталог, расчёт цены, ваши файлы, задачи и баланс. Ключа с правом read достаточно, чтобы агент изучил возможности и рассчитал стоимость.
• write: загрузка и импорт файлов, планирование в Director и запуск платных задач по рассчитанной цене.
• delete, share и publish: удаление файлов и проектов, публичные ссылки и публикации в подключённых соцсетях. Не включайте их, если агенту они не нужны.

Ключ никогда не может купить кредиты, сменить тариф, создать другие ключи или удалить аккаунт. Он действует от 1 до 365 дней, а отзыв ключа в Account → API & MCP сразу останавливает все клиенты, которые им пользуются. Храните ключ в секрете: он действует от имени вашего аккаунта (Условия использования).

Подключённые приложения. Приложение, подключённое через вход, получает те права из этого же списка, которые вы отметили на странице Allow. Его доступ обновляется сам и сразу прекращается, когда вы отключаете приложение в Account → API & MCP → Connected apps.

После подключения попробуйте один из запросов:

• «Сделай в VlogMe 30-секундное видео о том, как работают солнечные панели. Покажи план и цену до рендера».
• «Оживи ./photo.jpg в 5-секундный клип с медленным наездом. Сначала назови цену».
• «Пусть мой портрет ./me.png скажет: „Добро пожаловать в наш магазин“. Какая модель подойдёт и сколько это стоит?»
• «Что умеет VlogMe и сколько стоит 10-секундное видео?»

Агент каждый раз проходит одни и те же шаги: читает каталог, запрашивает цену, показывает вам кредиты, запускает задачу с этой ценой и новым ключом идемпотентности, ждёт её и даёт ссылку на скачивание, которая действует 15 минут. У видео Director перед расчётом цены добавляются планирование и подготовка. Каждый шаг описан в разделе MCP справочника REST.

MCP-сервер бесплатный? Подключение, каталог, расчёт цены, планирование и подготовка в Director ничего не стоят в пределах тех же лимитов, что и в приложении. Запущенные задания, включая рендер, стоят столько же кредитов, сколько в приложении.

Может ли агент потратить кредиты без спроса? Каждый платный инструмент велит агенту показать вам рассчитанную цену и дождаться согласия, а клиент спрашивает вас перед каждым вызовом, если вы не разрешили его заранее. Задача запускается только по цене своего расчёта. Чтобы агент только изучал возможности и ничего не тратил, дайте ему ключ с одним правом read.

Платит ли агент больше, чем на сайте? Нет. Цены, баланс и бесплатный лимит те же.

Есть ли на результатах водяной знак? VlogMe не добавляет видимых водяных знаков к тому, что вы создаёте.

Какие клиенты подходят? Любой MCP-клиент, который может отправить заголовок Authorization по Streamable HTTP, в том числе Claude Code, Cursor, VS Code, Gemini CLI, Codex и n8n. Клиентам, которые подключаются через вход по OAuth, например коннекторам claude.ai и ChatGPT, ключ не нужен: они попросят вас войти и нажать Allow.

Сколько инструментов увидит агент? До 59. Добавьте к адресу ?tools=all, чтобы загрузить каждый инструмент отдельным пунктом. Без этого сервер может ответить коротким основным списком, и тогда остальные доступны через vlogme_find_tools и vlogme_call_tool. Два платных инструмента всегда есть в коротком списке, поэтому клиент подтверждает каждый их вызов. Инструменты, которые удаляют, открывают доступ или публикуют, никогда не запускаются через vlogme_call_tool; чтобы пользоваться ими, подключайтесь с ?tools=all.

Где мои файлы? В Lab, как и всё, что вы делаете в приложении. Ссылки на скачивание в ответах инструментов действуют 15 минут; за новой можно обратиться снова.

Что, если запрос отклонён? Ответ инструмента простыми словами объясняет причину, а за отклонённый вызов ничего не списывается. Слишком частые запросы отклоняются с rate_limited и числом секунд, которые нужно подождать.