# Vini Studio — MCP

Студия коротких видео: собери проект из нод, выбери модель и качество, запусти генерацию,
забери материал. Всё то же, что на сайте, только из твоего агента.

## Адрес
https://vinistudio.app/mcp   (Streamable HTTP, спека 2026-07-28)

## Ключ
Заводится в студии: «⋮» → API → Создать ключ. Передаётся заголовком:
Authorization: Bearer vini_sk_...
Права ключа режут САМ СПИСОК инструментов: ключ «смотрит» пишущих не видит вовсе.

## Подключение
claude mcp add --transport http vini https://vinistudio.app/mcp \
  --header "Authorization: Bearer $VINI_API_KEY"

## Инструменты
describe_studio      смотрит     Каталог студии: какие ноды в ней есть и ЗАЧЕМ каждая нужна (purpose — одна фраза назначения), их входы, выходы, парам…
model_advice         смотрит     Справка студии по моделям: чем они реально отличаются, когда какую брать и что мы проверили сами.
list_skills          смотрит     Приёмы студии и приёмы пользователя: чем каждый занимается, к каким нодам подходит и под какую модель написан.
read_project_graph   смотрит     Что сейчас собрано на канвасе проекта: ноды (название на карточке, параметры, статус результата) и провода между ними…
read_run_history     смотрит     История запусков проекта: какие ноды прогонялись, когда, с каким исходом и почём — строкой результата («без изменений…
trace                смотрит     Причинная цепочка результата: почему нода или материал получились такими.
describe_scene       смотрит     Содержимое сцены-контейнера по её адресу из сводки канваса: что в ней лежит, кто её несёт и кто её менял по дороге.
list_my_elements     смотрит     Библиотека элементов пользователя (персонажи/объекты/локации) — id, имя, роль, начало описания.
describe_element     смотрит     Полное описание ОДНОГО элемента библиотеки по его id — когда в списке элементов текст сокращён, а нужен целиком (разо…
list_my_prompts      смотрит     Сохранённые промпты пользователя (id + заголовок).
list_my_designs      смотрит     Дизайн-системы пользователя (id + заголовок).
list_generators      смотрит     Встроенные генераторы студии — готовые решения для ноды (модель, формат и промпт одним куском): лист раскадровки перс…
billing_status       смотрит     Сколько денег на счету прямо сейчас и ведётся ли вообще их учёт.
billing_history      смотрит     Куда ушли деньги: сумма за период и разбивка по видам работы, моделям, проектам и дням.
list_projects        смотрит     Проекты этого аккаунта: название, когда их последний раз правили, и адрес, по которому проект открывается.
list_artifacts       смотрит     Готовые материалы — кадры, клипы, звук.
get_artifact         смотрит     Один материал и ссылка, по которой его можно скачать.
list_jobs            смотрит     Задачи генерации: что считается прямо сейчас и чем кончилось недавнее.
get_job              смотрит     Состояние одной задачи по её job_id.
price_quote          смотрит     Сколько будет стоить запуск — до того, как он случится.
create_project       собирает    Завести новый пустой проект студии и получить его адрес.
apply_graph_ops      собирает    Собрать или изменить граф проекта: добавить ноды, задать им поля, соединить проводами.
assemble_video       собирает    Склеить клипы в один ролик.
edit_video           собирает    Подрезать ролик по краям.
extract_audio        собирает    Достать звуковую дорожку из ролика.
import_clip          собирает    Забрать ролик по ссылке, чтобы работать с ним дальше.
generate_text        генерирует  Написать текст моделью — короткий кусок по заданию.
generate_image       генерирует  Нарисовать кадр по описанию и референсам.
generate_music       генерирует  Сочинить музыкальную подложку по описанию настроения.
generate_voice       генерирует  Озвучить текст выбранным голосом.
clone_voice          генерирует  Сделать голос по образцу записи — чтобы потом озвучивать им.
isolate_audio        генерирует  Вытащить из дорожки чистый звук без речи — шум, музыку, окружение.
dub_video            генерирует  Переозвучить готовый ролик на другом языке.
upscale_image        генерирует  Увеличить кадр без потери резкости.
write_script         генерирует  Разложить идею на сцены: что происходит, что видно в кадре, кто говорит.
write_scene_prompts  генерирует  Собрать из сцены готовые задания для кадра и для клипа.
rewrite_scene        генерирует  Переписать одну сцену, не трогая остальные.
direct_scene         генерирует  Разобрать сцену постановочно: движение камеры, действие, ритм.
make_subtitles       генерирует  Сделать субтитры к ролику по его звуку.
normalize_subtitles  генерирует  Причесать субтитры: разбивка по строкам, тайминги, пунктуация.
decorate_video       генерирует  Оформить ролик — подписи, плашки, акценты поверх картинки.
generate_video       генерирует  Снять клип.
lipsync_video        генерирует  Свести речь с губами героя в готовом ролике.

## Чего здесь нет
Запуска проекта одной командой: ноды считаются по одной, серверного исполнителя графа у студии нет.
Управления ключами по ключу: ключи заводятся и отзываются только в браузере.