Для связки Codex Blender используй сторонний MCP-сервер Webita и аддон: агент получает инструменты осмотра открытой сцены, а для её изменения - Python внутри Blender. Начни с ограниченного списка инструментов и проверь один учебный объект. Это не официальный коннектор OpenAI или Blender и не управление мышью через Computer Use.
Проверено: 25 октября 2026 года по репозиторию Webita и документации OpenAI. Проверены инструкции и исходники; запуск связки на компьютере с Blender в рамках этого разбора не выполнялся.
Какой способ выбрать для связки Codex Blender?
Связка Codex и Blender не требует одного универсального плагина. Сначала выбери, что агент должен делать.
| Способ | Что происходит | Что учитывать |
|---|---|---|
| MCP-сервер Webita | Агент получает инструменты открытого Blender через локальный мост | Нужны аддон и сервер; выполнение Python требует отдельного решения |
| Сценарий Python | Агент готовит код, который выполняется средствами Blender | Это другой рабочий процесс; текущая инструкция его не настраивает |
| Computer Use | Агент работает с интерфейсом программы | Требует отдельной настройки; наличие MCP не даёт управление мышью |
Здесь разбираем первый вариант. В словаре MCP объяснена разница между сервером и плагином. Если нужен общий разбор подключения, открой MCP в Codex.
Как подготовить Blender и не рисковать рабочей сценой?
Нужны работающий локальный Codex, установленный Blender, uv и Python 3.10 или новее. Требование Python взято из pyproject.toml выбранного сервера. Если агент ещё не запускается, начни с первого рабочего цикла Codex, а uv установи по инструкции Astral.
В этом маршруте Blender и Codex работают в одной системе на одном компьютере. Не переноси настройку localhost автоматически на облачный Codex, WSL или другую машину.
На дату проверки пакет сервера имеет версию 1.5.5. В addon.py указаны версия аддона 1.2 и Blender 3.0.0 в метаданных. Это заявления проекта, не результат испытания всех сочетаний. В README нет полной таблицы проверенных версий Blender, Codex и ОС. Справка Blender, использованная ниже для меню установки, относится к ветке 5.2 LTS; на другой версии названия пунктов могут отличаться.
- Создай отдельную папку
blender-testбез закрытых документов и рабочих моделей. - Открой пустую сцену Blender. Через
File > Save Asсохрани её в этой папке какscene-before.blend. - До подключения стороннего кода убедись, что доверяешь репозиторию. Папка проекта и копия сцены не ограничивают права процесса Blender на компьютере.
Коротко: отдельный
.blendпомогает вернуть сцену. Он не отменит изменения других файлов, если разрешённый Python их затронет.
Как установить аддон и подключить сервер к Codex?
Скачай выбранный проект командой из его README:
git clone https://github.com/webita/blender-codex-mcp.gitОткрой появившуюся папку blender-codex-mcp и найди addon.py. Для воспроизводимости этого разбора использована ревизия 7b959c51fc4c166dc8b7ff4e85f989fa726f655c; её можно скачать архивом со страницы репозитория. Аддон и сервер бери из одной ревизии, не смешивай файлы разных версий.
В Blender открой Edit > Preferences > Add-ons. В актуальной справке Blender установка старого формата аддона находится в меню Install from Disk: выбери addon.py, затем включи аддон Blender Codex MCP. В README проекта тот же шаг назван Install....
В окне 3D нажми N, найди вкладку BlenderCodexMCP и кнопку Connect to MCP server. По README и исходникам мост слушает localhost:9876. Не меняй его на общедоступный адрес и не пробрасывай порт в интернет.
Перед правкой сохрани копию своего ~/.codex/config.toml. Добавь в него блок ниже, не заменяя остальные настройки. Если секция mcp_servers.blender уже есть, исправь её, а не создавай вторую.
[mcp_servers.blender]
command = "uv"
args = ["--directory", "/absolute/path/to/blender-codex-mcp", "run", "blender-codex-mcp"]
enabled_tools = ["blender_health_check", "get_scene_info", "get_object_info"]
[mcp_servers.blender.env]
BLENDER_HOST = "localhost"
BLENDER_PORT = "9876"
DISABLE_TELEMETRY = "true"Замени /absolute/path/to/blender-codex-mcp полным путём к скачанной папке на своём компьютере. Это обязательная подстановка, не готовый путь. В Windows для TOML удобно записывать путь с прямыми слешами, например C:/Users/your-name/blender-codex-mcp, подставив свои реальные каталоги.
command, args и переменные взяты из README Webita. Список enabled_tools добавлен по документации OpenAI: он оставляет только три инструмента осмотра. DISABLE_TELEMETRY - настройка телеметрии этого проекта, не обещание, что модель Codex работает без отправки запросов в интернет.
Сохрани файл и перезапусти Codex. Ограничение списка инструментов действует на обращения через этот MCP, но не превращает сторонний сервер в изолированную программу.
Как проверить, что агент видит именно твою сцену?
Сначала в терминале проверь сохранённую настройку:
codex mcp listВ открытой сессии Codex команда /mcp показывает активные серверы. В списке должен появиться blender, а среди доступных инструментов - средства осмотра из конфигурации. Это ещё не проверка работы Blender.
Отправь агенту свой первый запрос:
Через blender вызови blender_health_check и get_scene_info. Покажи имя сцены и имена объектов из ответа инструмента. Ничего не изменяй, не запускай Python, не устанавливай программы. Если вызов не удался, покажи ошибку и остановись.Сверь имена с Outliner - списком объектов в окне Blender. Не ориентируйся на пример чужого ответа: объекты должны совпасть с твоей сценой. Если данные не совпали, проверь, какой экземпляр Blender подключён, и не разрешай изменения.
Как разрешить одно изменение и проверить куб?
После успешного чтения можно проверить запись. Инструмент execute_blender_code выполняет произвольный Python внутри Blender; это не безобидная кнопка «добавить куб». Если не готов доверить ему такой доступ, остановись на осмотре.
Для учебной пробы допиши execute_blender_code в существующую строку enabled_tools и снова перезапусти Codex. Остальные инструменты импорта, генерации и внешних сервисов не включай. Одновременно с аддоном должен работать только один MCP-сервер - это ограничение README Webita.
Сначала попроси план, не исполнение:
Подготовь код для одного нового куба CB_TestCube в открытой учебной сцене: координаты (0, 0, 1), масштаб (1, 1, 1). Если такое имя уже занято, остановись. Не удаляй и не меняй существующие объекты, не работай с сетью и внешними файлами. Покажи код и объясни его действия. Не выполняй его до моего подтверждения.Проверь объяснение: только новый объект, никаких удалений, установок и загрузок. Затем, если согласен, явно разреши выполнение показанного кода. Промпт задаёт границы задачи, но сам по себе технически не блокирует нежелательный код.
После выполнения попроси get_object_info для CB_TestCube. Сам выбери куб в Outliner и сравни имя, положение и масштаб в панели Item окна 3D. Остальные объекты должны остаться на месте. Сообщение агента «готово» без этого сравнения не считается результатом.
Это предлагаемый учебный тест, не отчёт о созданном нами объекте. Дальше таким же коротким циклом можно согласовывать материалы и свет. Для визуальной проверки README предлагает get_viewport_screenshot; его нужно отдельно добавить в разрешённые инструменты, а в Blender оставить видимую область 3D. Рендер, анимацию и экспорт .glb в эту первую пробу не включай.
Как сохранить результат и закрыть доступ?
Через File > Save As сохрани новый файл scene-after.blend, не перезаписывая scene-before.blend. Убедись, что путь ведёт в твою учебную папку. Затем нажми Disconnect from MCP server в Blender.
Верни список enabled_tools к исходным трём инструментам. Если закончил работу совсем, вместо этого добавь enabled = false внутрь секции [mcp_servers.blender] и перезапусти Codex. Проверь через /mcp, что сервер отключён, а попытка обратиться к нему не выполняет действия.
Открой scene-after.blend через File > Open и ещё раз проверь куб и его свойства. Теперь результат существует в сохранённом файле, а не только в текущем окне. Для отката самой сцены открой scene-before.blend; изменения вне сцены этот шаг не отменяет.
Хочешь, чтобы агент соблюдал правила проекта и ты понимал, какие разрешения ему даёшь? Открой программу ClaudeBase: там есть урок «Рабочее окружение: правила проекта и разрешения». Программу можно посмотреть без оплаты; доступ к базе - после оплаты подписки. Подписки OpenAI и Anthropic оплачиваются отдельно.
Что проверить, если соединение или действие не работает?
| Что наблюдаешь | Что проверить и когда остановиться |
|---|---|
| Codex не запускает сервер | Доступен ли uv, существует ли абсолютный путь в args; не меняй наугад настройки модели |
| Сервер есть в списке, но вызов не проходит | Открыт ли Blender, включён ли аддон, нажата ли Connect to MCP server, совпадает ли порт 9876 |
| Связь была и пропала | Не закрылось ли окно Blender, не подключился ли второй MCP-клиент; переподключись только после устранения причины |
| Инструмент изменения недоступен | Это ожидаемо с начальным allowlist: разреши его отдельным шагом только после осмотра и согласования кода |
| Не получается снимок | Разрешён ли get_viewport_screenshot и есть ли видимое окно 3D; README указывает на необходимость области VIEW_3D |
| Куб есть, но файл после открытия другой | Проверь точный путь и имя сохранённого .blend; не повторяй изменение, пока не выяснишь, какой файл открыл |
Если аддон не включается, официальная справка Blender советует проверить ошибки в консоли. Запиши версию Blender, версию Codex и ревизию сервера вместе с полным текстом ошибки. Не лечи локальный сбой открытием порта наружу или выдачей всех прав сразу.
Источники
Открыты 25 октября 2026 года: