Как начать

От пустого вьюпорта до локации в вашем движке. Ни один шаг здесь не дольше, чем сварить кофе.

1. Установка

Возьмите сборку для своей системы на странице загрузки и запустите. Для Windows это установщик или портативная сборка, для macOS — образ под Apple Silicon или Intel.

Подписи разработчика у сборок пока нет, поэтому первый запуск потребует одного подтверждения: Подробнее → Выполнить в любом случае в Windows, правая кнопка → Открыть в macOS. Дальше приложение открывается как любое другое.

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

2. Подключение агента

Запустите Cuberta. Когда встроенный сервер поднялся, в заголовке окна написано MCP listening on 7345.

Нажмите Copy connect command в правом верхнем углу. Для Claude Code в буфер попадёт такая строка — вставьте её в терминал:

claude mcp add --transport http cuberta http://127.0.0.1:7345/mcp \
  --header "Authorization: Bearer <token>" --scope user

После этого запускайте агента в любой папке. Именно --scope user делает сервер доступным везде, а не только в том каталоге, где вы случайно оказались.

Любой другой MCP-клиент подключается так же: адрес http://127.0.0.1:7345/mcp по Streamable HTTP и заголовок Authorization: Bearer <token>. Токен создаётся при первом запуске и лежит в вашем конфиге — %APPDATA%\Cuberta\config.json в Windows, ~/Library/Application Support/Cuberta/config.json в macOS.

Сервер слушает только localhost, а токен никогда не показывается на экране: окно попадает в скриншоты и записи, поэтому кнопка кладёт его в буфер обмена.

3. Первое задание

Агент учит редактор по описаниям инструментов и по пяти руководствам, которые читает сам. Указать нужное руководство первым — самое сильное, что можно сделать с формулировкой задания:

  • «Прочитай cuberta://guide/scenes, потом построй уютную гостиную 6×4 м с диваном, журнальным столиком и тёплым вечерним светом. Покажи кадр, когда закончишь.»
  • «Сначала прочитай cuberta://guide/world. Построй городок: сетка улиц с кольцевой дорогой, коттеджи со скатными крышами, фонари и деревья вдоль тротуаров, закатный свет. Потом проверь результат линтером сцены и покажи кадры с уровня улицы и сверху.»
  • «Загрузи референсы с доски и повтори улицу с фотографии настолько точно, насколько сможешь; то, чего не видно, придумай.»

Просите кадр в конце каждого шага. Это самый быстрый способ поймать недопонимание, пока его дёшево исправить.

4. Пока он строит

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

  • Клик по объекту — агент прочтёт, что его выделил человек.
  • W / E / R — перемещение, поворот и масштаб гизмо; Ctrl включает привязку.
  • Правая кнопка мыши + WASD — полёт камерой.
  • Зоны рисуются, чтобы сказать, где строить, а где нельзя.
  • Текстура из браузера материалов перетаскивается прямо на объект.
  • Таймлайн внизу откатывает сцену к любому прошлому шагу; Ctrl+Z снимает последний — чей бы он ни был.
  • F1 показывает все горячие клавиши.

5. Сохранение и экспорт

File → Save пишет папку проекта: scene.json рядом с meshes/ (запечённая геометрия), renders/ (кадры, которые снимал агент) и refs/ (ваша доска референсов). File → Open project… открывает scene.json такой папки.

File → Export to GLB… пишет один .glb со всеми текстурами внутри. File → Export to FBX… — бинарный FBX тем же образом, с осями и единицами под Unity, Unreal, Maya и Blender. Экспорт идёт в отдельном процессе, поэтому окно не подвисает даже на тяжёлой сцене.

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

6. Если что-то не так

В заголовке нет «MCP listening». Возможно, порт 7345 занят другой программой. Закройте её и перезапустите Cuberta.

Агент не видит инструментов. Проверьте, что команда подключения вставлена вместе с --scope user и что клиент после этого перезапущен. В Claude Code команда claude mcp list покажет, зарегистрирован ли Cuberta и отвечает ли он.

Всё белое или вьюпорт пустой. Вьюпорту нужен WebGL 2. Почти всегда помогает обновление драйвера видеокарты.

Импорт пришёл не того размера. Модели приводятся к метрам с пивотом у основания, так что расхождение обычно значит, что исходный файл объявляет другие единицы — попросите агента перемасштабировать его или задайте размер в задании явно.

Не помогло? Напишите нам — система, версия приложения и что вы делали.