Подключение по MCP

Подключите Claude, Cursor или другое AI-приложение к проекту, чтобы оно собирало сцену за вас. Здесь описано, как подключиться, как войти и как выбрать, что приложению можно делать.

MCP (Model Context Protocol) — стандартный способ, которым AI-приложения пользуются внешними инструментами. После подключения приложение может читать сцену, добавлять объекты, настраивать события, писать патчи и проверять свою работу.

Перед началом

Вам нужен адрес MCP-сервера AR Clip:

https://editor.arclip.design/api/mcp/v1

Сервер работает по MCP через streamable HTTP. Подключиться может любое приложение, которое это поддерживает: claude.ai, Claude Desktop, Claude Code, Cursor и другие.

Войти можно двумя способами:

• В браузере — подходит для большинства приложений. Нужен только адрес. См. Вход в браузере.
• По токену — для приложений без входа через браузер, для скриптов и CI. См. Вход по токену.

Работаете в папке с агентом для кода? Используйте командную строку

arclip link за один шаг настраивает папку для Claude Code. Команда добавляет MCP-сервер для этой папки, привязывает его к одному проекту и не записывает токен ни в один файл. Для Codex, Cursor или OpenCode arclip skill install --mcp добавляет сервер в их настройки. См. Командная строка.

Нужно, чтобы ассистент только читал документацию?

Подключите вместо этого MCP-сервер документации. Он ищет и читает эту документацию, входить не нужно.

Подключите приложение

claude.ai или Claude Desktop

1. Откройте Settings → Connectors.
2. Нажмите Add custom connector.
3. Вставьте адрес.
4. Войдите, когда попросят. В браузере откроется страница с правами — см. Вход в браузере.

Claude Code

1. Добавьте сервер:

   claude mcp add --transport http arclip https://editor.arclip.design/api/mcp/v1

2. Запустите Claude Code и выполните /mcp.

3. Выберите аутентификацию. В браузере откроется страница с правами — см. Вход в браузере.

Cursor

1. Откройте .cursor/mcp.json, чтобы подключить один проект, или ~/.cursor/mcp.json, чтобы подключить все проекты. Если файла нет, создайте его.

2. Добавьте сервер:

   {
     "mcpServers": {
       "arclip": { "url": "https://editor.arclip.design/api/mcp/v1" }
     }
   }

3. При первом подключении Cursor в браузере откроется страница с правами — см. Вход в браузере.

Приложение, которое запускает только локальные серверы

Некоторые приложения умеют запускать MCP-серверы только на вашем компьютере. Подключите их через mcp-remote с токеном.

1. Создайте токен — см. Вход по токену.

2. Добавьте это в настройки MCP приложения, подставив свой токен вместо <your-api-token>:

   {
     "mcpServers": {
       "arclip": {
         "command": "npx",
         "args": [
           "-y", "mcp-remote",
           "https://editor.arclip.design/api/mcp/v1",
           "--header", "Authorization:Bearer <your-api-token>"
         ]
       }
     }
   }

Проверьте, что всё работает

1. Откройте проект в редакторе.
2. Попросите ассистента перечислить объекты в сцене этого проекта.
3. Он ответит списком тех же объектов, что вы видите в редакторе.

Вход в браузере

Заранее ничего готовить не нужно.

1. Подключите приложение по адресу. При первом подключении в браузере откроется страница в вашем аккаунте AR Clip. На ней перечислены права, которые запрашивает приложение.
2. Снимите галочки со всего, что не хотите разрешать.
3. Нажмите Разрешить. Приложение получит токен ровно с этими правами.

Чтобы потом посмотреть или отозвать токены, откройте аккаунт и перейдите в раздел API & MCP.

Вход по токену

Токен нужен приложениям без входа через браузер, скриптам и CI.

1. Откройте аккаунт AR Clip и перейдите в раздел API & MCP.

2. Создайте токен и выберите его права.

3. Скопируйте токен. Он показывается только один раз.

4. Передайте его приложению. Приложение отправляет его в таком заголовке:

   Authorization: Bearer <your-api-token>

Храните токен в секрете

Токен может менять ваши проекты. Обращайтесь с ним как с паролем: никому не передавайте, а если он утёк, отзовите его в разделе API & MCP.

Права

Токен может делать только то, что вы разрешили:

Право	Что разрешает
editor:read	читать проекты, сцены, ресурсы и баланс AI
editor:write	создавать, менять и удалять объекты, компоненты и настройки
editor:ai	инструменты генерации — они тратят AI-кредиты вашей организации
editor:publish	публиковать, то есть делать проект публичным
editor:plugins	писать плагины редактора и добавлять их в проект

Права действуют везде, где работает токен. Токен без editor:write никак не может изменить сцену.

Нужен только анализ? Дайте токен только на чтение. Ассистент, который не может писать, ничего не сломает. Для многих полезных задач больше и не нужно: проверить сцену, объяснить, почему что-то не срабатывает, спланировать изменения.

Плагины запускаются у всех

Код плагина выполняется в редакторе у каждого, кто открывает проект, в который плагин добавлен. А его код для проекта работает ещё и у каждого, кто открывает опубликованный проект. Давайте editor:plugins только приложению, которому доверяете такое.

Важен и ваш тариф. На Free приложение может читать и проверять проекты. Для сборки, генерации и публикации нужен платный тариф.

Работа с одним проектом

Сессия запоминает свой проект и сцену, так что их не нужно повторять в каждом запросе. Ассистент переключает проект через set_active_project.

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

https://editor.arclip.design/api/mcp/v1?projectId=<project-id>&pin=1

Закреплённая сессия не может перейти в другой проект. Она также не меняет «последний проект», который подхватывают другие ваши приложения. Командная строка всегда подключается именно так.

id проекта — последняя часть адреса редактора: editor.arclip.design/project/<project-id>.

Смотрите, как он работает

Правки ассистента сразу появляются в вашем редакторе, как правки коллеги. Они попадают в историю правок, как любые другие.

Держите редактор открытым, пока просите что-то изменить, и смотрите, как это происходит. Если получается не то, что вы имели в виду, вы увидите это сразу, а не узнаете потом.

Что умеет ассистент

Область	Что может ассистент
Сцена	перечислять, создавать, перемещать, делать дочерними, дублировать и удалять объекты
Компоненты	читать и задавать любой компонент на любом объекте
События	перечислять триггеры и шаги, добавлять и править события
Патчи	читать, писать и проверять графы из нод и показывать их в виде кода
Анимация	создавать пресеты на таймлайне
Физика	задавать тела, коллайдеры и начальную скорость
Ресурсы	просматривать дерево ресурсов проекта, создавать папки, импортировать и генерировать ассеты
Интерфейс	читать и писать UI-карточки
Плагины	писать плагины, добавлять их в проект и выполнять команды, которые плагины предлагают
Публикация	публиковать, если это разрешает токен

Ещё он может проверять свою работу:

Проверка	Что делает
Verify	находит проблемы, которые сохраняются без ошибок, но ломаются в плеере: отсутствующие файлы, объекты с нулевым масштабом, неизвестные события, шаги, нацеленные на удалённые объекты, тёмную или полностью скрытую сцену
Render	render_scene рисует картинку сцены — редактор не нужен
Screenshots	снимает область просмотра открытого редактора
Measurement	получает настоящий размер объекта в метрах, чтобы проверить масштаб
Playtest	запускает скрипты и физику и нажимает все элементы управления, которые находит
Flows	run_flows проигрывает сценарии тестов и проверяет результат — так же, как arclip test

Ещё два инструмента работают за пределами AR Clip:

• Scene export сохраняет сцену в виде данных.
• Blender bridge работает с запущенным Blender: перечисляет его объекты, отправляет в него сцену или забирает её обратно.

Чего проверки не покажут

render_scene показывает раскладку, масштаб, цвета и текстуры. Скрипты, UI-карточки и эффекты он не рисует. Для playtest и flows держите проект открытым во вкладке редактора. Ни одна проверка не скажет, отслеживается ли метка в реальной комнате, — для этого нужен телефон.

Если ассистент выдумывает названия

list_component_schemas, list_event_types, list_patch_nodes и инструменты describe_*_api показывают ровно то, что существует. Если ассистент выдумывает названия компонентов, попросите его сначала вызвать эти инструменты.

Готовые промпты

У сервера есть несколько готовых промптов. Приложение показывает их как команды:

Промпт	Что делает
build-scene	собирает сцену по описанию
add-interactivity	настраивает нажатия, триггеры и шаги
animate	собирает таймлайн
audit-scene	ищет проблемы
prepare-publish	проверяет то, что стоит проверить перед публикацией

---

Дальше: Командная строка — агент для кода собирает проект из папки.