Чтение заявлено
true описывает операцию как не меняющую окружение. Это не устанавливает песочницу. У неизвестной или недоверенной реализации проверяйте механизм ограничений, а не только подпись.
RESOLVE / MCP / TOOL CONTRACTS
Инструменты MCP в DaVinci Resolve
Не просто доступен.
Понятен. Проверен.
Разберитесь, что ассистент действительно может вызвать, какие параметры важны и чем подтвердить результат. Сначала каталог и контракт — затем действие.
TOOLS/LISTINPUT SCHEMARESULT CHECK
TOOL / INSPECTION DESKУЧЕБНАЯ МОДЕЛЬ
01 / КАТАЛОГ
Какие инструменты действительно доступны?
Читайте текущий каталог, а не список функций по памяти.
Инструмент в списке — ещё не успешная операция.
Схема показывает порядок проверки. Она не запрашивает сервер и не запускает скрипты.
01
Запросите каталог. Не обещание.
«MCP подключился» и «эта операция работает» — разные утверждения.
Инструмент — именованная операция MCP-сервера. Клиент получает каталог через tools/list, а выбранную операцию вызывает через tools/call. Каталог сервера и функции, фактически переданные модели, не следует автоматически считать одним и тем же списком: фиксируйте, откуда взяты данные.[5]
Выберите один сервер
В клиенте определите конкретное подключение. Штатный Resolve MCP и отдельно установленный мост могут использовать разные имена инструментов. Их каталоги нельзя смешивать.
Посмотрите, что показывает клиент
Откройте список сервера и инструментов либо соответствующий журнал, если клиент его предоставляет. Пересказ модели удобен как подсказка, но не доказывает наличие точного сырого ответа сервера.
Убедитесь, что учтены страницы
Если передан nextCursor, получите следующую страницу через клиент. Пустая строка тоже считается курсором. Не подменяйте его придуманным номером страницы и не выводите общий размер каталога из одного фрагмента.
Сохраните контекст наблюдения
Запишите сборки сервера и клиента, версию и редакцию Resolve, ОС, время и показанную клиентом ревизию протокола. После изменения связки обновите каталог; старый скриншот не доказывает актуальность списка.
Пагинацию каталога определяет MCP; последовательность проверки выше — наш рабочий чек-лист.[9]
02
Прочитайте контракт до вызова.
Знакомого названия недостаточно. Нужны поля, которые определяют настоящий запрос.
| Поле | Что объясняет | Что проверить |
|---|---|---|
name / title | Машинное имя и необязательный заголовок для интерфейса. | Для вызова нужен точный name нужного сервера. Его нельзя переводить или заменять заголовком. |
description | Объяснение операции, предоставленное сервером. | Какой объект затрагивается? Это чтение, импорт, изменение или универсальный исполнитель? Убедительный текст не гарантирует безопасность. |
inputSchema | Структура входных аргументов. | Типы, обязательные поля, допустимые значения и правила лишних свойств. Уточните кадры или секунды, отсчёт от клипа или таймлайна и выбор целевого объекта. |
outputSchema | Необязательная схема структурированного результата. | Что должно вернуться и можно ли по ответу определить объект? Соответствие форме ещё не подтверждает правильность данных. |
annotations | Необязательные подсказки о поведении. | Это заявления сервера. Отсутствие поля не объявляет инструмент доступным только для чтения. |
Поля инструмента и аннотации поведения:[8][5]
properties — не список обязательных полей.
Поле, объявленное в properties, может быть необязательным. required задаёт обязательные ключи на соответствующем уровне, additionalProperties — правила для остальных. Ссылки, композиция и условия могут добавлять ограничения. Короткая сводка не заменяет чтение полной схемы.[12]
«Сдвинь на 24» — неполный запрос. На 24 кадра, секунды или к абсолютной позиции таймлайна? Выясните это до подтверждения.
03
Разберите один фрагмент каталога.
Инструмент чтения, не консоль выполнения. Встроенные примеры намеренно названы example.*.
TOOLS/LIST · LOCAL READER
Превратите каталог в понятный контракт.
Вставьте один обезличенный ответ tools/list или откройте пример. Компонент разбирает текст в браузере: не вызывает инструменты, не загружает ссылки из схем и не сохраняет ввод автоматически. Не вставляйте ключи, переменные окружения, персональные данные и закрытые пути.
Принимается { tools: [...] } или JSON-RPC-ответ с result.tools. Пределы: 131 072 символа, 200 записей, 40 уровней вложенности. Фрагмент — не обязательно полный каталог.0 / 131 072
04
Аннотации — не права доступа.
Добавление тоже меняет
false не обещает отсутствие последствий. Добавление может создать дубль, занять место или внести ненужный объект. Проверьте, допустимы ли вообще изменения в текущем упражнении.
Повтор — не восстановление
Подсказка касается одинаковых повторных вызовов, а не автоматической отмены. После тайм-аута или потери ответа сначала выясните состояние, прежде чем повторять запись; не угадывайте, что первая попытка ничего не сделала.
openWorldHint описывает взаимодействие за пределами замкнутой области. Это не полная политика конфиденциальности модели, клиента или всего процесса. В разборщике отсутствующие аннотации остаются «не передано»: интерфейс не превращает значения протокола по умолчанию в наблюдаемые факты о вашем сервере.[8]
05
Сопоставьте инструменты с монтажной задачей.
Это матрица проверки, а не обещание, что каждая перечисленная операция есть в штатном MCP Resolve.
| Задача | Что установить до выполнения | Независимая проверка |
|---|---|---|
| Прочитать проект / таймлайн | Операцию или проверенный скрипт, читающий нужный текущий объект без выбора другого. | Названия и выделение совпадают с интерфейсом Resolve. Отсутствие объекта сообщается, а не заменяется догадкой. |
| Изучить Media Pool | Границы отчёта и способ различить пустой результат, недоступные данные и ошибку запроса. | Сверьте ту же папку и элементы. Имена файлов сами по себе не подтверждают доступность медиа и правильность изображения. |
| Изменить клипы или маркеры | Поддерживаемую операцию, точный объект, систему отсчёта, допустимый диапазон и ненужную тестовую копию. | Проверьте нужный клип или маркер, позицию и затронутые дорожки. Посмотрите также соседние монтажные стыки. |
| Подготовить или запустить рендер | Отделите чтение настроек от добавления задания и запуска. Задайте место вывода и правила перезаписи. | Задание в очереди — не готовый файл. Проверьте фактический результат и воспроизведите его до приёмки. |
| Работать с Color, Fusion или Fairlight | Подтверждение конкретного параметра или операции в этой сборке и сервере. Общего обещания «AI-монтажа» недостаточно. | Сверьте конкретный контрол или ноду, затем оцените изображение или звук. Недоступные настройки занесите в ограничения. |
Здесь не заявляется фиксированное число штатных инструментов или поддержка всех монтажных действий. Универсальный исполнитель может охватывать несколько операций API; отсутствие отдельного инструмента само по себе не доказывает невозможность задачи. Изучайте конкретную реализацию.
06
Результат нужно проверить ещё раз.
01
Запрос принят
Запрос дошёл до обработчика.
02
Операция ответила
Прочитайте данные и статус ошибки.
03
Состояние сверено
Проверьте нужный объект в Resolve.
04
Результат принят
Посмотрите, послушайте, проверьте файл.
Отделяйте ошибку JSON-RPC от результата инструмента с isError: true. Читайте возвращённые данные даже при успешной передаче запроса. structuredContent — данные сервера, а не вывод ассистента; outputSchema, если она есть, описывает их форму. Ни одно из этих полей само по себе не подтверждает правильность задуманной правки.[5]
При потере ответа оставляйте исход «неизвестным», пока не проверите состояние. Не выдавайте тайм-аут за подтверждённую неудачу, а ответ без ошибки — за законченный рендер. Если инструмент возвращает задачу или промежуточный статус, используйте документированный для этой реализации способ дождаться результата до его приёмки.
07
Одно небольшое упражнение. Без правок проекта.
Сначала пройдите подключение. Ниже — процедура локальной проверки, а не утверждение, что ваша установка уже испытана.
Условия
Откройте ненужный тестовый проект с выбранным таймлайном. Самостоятельно запишите оба названия. Исключите закрытые имена клипов и материалы заказчиков. Не меняйте активный проект во время проверки.
Запрос
Попросите только имена открытого проекта и выбранного таймлайна без переключения и создания. До выполнения потребуйте имена инструментов и любой скрипт; подтверждайте только ограниченное чтение.
Ожидаемые действия
Ассистент использует настоящий каталог, выбирает подходящую операцию или проверенный скрипт и сообщает об отсутствующих объектах. Он не придумывает инструмент только потому, что о нём написано в статье.
Проверка
Лично сопоставьте названия в ответе и Resolve. Прочитайте результат инструмента и ошибки, а не только пересказ ассистента. Зафиксируйте, какая операция дала каждое поле.
Остановка и границы
Остановитесь, если операция недоступна, выбор объекта неоднозначен или код делает что-то ещё. Совпавшие названия подтверждают только это наблюдение, но не готовность монтажа, цветокоррекции или рендера.
08
Сохраните проверку вместе с параметрами связки.
Пустая карточка проверки полезнее универсального значка «поддерживается». Заполняйте её после наблюдения, без секретных данных.
Скачанный разбор каталога и эта карточка — документация, не исполняемая конфигурация сервера. Не публикуйте конфиденциальные отчёты в открытом репозитории.
FAQ
Вопросы об инструментах и границах
Где полный список штатных инструментов Resolve?
В фактическом каталоге установленного сервера с учётом того, что показывает клиент. Статья не фиксирует вечное число инструментов и не подменяет имена Blackmagic учебными примерами. Запишите источник, версии и учитывайте все страницы каталога.[5][9]
readOnlyHint: true делает вызов безопасным?
Нет. Это подсказка о поведении, а не механизм ограничения прав. Проверяйте сервер, реализацию, объект и аргументы. Не подтверждайте чувствительный вызов только на основании аннотации.[8]
Есть инструмент скриптов, но нет отдельного инструмента маркеров. Задача невозможна?
Не обязательно: универсальный исполнитель может дать доступ к операции через скрипт. Подтвердите реальный метод API и проверьте код. И наоборот: само наличие инструмента скриптов не доказывает поддержку любой операции с маркерами.
Разборщик принял JSON. Моя связка сертифицирована?
Нет. Проверена ограниченная структура данных. Подключение к серверу, все правила схемы, аргументы, права и операция в Resolve не проверялись. В скачанном разборе эти статусы явно остаются неподтверждёнными.
Почему ответ с nextCursor — неполный каталог?
Он указывает на следующие страницы, даже если значение — пустая строка. Локальный разборщик их не запрашивает. Отсутствие курсора в одном вставленном ответе не доказывает, что все предыдущие страницы учтены.[9]
Мой сервер Resolve обязан использовать ревизию 2026-07-28?
Нет. Это ревизия ссылок на протокол, использованных в статье. Установленные клиент и сервер могут работать по другой поддерживаемой ревизии. Проверьте версию, которую фактически сообщает клиент, и не собирайте смешанные по версиям запросы из примеров.[11]
ОПОРА НА ИСТОЧНИКИ
Документация, а не предположения.
Источники сверены 5 октября 2026. Ссылки на протокол относятся к ревизии 2026-07-28; это не утверждение о версии протокола вашего сервера Resolve. Каталоги в примерах вымышленные. Живой сеанс Resolve или AI-клиента не использовался.
- Model Context Protocol · Tools
Каталог tools/list, входная схема инструмента, вызовы, ошибки и контроль пользователем.
- Model Context Protocol · Schema / ToolAnnotations
Аннотации поведения, их смысл и недоверенный характер; поля определения инструмента.
- Model Context Protocol · Pagination
nextCursor и неполные каталоги. Пустая строка курсора не означает конец списка.
- Model Context Protocol · Inspector
Отдельный инструмент разработчика для изучения сервера и его интерфейсов.
- Model Context Protocol · Versioning and Compatibility
Различия ревизий протокола. Дата статьи не определяет версию протокола установленного сервера.
- JSON Schema · Object / required / additionalProperties
Как читать свойства объекта и обязательные поля; объявленное свойство не обязательно само по себе.
- Model Context Protocol · Security Best Practices
Границы доверия, локальные серверы и риски широких разрешений.