Перейти к содержимому
AI-инструменты аналитика · 3 ноября 2026

Blender MCP: подключаем Claude к Blender по шагам

автор web3D.pro чтение 17 мин обновлено 3 ноября 2026 Telegram X
Blender MCP: подключаем Claude к Blender по шагам

Раньше с нейросетью в 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 отличается от скрипта, установка и подключение клиентов, примеры задач, где модель ошибается, безопасность, лимиты, альтернативные серверы и ответы на частые вопросы.

Рабочее место 3D-художника с двумя мониторами: сцена и окно чата

Blender MCP и скрипт из чата: в чём разница

MCP (Model Context Protocol) это открытый протокол, по которому приложение-клиент получает от сервера список инструментов и может их вызывать. Для Blender инструментами становятся «прочитать сцену», «посмотреть вьюпорт», «найти ассет», «выполнить код». Модель выбирает инструмент, получает результат и решает, что делать дальше. Описание протокола есть на официальном сайте MCP.

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

Скрипт из чата и работа через MCP: что меняется для вас

Нейросеть пишет скрипт, вы запускаете

  • Скорость: медленнее, каждый круг «ответ, копирование, запуск, ошибка» делаете вы.
  • Контроль: полный, вы читаете код до запуска.
  • Риск для файла: ниже, ничего не выполняется без вашего нажатия.
  • Лимиты: меньше сообщений, но больше ваших действий.
Нейросеть действует через MCP

  • Скорость: выше на цепочках из многих мелких шагов, модель сама проверяет результат.
  • Контроль: зависит от настроек клиента, часть вызовов можно подтверждать вручную.
  • Риск для файла: выше, код выполняется внутри открытой сцены.
  • Лимиты: расходуются быстрее, потому что каждый шаг и снимок вьюпорта это отдельный обмен.

Основы bpy и ручной запуск скриптов я разбирал отдельно в статье про первые скрипты на Python в Blender. Здесь предполагается, что писать код вы не обязаны.

Путь команды: от вашей фразы до объекта в сцене

Схема помогает понять, где искать поломку, когда что-то не работает. Фраза уходит в клиент, клиент вызывает сервер, сервер по локальному сокету обращается к аддону, а аддон выполняет действие внутри Blender и возвращает данные.

Путь команды и ответа

  1. Выпишете запрос словами
  2. КлиентClaude Desktop или Cursor выбирает инструмент
  3. MCP-серверзапускается через uvx на вашем ПК
  4. Аддон в Blenderслушает порт 9876
  5. Сценаобъекты, материалы, свет; обратно идут данные сцены и скриншот вьюпорта

Практический вывод: поломка почти всегда в одном из трёх звеньев. Либо клиент не нашёл сервер (ошибка в конфиге или нет 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. Порядок такой:

  1. В PowerShell выполните uvx mcp-for-blender install-addon. Команда копирует файл аддона в папку аддонов Blender под именем blender_mcp.py.
  2. Запустите Blender и откройте Edit → Preferences → Add-ons. В поиске введите «MCP for Blender» и поставьте галочку.
  3. В 3D-вьюпорте нажмите N, чтобы открыть боковую панель, и найдите вкладку аддона. В ней запускается сервер соединения; по умолчанию он слушает порт 9876.
  4. Не закрывайте Blender: пока он открыт и сервер включён, клиент сможет подключаться.

Признак успеха: в панели аддона виден статус запущенного сервера, а порт 9876 не заблокирован другой программой. Если порт занят, его меняют переменной окружения BLENDER_PORT, и тогда то же число должно стоять в настройках сервера.

Подключение Claude Desktop: файл настроек и проверка инструментов

Шаги установки и проверки

  1. Поставьте uvофициальным установщиком, затем проверьте uv --version
  2. Установите аддонuvx mcp-for-blender install-addon, включите его в Preferences
  3. Запустите серверна боковой панели N в Blender, порт 9876
  4. Допишите настройки клиентаблок mcpServers с командой uvx
  5. Проверьте инструментыперезапустите клиент и откройте список коннекторов
  6. Отправьте первый запроснапример, попросите описать текущую сцену

В 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. Не пробрасывайте порт наружу и не включайте доступ из сети.

  1. Работайте на копии. Сохраните Save As с суффиксом, например scene_mcp_test.blend, и ведите эксперименты в нём.
  2. Сохраняйтесь между запросами. Включите автосохранение и сохраняйте версию вручную перед сложной просьбой.
  3. Просите описать план до выполнения. «Сначала напиши, что собираешься сделать, и жди подтверждения» для рискованных операций: удаления, массового переименования, работы с файлами.
  4. Подтверждайте вызовы в клиенте. Не включайте автоматическое разрешение для сервера, если не уверены.
  5. Безопасный режим. В списке переменных окружения README есть BLENDER_MCP_SAFE_MODE: изучите, что он отключает в вашей версии, прежде чем полагаться на него.
  6. Телеметрия. По 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-промптах.

Реклама

Оставить комментарий

© 2026 web3D.pro · все права защищены тема web3D Pro · made with html