Подключение через MCP
AR Clip предоставляет MCP-сервер, так что инструмент, говорящий на Model Context Protocol, может работать с вашим проектом напрямую: читать сцену, добавлять объекты, заводить события, писать патчи.
Эндпоинт
https://<your-server>/api/mcp/v1
Аутентификация — bearer-токен:
Authorization: Bearer <your-api-token>
Токен создаётся в настройках аккаунта, в разделе API & MCP.
Он может менять ваши проекты. Не кладите его в то, чем вы делитесь, и отзывайте, если утёк.
Скоупы
Токен несёт только то, что вы ему дали:
| Скоуп | Что разрешает |
|---|---|
editor:read | читать проекты, сцены и ресурсы |
editor:write | создавать и менять их |
editor:ai | инструменты генерации |
editor:publish | публикацию |
Выдавайте токен только на чтение, если нужен только анализ. Модель, которая не может писать, ничего не сломает, а изрядная часть полезной работы — аудит сцены, объяснение, почему что-то не срабатывает, планирование изменений — большего и не требует.
Что подключается
Всё, что реализует MCP поверх streamable HTTP. На практике: Claude Desktop, Claude Code, Cursor и растущее число редакторов. У каждого своё место для объявления сервера — вы даёте ему URL выше и свой токен.
Работа бок о бок с редактором
Изменения, которые делает ассистент, появляются в вашем редакторе вживую, так же как появлялись бы правки коллеги, и попадают в историю совместной работы, как любая другая правка.
Поэтому продуктивная схема такая: держите редактор открытым на одном экране, просите изменения и смотрите, как они происходят. Вы сразу видите, когда получилось не то, что вы имели в виду, а не обнаруживаете это потом.
Сессия помнит, с каким проектом и space вы работаете, так что повторять это в каждом запросе не нужно.
Что покрывают инструменты
Сгруппировано по тому, о чём вы стали бы просить:
| Область | Ассистент может |
|---|---|
| Сцена | перечислять, создавать, двигать, вкладывать, дублировать и удалять объекты |
| Компоненты | читать и задавать любой компонент любого объекта |
| События | перечислять триггеры и шаги, добавлять и править события |
| Патчи | читать, писать и проверять графы нод и смотреть код, в который они компилируются |
| Анимация | собирать пресеты таймлайна |
| Физика | задавать тела, коллайдеры и стартовые скорости |
| Ресурсы | ходить по дереву проекта, создавать папки, импортировать и генерировать ассеты |
| Интерфейс | читать и писать UI-карточки |
| Публикация | публиковать, при наличии нужного скоупа |
И ещё четыре, которые легко пропустить, потому что они выходят за пределы сервера:
| Кроме того | Что делает |
|---|---|
| Скриншоты | снять вьюпорт, чтобы ассистент мог посмотреть на то, что построил |
| Измерение | реальный габаритный размер объекта в метрах — так он проверяет масштаб |
| Экспорт сцены | выгрузить сцену как данные |
| Мост в Blender | общаться с запущенным Blender: перечислить объекты, отправить туда сцену, забрать обратно |
Ассистент может увидеть собственную работу, и это помогает, — но неподвижный кадр ничего не говорит о том, работают ли скрипты, успокаивается ли физика и отслеживается ли маркер. Для этого нужен предпросмотр на настоящем устройстве.
list_component_schemas, list_event_types, list_patch_nodes и инструменты describe_*_api
отвечают из живого движка, так что ассистент может посмотреть, что существует на самом деле, а
не догадываться по обучающим данным. Если модель выдумывает имена компонентов — велите ей сначала
вызвать эти инструменты.
Готовые задачи
Сервер предлагает и несколько промптов, которые MCP-клиент показывает как команды:
| Промпт | Что делает |
|---|---|
build-scene | построить сцену по описанию |
add-interactivity | завести нажатия, триггеры и шаги |
animate | собрать таймлайн |
audit-scene | поискать проблемы |
prepare-publish | проверить то, что стоит проверить перед публикацией |
Чтение без изменений
Сервер публикует собственный справочник в виде ресурсов, которые клиент может читать:
was://project/info was://scene/current was://scene/selection
was://scripting/api was://patch/api was://events/api
was://physics/api was://timeline/api was://resources/api
was://ui/api
Они генерируются из движка, поэтому никогда не описывают ту версию платформы, которой больше нет.
Дальше: Скиллы ассистента