Перейти до змісту

Vishot для AI-агентів (MCP)

Claude, ChatGPT, Cursor, GitHub Copilot, Gemini CLI, Codex та інші AI-агенти можуть працювати у вашому акаунті Vishot через MCP (Model Context Protocol): дивитися план і баланс, створювати сети й діалогові сцени, запускати генерацію відео й забирати результат. Агент працює через ваш акаунт і ваші ключі, з тими самими лімітами плану, що й плагін.

Адреса сервера

https://vishot.ai/api/mcp

Додайте цю адресу в агенті. Першого разу агент відкриє сторінку Vishot у браузері: увійдіть, перевірте назву застосунку й натисніть Дозволити. Пароль чи ключ в агент вставляти не треба. Усі підключені агенти видно й можна відключити в Кабінет › AI-агенти.

Що вміє агент

ІнструментЩо робитьПлатно
get_accountплан, баланс кредиту, скільки секунд відео лишилось цього місяцяні
list_video_modelsхмарні відеомоделі з ціною за секундуні
estimate_videoціна одного відео до запускуні
list_layouts, get_layoutваші сети, їхні персонажі, мітки, камери й сценині
create_layoutновий сет із шаблону, наприклад кімната, сільська вулиця чи лісова галявинані
get_scene, create_scene, update_sceneдіалогові сцени й план кадрів, який з них будуєтьсяні
generate_videoзапускає одне відео в хмарі й повертає його idтак
get_video, list_videosстатус, прогрес і посилання на файлні
cancel_videoскасовує відео, що ще в черзі; кредит повертаєтьсяні

Щоб агент створював сети, створював або змінював сцени, потрібен платний план, як і для повного веб-редактора. На безкоштовному плані агент може читати ваш акаунт, сети, сцени й відео, а Studio в браузері відкривається зі зразковою сценою.

Платна генерація завжди з лімітом

generate_video іде за ваш власний ключ провайдера, якщо ви додали його в Провайдери і ключі, інакше за кредит платформи. Кожен виклик має max_cost_usd: якщо відео коштуватиме більше, нічого не запуститься. Агентам сказано спершу порахувати ціну й назвати її вам. Більшість агентів також питають дозволу перед кожним викликом інструмента; для generate_video це варто лишити увімкненим.

Під час підключення ви обираєте, що агентові можна: читання, сцени, платна генерація. Агент без платної генерації нічого не витратить.

Платна генерація вимкнена, доки ви не позначите її на сторінці дозволу. Кожен агент із платною генерацією має власний місячний ліміт у доларах: $5, якщо ви не задали там іншу суму (від $1 до $1000). Якщо відео агента за цей місяць разом із наступним max_cost_usd перевищать ліміт, відео не запуститься. Змінити ліміт можна в Кабінет › AI-агенти.

Claude (claude.ai, Desktop, мобільний)

  1. Відкрийте Settings › Connectors і натисніть Add custom connector.
  2. Назвіть Vishot, вставте https://vishot.ai/api/mcp і натисніть Add.
  3. Натисніть Connect, увійдіть у Vishot і натисніть Дозволити.
  4. У чаті увімкніть Vishot у меню інструментів і попросіть, наприклад: «Зроби сцену на двох у сеті-кімнаті й порахуй, скільки коштуватиме 6-секундне відео першої репліки».

На планах Team і Enterprise конектор спершу додає власник організації.

Claude Code

claude mcp add --transport http vishot https://vishot.ai/api/mcp

Потім /mcp, оберіть vishot і Authenticate.

ChatGPT

  1. Відкрийте Settings › Apps (на деяких планах Connectors), далі Advanced settings, і увімкніть Developer mode.
  2. Натисніть Create app, назвіть Vishot, вставте https://vishot.ai/api/mcp як адресу сервера й оберіть автентифікацію OAuth.
  3. Підтвердіть, увійдіть у Vishot і натисніть Дозволити.
  4. У новому чаті оберіть Vishot у меню інструментів.

Developer mode є на платних планах ChatGPT; у робочих просторах Business і Enterprise його може знадобитися дозволити адміністраторові.

OpenAI Codex

codex mcp add vishot --url https://vishot.ai/api/mcp
codex mcp login vishot

Cursor

Додайте в ~/.cursor/mcp.json (для всіх проєктів) або .cursor/mcp.json (для одного):

{
  "mcpServers": {
    "vishot": { "url": "https://vishot.ai/api/mcp" }
  }
}

Відкрийте Cursor Settings › MCP, знайдіть vishot і натисніть Needs login.

GitHub Copilot у VS Code

Додайте в .vscode/mcp.json або виконайте MCP: Add Server у палітрі команд і оберіть HTTP:

{
  "servers": {
    "vishot": { "type": "http", "url": "https://vishot.ai/api/mcp" }
  }
}

Натисніть Start над сервером і увійдіть, коли VS Code попросить. Працюйте в Copilot Chat у режимі Agent.

Gemini CLI

gemini mcp add --transport http vishot https://vishot.ai/api/mcp

Запустіть gemini і виконайте /mcp auth vishot.

Windsurf та інші редактори

Більшість редакторів приймають ту саму адресу. Windsurf: додайте в ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "vishot": { "serverUrl": "https://vishot.ai/api/mcp" }
  }
}

Якщо застосунок не вміє входити через OAuth, використайте особистий ключ (нижче).

Особисті ключі: скрипти, n8n і API моделей

Для інструментів, що не можуть відкрити сторінку входу, створіть ключ у Кабінет › AI-агенти › Особистий ключ. Його показано лише раз. Ключ діє 30, 90 (за замовчуванням) або 365 днів, або безстроково, якщо ви так оберете; ключ із платною генерацією має власний місячний ліміт, як агент. Ключ, яким не користувалися 180 днів, відкликається автоматично. Передавайте його заголовком:

Authorization: Bearer vsk_...

OpenAI Responses API:

"tools": [{
  "type": "mcp",
  "server_label": "vishot",
  "server_url": "https://vishot.ai/api/mcp",
  "headers": { "Authorization": "Bearer vsk_..." },
  "require_approval": "always"
}]

Claude API (MCP connector, заголовок anthropic-beta: mcp-client-2025-11-20):

"mcp_servers": [{ "type": "url", "name": "vishot", "url": "https://vishot.ai/api/mcp", "authorization_token": "vsk_..." }],
"tools": [{ "type": "mcp_toolset", "mcp_server_name": "vishot" }]

Давайте ключу лише потрібні дозволи й відкликайте його в Кабінет › AI-агенти, якщо він потрапив не туди.

Приватність

Агент бачить те, що повертають інструменти: план, баланс, сети, сцени й посилання на відео. Vishot не бачить вашої розмови з агентом. Промпти й зображення, які ви передаєте для відео, йдуть провайдерові відео так само, як із плагіна, і на порталі не зберігаються; референс-зображення з вашої бібліотеки Studio лишаються у вашому акаунті. Докладніше в Приватність і дані.