Под «Blender MCP» обычно понимают MCP for Blender, открытый проект Сиддхарта Ахуджи, который позволяет ИИ-агенту управлять запущенным Blender. До ноября 2026 года он назывался blender-mcp, и в большинстве руководств до сих пор используется это имя. После подключения Claude Code, Codex, Cursor или Claude Desktop могут создавать и править объекты, назначать материалы, смотреть на вьюпорт и экспортировать файлы, и всё это по запросу в чате.
В этом руководстве: что это такое, как установить его в Claude Code и Codex, и полный пример. Агент строит в Blender низкополигональный игровой предмет, экспортирует его в GLB, файл сжимается с помощью glTF-Transform, а three.js загружает его в браузерной игре. Мы сверили все команды с README проекта и официальной документацией 21 ноября 2026 года. Установку и пример мы сами не запускали, поэтому описанные ниже результаты стоит читать как то, что должно получиться по документации.
Что такое Blender MCP
MCP (Model Context Protocol) — стандартный способ дать ИИ-агенту инструменты для работы с другой программой. MCP for Blender состоит из двух частей:
- Аддон для Blender, который открывает внутри Blender сокет-сервер (по умолчанию порт 9876) и выполняет полученные команды.
- MCP-сервер (пакет Python
mcp-for-blender), который агент запускает в фоне. Он передаёт вызовы инструментов от агента в аддон.
В основном агент работает так: пишет Python для Blender и запускает его в вашем открытом файле. В README перечислены девять инструментов. Чаще всего вы увидите execute_blender_code (запуск Python в Blender), look (снимки вьюпорта, камеры или нескольких ракурсов, чтобы агент проверял свою работу), get_scene_info (сводка по сцене) и search_assets / import_asset (модели, текстуры и HDRI из Poly Haven, Sketchfab и Poly Pizza). Есть и generate_3d, который создаёт модель через Meshy, Tripo, Hunyuan3D или Hyper3D Rodin.
Его сделали не в Blender. README начинается словами «This is a third-party integration and not made by Blender», а в описании на GitHub сказано «Not affiliated with the official Blender Foundation.» Лицензия MIT, на 21 ноября 2026 года у проекта было 35 153 звезды на GitHub.
Но у Blender есть и собственный MCP-сервер. Blender Lab, часть проекта Blender, публикует более компактный сервер по адресу projects.blender.org/lab/blender_mcp, документация — на blender.org/lab/mcp-server. В его readme он назван «deliberately small» (намеренно небольшим). Он сосредоточен на документации по Python API Blender, сводках по сцене и файлам, скриншотах и запуске кода. Ему нужен Blender 5.1 или новее, лицензия GPL-3.0, версия на момент проверки — v1.0.3 (сентябрь 2026). Он также есть в каталоге коннекторов Claude под названием «Blender», автор — Blender Lab. О нём мы пишем в разделе Альтернативы Blender MCP.
Что понадобится
- Blender 3.0 или новее для MCP for Blender (аддон заявляет 3.0 как минимум).
- Python 3.10 или новее и uv — инструмент, который запускает сервер через
uvx. Однострочный установщик ниже ставит uv за вас. - Агент с поддержкой MCP: по README это Claude Code, Codex, Cursor, Claude Desktop, VS Code, OpenCode, Windsurf или Antigravity.
- Для игровой части: Node.js (для glTF-Transform) и проект на three.js.
Быстрая установка (сразу для всех клиентов)
README рекомендует одну команду: она ставит uv, находит агенты на вашем компьютере, даёт выбрать, какие из них настроить, и устанавливает и включает аддон Blender. В каждый конфиг-файл она добавляет только запись blender и сохраняет копию .bak каждого изменённого файла.
macOS / Linux:
curl -LsSf https://www.mcp-for-blender.com/install.sh | sh
Windows (PowerShell):
irm https://www.mcp-for-blender.com/install.ps1 | iex
Если uv уже есть:
uvx mcp-for-blender setup
Если пустить скрипт из интернета прямо в оболочку, он выполнится с правами вашего пользователя. Если вам это не нравится, используйте ручные шаги ниже: они делают то же самое по одному. В любом случае после этого полностью закройте и снова откройте агент.
Установка Blender MCP в Claude Code
- Установите uv. В README указано
brew install uvдля macOS,curl -LsSf https://astral.sh/uv/install.sh | shдля Linux иwinget install --id=astral-sh.uv -eдля Windows. README предупреждает не использоватьpip install uv: он может не создать командуuvx. - Зарегистрируйте сервер в Claude Code. Это команда из README:
claude mcp add blender uvx mcp-for-blender
- Проверьте. В документации Claude Code по MCP описаны
claude mcp list(показывает статус вроде «✔ Connected») иclaude mcp get blender, а панель/mcpвнутри сессии показывает то же самое.
По умолчанию claude mcp add сохраняет сервер только для текущего проекта. Добавьте --scope user, чтобы он работал во всех проектах. В общей форме из документации команда сервера идёт после --: claude mcp add [options] <name> -- <command> [args...]. Если вы добавляете параметры вроде --scope или --env, -- обязателен.
Чтобы отключить анонимную телеметрию использования проекта, README советует задать серверу переменную окружения DISABLE_TELEMETRY=true. В Claude Code она передаётся через --env перед --.
Установка Blender MCP в Codex
Codex CLI, десктопное приложение Codex и расширение для IDE используют один конфиг-файл, ~/.codex/config.toml, так что одной настройки хватает на все три.
Обычный MCP-сервер. Команда из README:
codex mcp add blender -- uvx mcp-for-blender
Или добавьте вручную в ~/.codex/config.toml:
[mcp_servers.blender]
command = "uvx"
args = ["mcp-for-blender"]
Выполните codex mcp list и убедитесь, что blender показан как включённый. Инструменты появятся при следующем запуске Codex, а /mcp в терминальном интерфейсе Codex показывает активные серверы. В документации OpenAI по MCP в Codex также описаны таблица env для переменных окружения, startup_timeout_sec (по умолчанию 10) и tool_timeout_sec (по умолчанию 60). В десктопном приложении откройте Settings → MCP servers → Add server, назовите сервер blender, выберите STDIO и введите uvx mcp-for-blender.
Плагин Codex. README рекомендует этот путь для Codex. Он добавляет в чат живой вьюпорт Blender, выбор по миниатюрам для Poly Haven, Sketchfab и Poly Pizza и @-упоминания объектов сцены. В каталоге плагинов Codex его пока нет, поэтому добавляйте из репозитория:
git clone https://github.com/ahujasid/blender-mcp.git
codex plugin marketplace add ./blender-mcp/integrations/codex
Затем перезапустите Codex, установите MCP for Blender из каталога плагинов и попросите Codex им воспользоваться.
Cursor и другие клиенты
В Cursor откройте Settings → MCP и добавьте глобальный сервер или создайте в проекте .cursor/mcp.json с таким содержимым:
{
"mcpServers": {
"blender": {
"command": "uvx",
"args": [
"mcp-for-blender"
]
}
}
}
В Windows README использует "command": "cmd" и "args": ["/c", "uvx", "mcp-for-blender"]. В README также есть кнопки установки в один клик для Cursor и VS Code и блоки конфигурации для Claude Desktop, OpenCode и Antigravity. Там сказано запускать только одну копию сервера одновременно, например Cursor или Claude Desktop, но не оба сразу.
Подключение аддона Blender
Быстрый установщик делает это за вас. Вручную:
- Выполните
uvx mcp-for-blender install-addon. Команда копирует аддон в папку аддонов Blender под именемblender_mcp.py. - В Blender откройте Edit → Preferences → Add-ons и включите Interface: MCP for Blender. Если его нет в списке, перезапустите Blender или нажмите Install… и выберите скопированный файл. Можно также скачать
addon.pyиз репозитория и установить его. - В 3D-вьюпорте нажмите N, чтобы открыть боковую панель, и найдите вкладку MCP for Blender. Аддон запускает свой сервер при открытии Blender. Если он не работает, нажмите Start MCP Server.
Во вкладке аддона включаются необязательные функции: Poly Haven, Poly Pizza (нужен бесплатный API-ключ) и генераторы 3D.
Если агент не подключается: убедитесь, что Blender открыт и аддон запущен, и не запускайте uvx mcp-for-blender сами в терминале (так сказано в таблице устранения неполадок README). Приложения, запущенные из Dock или меню «Пуск», могут не найти uvx и завершиться с ошибкой spawn uvx ENOENT. Это лечится так: укажите в качестве команды полный путь из which uvx (macOS/Linux) или where uvx (Windows). Если не помогло, перезапустите и агент, и Blender.
Пример: низкополигональный игровой предмет, от промпта до three.js
Цель: сундук с сокровищами для браузерной игры, достаточно небольшой, чтобы быстро грузиться, в формате, который three.js читает напрямую. Этот порядок действий мы составили по документации и не прогоняли от начала до конца, поэтому размеры файлов и точные результаты могут отличаться.
1. Сначала сохраните файл Blender
Откройте новый файл Blender и сохраните его (например, как chest.blend) до того, как начнёт работать агент. Агент меняет ваш файл напрямую, и собственное предупреждение README — всегда сохранять работу заранее.
2. Отправьте агенту промпт
В Claude Code или Codex, когда Blender открыт и подключён:
Use the Blender MCP tools. In the current scene, build a low-poly treasure chest
for a browser game:
- About 1 m wide, 0.6 m deep, 0.7 m tall, sitting on the ground at z = 0,
origin at the bottom centre.
- A box body and a curved lid made from a half-cylinder with 8 segments,
plus metal bands and a lock plate. Keep it under 1,500 triangles.
- Flat-shaded materials using Principled BSDF base colours only
(dark wood, brass), no image textures.
- Apply all modifiers and transforms, join everything into one object named "Chest".
- Check it with the look tool from several angles and fix anything that
overlaps or floats.
- Then select only "Chest" and export it as a GLB to ./public/models/chest.glb.
Show me each script before you run it.
Несколько решений в этом промпте важны для игр. Простые базовые цвета экспортируются чисто, потому что экспортёр glTF берёт базовый цвет из узла Principled BSDF, как сказано в руководстве Blender по glTF. Один объединённый объект означает один меш в three.js. Начало координат внизу означает, что сундук встанет на пол, если задать позицию y = 0. Лимит треугольников не даёт агенту добавить сглаживание subdivision.
3. Шаг экспорта
Python для Blender пишет агент. Экспорт обычно заканчивается вызовом вроде этого, с параметрами, описанными в API export_scene в Blender:
import bpy
bpy.ops.export_scene.gltf(
filepath="/path/to/your-game/public/models/chest.glb",
export_format='GLB', # single binary file: mesh, materials and images packed together
use_selection=True, # only the selected "Chest" object
export_apply=True, # apply modifiers on export
export_yup=True, # glTF's +Y up convention, which three.js also uses
)
Прочитайте этот скрипт, прежде чем одобрить его, как и любой скрипт, который запускает агент. Проверьте, что путь ведёт внутрь вашего проекта и ничто не удаляет и не перезаписывает нужные вам файлы.
4. Сожмите GLB с помощью glTF-Transform
glTF-Transform — инструмент командной строки для оптимизации файлов glTF. Установите его и запустите optimize. Вот команды из его README:
npm install --global @gltf-transform/cli
gltf-transform optimize input.glb output.glb --texture-compress webp
Для нашего сундука:
gltf-transform optimize public/models/chest.glb public/models/chest.opt.glb --texture-compress webp
По умолчанию optimize сжимает геометрию с помощью meshopt (--compress meshopt), ограничивает текстуры 2048 px и упрощает граф сцены. У нашего сундука нет текстур-изображений, поэтому --texture-compress webp здесь ничего не делает, но оставьте параметр для предметов с текстурами. Чтобы сжать только геометрию, в glTF-Transform есть ещё gltf-transform meshopt input.glb output.glb --level medium.
5. Загрузите в three.js
Файл, сжатый meshopt, требует декодера meshopt. Без него GLTFLoader выбросит ошибку «setMeshoptDecoder must be called before loading compressed files». Импорты ниже — те же, что three.js использует в собственных примерах:
import { GLTFLoader } from 'three/addons/loaders/GLTFLoader.js';
import { MeshoptDecoder } from 'three/addons/libs/meshopt_decoder.module.js';
const loader = new GLTFLoader();
loader.setMeshoptDecoder(MeshoptDecoder);
const gltf = await loader.loadAsync('/models/chest.opt.glb');
const chest = gltf.scene;
chest.position.set(0, 0, -3); // origin is at the bottom, so y = 0 puts it on the floor
scene.add(chest);
Blender работает в метрах, как и большинство сцен three.js, поэтому сундук должен загрузиться шириной около 1 м. Если он лежит на боку, скорее всего, экспорт шёл без export_yup. Если он чёрный, сцене нужен свет: добавьте HemisphereLight или карту окружения.
6. Повторяйте
Держите файл Blender открытым и просите правки, например «сделай так, чтобы крышка открывалась на 40 градусов, как отдельный объект с именем Lid» или «добавь внутрь кучу золота». Затем снова запустите экспорт и команду optimize. Попросите агента сохранить скрипт экспорта в вашем проекте, чтобы каждый раз использовались одни и те же настройки.
Ограничения и безопасность
- Он запускает любой Python внутри Blender. Предупреждение README: «The
execute_blender_codetool allows running arbitrary Python code in Blender, which can be powerful but potentially dangerous.» Python в Blender может читать и записывать любые файлы, доступные вашей учётной записи. Просите агента показывать скрипты перед запуском и читайте их. - Сохраняйте файл перед каждой сессией. То же предупреждение заканчивается так: «ALWAYS save your work before using it.» Сохраняйте версии по ходу работы (File → Save Incremental).
- Включите безопасный режим, если вам не нужен доступ к файлам и сети. Задайте серверу
BLENDER_MCP_SAFE_MODE=1. Тогда каждый скрипт проверяется перед запуском, а код, который напрямую читает или пишет файлы, запускает другие программы, использует сеть или продолжает работать после завершения скрипта, блокируется. Моделирование, материалы, рендер, сохранение и импорт/экспорт продолжают работать. - Держите его на localhost. У сокета аддона нет ни аутентификации, ни шифрования. Любой, кто достучится до этого порта, может запускать Python в вашем Blender. Не открывайте его в сети, которой вы не доверяете.
- Разбивайте большие задачи на шаги. README говорит, что сложным операциям могут понадобиться более мелкие шаги, а таймауты лечатся упрощением запроса. Загрузки с Poly Haven идут в главном потоке Blender, поэтому он зависает, пока они не закончатся.
- Проверяйте лицензии ассетов. Poly Haven — это CC0. Около 69% Poly Pizza — CC-BY, что требует указания авторства. Аддон записывает строку с указанием авторства в импортированные объекты, а искать можно с
licence="CC0". - Телеметрия. По умолчанию сервер отправляет анонимную запись об использовании: ID установки, ID сессии, имя инструмента, успех, длительность, версии, ОС и время. Ваши промпты, код, скриншоты и данные сцены собираются только если вы согласитесь.
DISABLE_TELEMETRY=trueотключает всё.
Альтернативы Blender MCP
- Blender MCP от Blender Lab: собственный сервер Blender. Он меньше и построен вокруг документации по Python API, сводок по сцене и файлам, скриншотов и запуска кода, включая фоновый режим для файлов
.blend. Ему нужен Blender 5.1+, лицензия GPL-3.0. По его вики настройка заключается в клонировании репозитория и запуске черезuv --directory .../blender_mcp/mcp run blender-mcp. Выбирайте его, если нужен официальный проект и вам не нужны поиск ассетов и генерация моделей ИИ. - Blender Agent Skills: 28 скиллов для Blender 5.2 LTS+ (моделирование, UV, запекание, риггинг, анимация, оптимизация, экспорт) для Claude Code, Codex, OpenCode, Gemini CLI, Copilot и Cursor. MIT. Скиллы учат агента, как делать работу. MCP-сервер даёт ему управление Blender. Можно использовать оба.
- blender-game-skills: скиллы Claude Code, которые превращают концепт-арт в риггованные 3D-ассеты, готовые для игры. MIT.
- Готовые модели. Для типовых предметов бесплатная модель часто быстрее, чем генерация. См. низкополигональные GLB от Polyfork.
В нашем списке скиллов для агентов и MCP-серверов для разработки игр есть аналоги для Godot, Unity, Unreal и three.js.
Частые вопросы
Blender MCP бесплатный?
Да. MCP for Blender распространяется под лицензией MIT, аддон бесплатный. На его странице Premium сказано, что все функции работают на бесплатном тарифе и платной является только генерация 3D. Можно использовать Meshy, Tripo, Hunyuan3D, Hyper3D Rodin или World Labs со своими API-ключами или купить Premium (от $10 в месяц на 21 ноября 2026 года), чтобы работать без ключей. Сервер Blender Lab бесплатен по GPL-3.0. Подписку или использование API вашего ИИ-агента вы оплачиваете отдельно.
Blender MCP безопасен?
Он безопасен настолько, насколько безопасен код, который вы ему позволяете выполнять. Агент запускает Python внутри Blender, а у этого Python есть доступ к файлам с правами вашего пользователя. Сохраняйте работу, читайте скрипты перед одобрением, используйте безопасный режим (BLENDER_MCP_SAFE_MODE=1) и держите порт аддона на localhost. Устанавливайте из официального репозитория или скриптом самого проекта, а не из чьей-то перезалитой копии.
Есть ли официальный сервер Blender MCP?
Да. Blender Lab публикует его по адресу projects.blender.org/lab/blender_mcp, а каталог коннекторов Claude показывает его как «Blender», автор — Blender Lab. Более известный MCP for Blender (раньше blender-mcp) — сторонний проект, не связанный с Blender Foundation.
Работает ли Blender MCP с Claude Code?
Да. Выполните claude mcp add blender uvx mcp-for-blender, откройте Blender с включённым аддоном и проверьте через claude mcp list. Claude Desktop настраивается вместо этого блоком JSON в claude_desktop_config.json.
Работает ли Blender MCP с Codex?
Да. Выполните codex mcp add blender -- uvx mcp-for-blender или добавьте [mcp_servers.blender] в ~/.codex/config.toml. В README есть и плагин Codex, который показывает живой вьюпорт Blender рядом с чатом.
Работает ли Blender MCP с ChatGPT?
В README перечислены десктопные и кодинговые клиенты (Claude Desktop, Claude Code, Codex, Cursor, VS Code, Windsurf, OpenCode, Antigravity), приложения ChatGPT среди них нет. Для этого у OpenAI есть агент Codex. Сервер общается с Blender, запущенным на вашем компьютере, поэтому нужен клиент, который умеет запускать локальный MCP-сервер.
Где вкладка Blender MCP?
В 3D-вьюпорте Blender нажмите N, чтобы открыть боковую панель. Вкладка называется MCP for Blender. Если её нет, включите Interface: MCP for Blender в Edit → Preferences → Add-ons.
Blender MCP или скилл для Blender?
MCP-сервер позволяет агенту работать с живым Blender: создавать объекты, смотреть на вьюпорт, экспортировать. Скилл учит агента рабочим процессам и соглашениям Blender, что помогает независимо от того, работает ли он через MCP или запускает Blender без интерфейса из командной строки. Для игровых ассетов хорошо работает сочетание. MCP-сервер строит, а набор скиллов вроде Blender Agent Skills отвечает за UV, оптимизацию и настройки экспорта.
Источники
Проверено 21 ноября 2026 года: README mcp-for-blender, MCP for Blender Premium, Blender Lab blender_mcp и его вики по установке, документация Claude Code по MCP, документация Codex по MCP, API export_scene в Blender, руководство Blender по glTF 2.0, glTF-Transform CLI, three.js GLTFLoader.


