Раньше с нейросетью в Blender работали так: просите скрипт, копируете, вставляете в окно Text Editor, нажимаете Run, ловите ошибку, несёте её обратно в чат. Blender MCP убирает эту беготню: модель сама видит открытую сцену, сама запускает код и сама смотрит, что получилось. Если вы раньше пользовались промптами для ChatGPT в 3D, это следующий шаг: нейросеть, которая сама управляет Blender, а не выдаёт текст для ручного переноса.
Проект ahujasid/blender-mcp за год вырос до десятков тысяч звёзд на GitHub, а клиентов, которые умеют подключать такие серверы, стало заметно больше. Ниже установка под Windows по шагам, проверка, что всё работает, реальные границы возможностей и то, как не потерять файл из-за кода, который выполнила модель.
Коротко о главном:
- Что такое Blender MCP? Это аддон для Blender плюс небольшой сервер на Python. Аддон открывает локальный порт внутри Blender, сервер переводит вызовы клиента (Claude Desktop, Cursor и других) в команды для сцены: создать объект, поменять материал, прочитать сцену, выполнить Python-код.
- Как подключить Claude к Blender? Нужны три вещи: менеджер пакетов uv, аддон в Blender с запущенным сервером и блок
mcpServersв настройках клиента. На диск всё ставится одной командойuvx mcp-for-blender install-addon. - Какие версии? По README нужен Blender 3.0 или новее и Python 3.10 или новее. Актуальная версия пакета на момент написания: 2.1.9 от 6 октября 2026 года. Blender 5.2 LTS вышел 14 июля 2026 года.
- Безопасно ли это? Инструмент выполнения кода запускает произвольный Python с вашими правами. Работайте на копии файла и сохраняйтесь перед каждым серьёзным запросом.
- Работает ли с ChatGPT? Сам сервер от клиента не зависит. Нужен клиент, который умеет подключать MCP-серверы; проверьте, есть ли такая функция в вашей версии и тарифе.
- Нужна ли платная подписка? Сам аддон бесплатный (лицензия MIT). Вопрос в том, какой тариф клиента позволяет подключать локальные серверы и сколько сообщений вам хватит на сцену: это смотрите в условиях вашего тарифа.
Дальше по порядку: чем MCP отличается от скрипта, установка и подключение клиентов, примеры задач, где модель ошибается, безопасность, лимиты, альтернативные серверы и ответы на частые вопросы.

Blender MCP и скрипт из чата: в чём разница
MCP (Model Context Protocol) это открытый протокол, по которому приложение-клиент получает от сервера список инструментов и может их вызывать. Для Blender инструментами становятся «прочитать сцену», «посмотреть вьюпорт», «найти ассет», «выполнить код». Модель выбирает инструмент, получает результат и решает, что делать дальше. Описание протокола есть на официальном сайте MCP.
Практическая разница: в обычном чате вы единственный глаз и единственные руки. Модель не знает, как называются ваши объекты, где стоит камера и что сломалось после запуска. Через MCP она читает данные сцены сама и видит снимок вьюпорта, поэтому может исправить собственную ошибку без вашего участия.
Скрипт из чата и работа через MCP: что меняется для вас
- Скорость: медленнее, каждый круг «ответ, копирование, запуск, ошибка» делаете вы.
- Контроль: полный, вы читаете код до запуска.
- Риск для файла: ниже, ничего не выполняется без вашего нажатия.
- Лимиты: меньше сообщений, но больше ваших действий.
- Скорость: выше на цепочках из многих мелких шагов, модель сама проверяет результат.
- Контроль: зависит от настроек клиента, часть вызовов можно подтверждать вручную.
- Риск для файла: выше, код выполняется внутри открытой сцены.
- Лимиты: расходуются быстрее, потому что каждый шаг и снимок вьюпорта это отдельный обмен.
Основы bpy и ручной запуск скриптов я разбирал отдельно в статье про первые скрипты на Python в Blender. Здесь предполагается, что писать код вы не обязаны.
Путь команды: от вашей фразы до объекта в сцене
Схема помогает понять, где искать поломку, когда что-то не работает. Фраза уходит в клиент, клиент вызывает сервер, сервер по локальному сокету обращается к аддону, а аддон выполняет действие внутри Blender и возвращает данные.
Путь команды и ответа
- Выпишете запрос словами
- КлиентClaude Desktop или Cursor выбирает инструмент
- MCP-серверзапускается через uvx на вашем ПК
- Аддон в Blenderслушает порт 9876
- Сценаобъекты, материалы, свет; обратно идут данные сцены и скриншот вьюпорта
Практический вывод: поломка почти всегда в одном из трёх звеньев. Либо клиент не нашёл сервер (ошибка в конфиге или нет uv), либо сервер не достучался до порта (в Blender не нажато подключение), либо модель получила ответ, но решила задачу плохо. Диагностику проще начинать с первого звена.
Что понадобится для установки
- Blender. По README подходит 3.0 и новее, то есть любая 4.x и 5.x. Проект ориентирован на актуальные ветки, поэтому для чистоты проверки берите свежий LTS.
- Python 3.10 или новее. Нужен для сервера, который запускается вне Blender. Внутри Blender используется его встроенный Python, отдельно ставить его не надо.
- uv. Менеджер пакетов, через который запускается сервер. README просит ставить его официальным установщиком, а не через pip.
- Клиент с поддержкой MCP. Claude Desktop, Cursor и другие. О доступности сервисов в вашей стране и о тарифах смотрите в условиях самих сервисов: в этой статье это не обсуждается.
- Копия рабочего файла. Да, это пункт требований, а не совет на будущее.
Проверить, что uv установился: откройте PowerShell и выполните uv --version. Если команда не найдена, закройте и откройте терминал заново, иначе путь не подтянется.
Установка аддона и запуск сервера в Blender
Актуальный README репозитория (github.com/ahujasid/blender-mcp) сообщает, что пакет переименован с blender-mcp в mcp-for-blender, при этом прежние установки продолжают работать без изменения конфига. На момент написания в PyPI лежит версия 2.1.9. Порядок такой:
- В PowerShell выполните
uvx mcp-for-blender install-addon. Команда копирует файл аддона в папку аддонов Blender под именемblender_mcp.py. - Запустите Blender и откройте Edit → Preferences → Add-ons. В поиске введите «MCP for Blender» и поставьте галочку.
- В 3D-вьюпорте нажмите N, чтобы открыть боковую панель, и найдите вкладку аддона. В ней запускается сервер соединения; по умолчанию он слушает порт 9876.
- Не закрывайте Blender: пока он открыт и сервер включён, клиент сможет подключаться.
Признак успеха: в панели аддона виден статус запущенного сервера, а порт 9876 не заблокирован другой программой. Если порт занят, его меняют переменной окружения BLENDER_PORT, и тогда то же число должно стоять в настройках сервера.
Подключение Claude Desktop: файл настроек и проверка инструментов
Шаги установки и проверки
- Поставьте uvофициальным установщиком, затем проверьте
uv --version - Установите аддон
uvx mcp-for-blender install-addon, включите его в Preferences - Запустите серверна боковой панели N в Blender, порт 9876
- Допишите настройки клиентаблок
mcpServersс командойuvx - Проверьте инструментыперезапустите клиент и откройте список коннекторов
- Отправьте первый запроснапример, попросите описать текущую сцену
В Claude Desktop откройте окно настроек самого приложения, вкладку Developer, кнопку Edit Config. На Windows файл лежит по пути %APPDATA%\Claude\claude_desktop_config.json. Добавьте в него:
{
"mcpServers": {
"blender": {
"command": "uvx",
"args": ["mcp-for-blender"]
}
}
}
Если в файле уже есть другие серверы, добавляйте блок blender рядом, а не заменяйте всё содержимое: запятые и скобки должны сойтись. Затем полностью закройте Claude Desktop (не просто окно, а процесс) и запустите снова. Документация MCP предлагает проверять подключение через значок добавления файлов и коннекторов в строке ввода: сервер должен быть в списке, а у него виден перечень инструментов.
Если сервера нет: проверьте JSON, убедитесь, что uvx запускается в терминале, и посмотрите логи в %APPDATA%\Claude\logs, файл mcp.log и файл с именем вашего сервера. Для первой проверки хорош запрос «опиши, что сейчас в сцене Blender»: если ответ содержит названия ваших объектов, вся цепочка работает.
Подключение Cursor и других клиентов Blender MCP
В Cursor сервер добавляется через Settings → MCP тем же JSON-блоком. Для Windows README отдельно советует обернуть вызов в cmd:
{
"mcpServers": {
"blender": {
"command": "cmd",
"args": ["/c", "uvx", "mcp-for-blender"]
}
}
}
Причина в том, что на Windows часть клиентов не находит uvx напрямую. Если в Claude Desktop у вас сработал первый вариант, а в Cursor нет, пробуйте именно обёртку. Для остальных клиентов схема одна: найдите у них раздел MCP или коннекторов, возьмите тот же блок, а команду подберите по поведению на вашей системе.
Когда клиентов два, не держите включённым сразу оба с одним сервером: две копии будут стучаться в один порт Blender, и ответы начнут путаться. Работайте из одного окна и меняйте клиент осознанно.
Первая сцена по описанию: чего ждать от первого запроса
Для первого прогона возьмите простую задачу, где легко увидеть результат: «собери в пустой сцене маленькую комнату из примитивов: пол, три стены, стол, стул, полка и один тёплый источник света; посмотри на результат во вьюпорте и скажи, что не так».
Что проверять после ответа:
- Масштаб. Стул размером со стол или полка под потолком выглядят как беда, но это типичный первый результат. Попросите: «стол высотой около 75 см, стул около 45 см до сиденья».
- Положение. Предметы могут частично проваливаться в пол. Просьба «поставь все предметы на пол без пересечений, проверь по bounding box» обычно решает вопрос.
- Имена объектов. Просите называть всё осмысленно сразу, иначе потом придётся наводить порядок.
Ожидайте не идеальный результат, а черновую расстановку, которую вы дальше правите словами или руками. Что именно получилось у меня и сколько итераций ушло, зависит от версии клиента и модели, поэтому честнее проверить на своей сцене и записать, сколько правок вам понадобилось: это и есть ваша личная метрика полезности.

Материалы, свет и камера: где выигрыш заметнее всего
Если вычеркнуть сложные формы, у модели лучше всего получаются задачи, которые можно описать правилами: назначить материал, расставить свет по схеме, выставить камеру. Именно тут экономится время, потому что вручную это десятки кликов по панелям.
- Материалы. «Сделай стекло для вазы, матовую бумагу для книги и шлифованный металл для лампы, параметры Principled BSDF подбери реалистично». Проверьте значения Roughness, Metallic и IOR: стекло должно иметь Transmission, металл Metallic около единицы.
- Свет. «Поставь трёхточечный свет вокруг объектов: ключевой слева сверху, заполняющий слабее справа, контровой сзади». Хорошо видно по скриншоту, не ушла ли тень в чёрное.
- Камера. «Поставь камеру под углом тридцать градусов к столу, фокусное 50 мм, кадр по правилу третей». Проверяйте через вид из камеры.
Просите итоговый рендер низкого разрешения как проверку, а не как конечный результат: полноценный рендер модель запускает так же, как вы, и займёт он столько же времени. Про причины медленной работы вьюпорта на таких сценах есть отдельный разбор.

Ассеты по запросу: Poly Haven, Sketchfab, Hyper3D и Hunyuan3D
README перечисляет несколько встроенных источников. Poly Haven отдаёт HDRI, текстуры и модели под лицензией CC0, ключ не нужен. Sketchfab требует ключ API, Poly Pizza просит бесплатный ключ. Для генерации моделей по тексту или картинке подключаются Hyper3D Rodin, Hunyuan3D и Tripo, и у каждого свои условия доступа.
Источники ассетов в Blender MCP
| Источник | Что даёт | Ключ API |
|---|---|---|
| Poly Haven | HDRI, текстуры, модели CC0 | не нужен |
| Sketchfab | готовые модели | нужен |
| Poly Pizza | низкополигональные модели | бесплатный |
| Hyper3D Rodin, Hunyuan3D, Tripo | генерация модели из текста или картинки | зависит от сервиса |
Типичный запрос: «найди на Poly Haven HDRI закатного неба и поставь как окружение; импортируй деревянный стол и подгони размер под комнату». Проверьте лицензию каждого скачанного ассета: CC0 разрешает коммерческое использование, а модели Sketchfab могут иметь собственные условия. Сгенерированные модели из облачных сервисов почти всегда требуют ретопологии, об этом ниже и в материале про Tripo AI. Как формулировать описание для генератора, написано в статье про структуру промпта для 3D-генератора.
Где нейросеть ошибается: топология, масштаб, сложные модификаторы
Модель отлично управляется с параметрами и плохо чувствует геометрию. Заранее знайте типичные провалы:
- Топология. Всё, что нужно для анимации, скульптинга или печати, модель собирает «на глаз»: лишние треугольники, N-гоны, неряшливые стыки. Для персонажа или серьёзного хард-сёрфейса риски высоки.
- Масштаб и единицы. Без явной подсказки ошибки в размерах повторяются. Задавайте единицы и реальные размеры сразу.
- Цепочки модификаторов. Порядок Mirror, Bevel, Subdivision, Boolean важен, и модель иногда расставляет их неверно. Узнаёте по перекошенным краям или пропавшим фасками.
- Геонорды и шейдерные ноды. Простые деревья строятся, сложные требуют нескольких итераций и вашей проверки.
- Долгие операции. Тяжёлая симуляция или запекание может подвесить соединение; Blender в это время не отвечает.
Признак, что задача вам не подойдёт: вы тратите на объяснение больше слов, чем ушло бы на ручное действие. Тогда лучше сделать руками или сгенерировать модель отдельно и довести её руками.
Безопасность: произвольный Python, копии файла и отключение рискованного
README открыто предупреждает: инструмент execute_blender_code выполняет произвольный Python в Blender, и перед его использованием нужно сохранить работу. Python в Blender имеет доступ к файловой системе так же, как любая программа, которую вы запустили. Модель обычно не вредит намеренно, но ошибки в коде, неверно понятая просьба или вредный текст внутри импортируемого файла вполне могут привести к потере данных.
На странице пакета в PyPI добавлено ещё одно замечание: сокет-сервер аддона не имеет аутентификации, поэтому его следует держать только на localhost. Не пробрасывайте порт наружу и не включайте доступ из сети.
- Работайте на копии. Сохраните Save As с суффиксом, например
scene_mcp_test.blend, и ведите эксперименты в нём. - Сохраняйтесь между запросами. Включите автосохранение и сохраняйте версию вручную перед сложной просьбой.
- Просите описать план до выполнения. «Сначала напиши, что собираешься сделать, и жди подтверждения» для рискованных операций: удаления, массового переименования, работы с файлами.
- Подтверждайте вызовы в клиенте. Не включайте автоматическое разрешение для сервера, если не уверены.
- Безопасный режим. В списке переменных окружения README есть
BLENDER_MCP_SAFE_MODE: изучите, что он отключает в вашей версии, прежде чем полагаться на него. - Телеметрия. По README она добровольная: по умолчанию собираются минимальные анонимные сведения, а запросы, код и скриншоты только после явного согласия. Есть инструмент
disable_telemetry.
Лимиты и стоимость: сколько сообщений уходит на сцену
Точных цифр здесь не будет: расход зависит от клиента, модели и тарифа, а условия меняются. Зато понятно, что именно съедает лимит:
- каждый вызов инструмента это отдельный шаг, а на одну просьбу модель может сделать несколько;
- снимки вьюпорта добавляют заметный объём контекста, особенно если просить их после каждого шага;
- длинная беседа тянет за собой всю историю, поэтому для новой сцены лучше начинать новый чат.
Как экономить: формулируйте задачу целиком, а не по одному предмету; просите проверять результат один раз в конце, а не после каждого действия; выносите повторяющееся в готовое описание. Измерьте расход на своей простой комнате: сколько процентов суточного или недельного лимита ушло. Это даст честную оценку для вашего тарифа лучше любой чужой цифры. Для скриптов, которые модель пишет один раз, а потом вы запускаете их многократно, лимиты тратятся только на написание, это плюс обычного подхода.
Другие серверы для Blender: Blender MCP Pro и альтернативные проекты
Оригинал не единственный. На форуме Blender Artists обсуждается Blender MCP Pro: разработчик заявляет больше сотни инструментов в 14 категориях (свет, модификаторы, анимация, ноды шейдеров и геометрии, камера, рендер, импорт и экспорт, UV, риггинг, пакетные операции), поддержку Blender 4.0 и новее с рекомендацией 5.0 и семидневный пробный период.
Два сервера для Blender по заявлениям авторов
| Параметр | blender-mcp (mcp-for-blender) | Blender MCP Pro |
|---|---|---|
| Набор инструментов | 9 основных, остальное через выполнение кода | 100+ отдельных инструментов |
| Лицензия и цена | MIT, бесплатно | пробный период 7 дней, дальше условия автора |
| Версии Blender | 3.0 и новее | 4.0 и новее |
Участники обсуждения отметили две вещи: опытному пользователю горячие клавиши часто быстрее, а новичку такой сервер сглаживает порог входа. Прозвучали и опасения насчёт неизвестного разработчика. Логика простая: чем больше у сервера прав и чем меньше известна его команда, тем внимательнее нужно читать, что он запускает. Для первого знакомства берите открытый проект с кодом, который можно прочитать. Среди аддонов, которые стоит иметь рядом независимо от MCP, есть подборка аддонов для Blender 2026.
Запросы для повседневной рутины: переименование, выравнивание, пакетный экспорт
Самая надёжная польза от Blender MCP не в «смоделируй дом», а в скучных операциях, которые можно описать одним предложением. Примеры, которые стоит проверить на копии файла:
- Переименование. «Переименуй все меши по схеме тип_смысл_номер, источники света начни с light_, а камеры с cam_. Сначала покажи таблицу старых и новых имён».
- Выравнивание. «Выровняй выбранные объекты по оси X с равным шагом и поставь нижнюю грань каждого на нулевую высоту».
- Пакетный экспорт. «Экспортируй каждый объект коллекции Props отдельным FBX в папку export рядом с файлом, с применёнными трансформациями. Перед запуском напиши, какие файлы будут созданы».
- Уборка. «Найди объекты без материала и объекты с не применёнными масштабами, выведи списком и ничего не меняй».
Для каждой просьбы сначала просите отчёт, а уже потом разрешайте изменения: так вы видите, что именно модель собирается сделать.
Итог: кому подойдёт и с чего начать
Blender MCP полезен тем, кто тратит много времени на однотипные операции в сцене: материалы, свет, расстановка, переименования, экспорт. Новичку он помогает быстро собрать черновик и увидеть, как устроены параметры. Для сложной топологии и персонажей это пока вспомогательный инструмент, а не замена моделлеру. Если нужны ассеты из облачных генераторов, всё равно потребуется ручная доводка.
С чего начать вечером: поставьте uv, выполните uvx mcp-for-blender install-addon, включите аддон, подключите Claude Desktop, попросите описать пустую сцену. Потом соберите комнату из примитивов, измерьте число правок и расход лимита и решите, окупается ли это для ваших задач. Всё на копии файла.
Частые вопросы
Что такое Blender MCP простыми словами?
Это мост между Blender и нейросетью: аддон открывает в программе локальный порт, а сервер даёт клиенту инструменты для чтения и изменения сцены. Благодаря этому модель сама видит сцену и сама выполняет действия, а не просто пишет текст.
Нужна ли платная подписка Claude для Blender MCP?
Сам аддон бесплатный, лицензия MIT. Нужна ли платная подписка, зависит от того, какой тариф клиента разрешает подключать локальные серверы и сколько сообщений даёт, поэтому смотрите актуальные условия в Claude Desktop или Cursor.
Работает ли Blender MCP с ChatGPT?
Сервер не привязан к конкретной модели: подойдёт любой клиент с поддержкой MCP и подключением локальных серверов. Есть ли такая возможность в вашей версии ChatGPT или другого приложения, проверьте в его настройках и документации.
Безопасно ли давать нейросети выполнять код в Blender?
Это риск, и разработчики о нём прямо предупреждают: инструмент выполнения кода запускает произвольный Python с вашими правами. Работайте на копии файла, сохраняйтесь между запросами, подтверждайте вызовы вручную и держите порт только на localhost.
Может ли нейросеть сама смоделировать объект в Blender?
Простые формы из примитивов, расстановку, материалы и свет она делает уверенно. Сложные модели с чистой топологией для анимации или печати выходят неровными, поэтому после генерации сетку нужно проверять и приводить в порядок руками.
Почему Claude Desktop не видит сервер Blender?
Чаще всего причина в ошибке JSON, в том, что uvx не найден в системе, или в том, что клиент не был полностью перезапущен. Проверьте файл claude_desktop_config.json, команду uv --version в терминале и логи в папке %APPDATA%\Claude\logs.
Чем Blender MCP отличается от запроса скрипта у нейросети?
Скрипт вы переносите и запускаете руками, а через MCP модель сама читает сцену, выполняет код и смотрит результат. Выигрыш заметен на цепочках мелких шагов, а цена за него это более высокий риск для файла и больший расход лимитов.
Начните с одной небольшой просьбы на копии файла и вернитесь к статье, когда увидите, на каких задачах модель действительно помогает именно вам. Если сравнивать модели по точности на 3D-запросах, пригодится разбор ChatGPT и Claude на 3D-промптах.


