Содержание
Как подключить Blender к Claude через MCP
Черновик готовит редакция с помощью ИИ. За стандарт издания отвечает главный редактор — Валерий Курземнек.
Материал редакции Зерокодера. Счёт по выдаче снят собственным прогоном 13 октября 2026 года; цитаты источников приведены дословно. Обновлено: октябрь 2026.
Подключить Blender к Claude через MCP можно за пять шагов: поставить пакетный менеджер uv, установить аддон MCP for Blender, запустить сервер внутри Blender, зарегистрировать его в клиенте Claude и проверить соединение. Ниже — порядок действий, требования, учебный пример и разбор типичных сбоев. Скачали подборку результатов веб-поиска по запросу «Как подключить Blender к Claude через MCP»: текст отдали 8 из 10. Мы скачали подборку результатов веб-поиска по запросу «Как подключить Blender к Claude через MCP»: текст отдали 8 из 10.
Что даёт связка и где проходят её границы
MCP for Blender — сторонняя интеграция, которую ведёт сообщество. В README проекта на GitHub указано: «This is a third-party integration and not made by Blender». Это значит, что аддон развивается отдельно от Blender Foundation, а поддержку ведёт мейнтейнер Siddharth Ahuja. Практический вывод: обновления Blender и обновления аддона идут разными графиками, и версии стоит сверять перед установкой.
Связка работает так: внутри Blender поднимается локальный сервер, а клиент Claude подключается к нему как к MCP-серверу. Через этот канал Claude получает доступ к инструментам, которые читают и меняют сцену. В README перечислены, среди прочего, get_scene_info — компактная сводка сцены, по строке на объект с выбранными полями (размещение, материалы, топология, веса), и get_addon_status — версия Blender, версия аддона и список включённых библиотек и генераторов.
Границы определяются тем, что делает аддон. Он даёт Claude инструменты для работы со сценой. Клиент и требования стоит подтверждать первичными документами проекта: README на GitHub и документация Anthropic по MCP. В обзоре на usingclaude.com описаны два способа подключения Blender к Claude, и выбор между ними зависит от того, какой клиент вы используете.
Смежная тема — подключение MCP-инструментов к другим моделям; общий порядок регистрации сервера в клиенте разобран в статье Как подключить MCP-инструменты к DeepSeek.
Условия доступа и требования
Требования собраны в README проекта: Blender 3.0 или новее, Python 3.10 или новее, пакетный менеджер uv. Это нижняя граница, ниже которой аддон не заработает. Проверить свою версию Blender можно в меню About, версию Python — командой в терминале.
Отдельно стоит вопрос имени пакета. В README сказано: «New installs should use mcp-for-blender». Новые установки идут через этот пакет, и команды ниже приведены для него. Если вы встречали в старых инструкциях другое имя, ориентируйтесь на текущий README — он первичен.
| Что нужно | Требование | Где проверить |
|---|---|---|
| Blender | 3.0 или новее | Меню About в приложении |
| Python | 3.10 или новее | Команда в терминале |
| Пакетный менеджер | uv | Установка по инструкции проекта |
| Клиент Claude | Claude Code, Claude Desktop или другой MCP-клиент | Документация Anthropic по MCP |
Источник актуальных требований — README репозитория mcp-for-blender на GitHub. Документация Anthropic по MCP объясняет, как клиент находит серверы и как устроена регистрация. Перед установкой стоит открыть оба документа: первый задаёт версии, второй — формат подключения.
Доступность сервиса из России в прочитанных источниках не описана. Если этот пункт для вас важен, проверяйте его отдельно по документации Anthropic и по условиям вашего клиента.
Порядок действий: от установки до соединения
Порядок из README проекта выглядит так. Сначала ставится пакетный менеджер uv. Затем аддон устанавливается командой uvx mcp-for-blender install-addon. После этого в Blender нужно открыть Edit → Preferences → Add-ons и включить Interface: MCP for Blender. Аддон запускает свой сервер при открытии Blender. Проверить это можно так: нажать N в 3D-вьюпорте, открыть вкладку MCP for Blender и нажать Start MCP Server, если сервер ещё не запущен.
Дальше сервер регистрируется в клиенте Claude. Для Claude Code команда из README: claude mcp add blender uvx mcp-for-blender. В документации Anthropic по MCP отмечено, что для stdio-серверов двойное тире -- отделяет собственные опции Claude — такие как --transport, --env и --scope — от команды и аргументов, которые запускают сервер. Это важно, если вы добавляете свои параметры.
Проверка соединения делается двумя способами. Команда claude mcp list показывает список зарегистрированных серверов. Внутри Claude Code статус сервера смотрят командой /mcp. Если сервер виден в списке и отмечен как работающий, можно переходить к первому запросу.
| Шаг | Действие | Команда или место |
|---|---|---|
| 1 | Установить uv | По инструкции проекта |
| 2 | Установить аддон | uvx mcp-for-blender install-addon |
| 3 | Включить аддон | Edit → Preferences → Add-ons → Interface: MCP for Blender |
| 4 | Запустить сервер | N → вкладка MCP for Blender → Start MCP Server |
| 5 | Зарегистрировать в Claude Code | claude mcp add blender uvx mcp-for-blender |
| 6 | Проверить | claude mcp list или /mcp |
Для Claude Desktop шаги те же по смыслу, но регистрация идёт через настройки приложения. В обзоре на usingclaude.com разобраны оба пути: через Claude Code и через Claude Desktop. Выбор зависит от того, где вам удобнее работать с запросами.
Учебный пример и критерии проверки
Возьмём маленькую сцену и проверим связку на ней. Это наше предлагаемое упражнение. Цель — убедиться, что Claude видит сцену и может её менять.
Порядок такой. Откройте Blender, создайте новый файл и оставьте в нём куб по умолчанию. Запустите сервер и убедитесь, что он работает. Затем попросите Claude показать сведения о сцене — это задействует инструмент get_scene_info. Дальше попросите добавить второй объект рядом с первым и назвать его понятным именем. После этого попросите вывести список объектов ещё раз и сравните два ответа.
Критерии самостоятельной проверки:
- Claude возвращает сводку сцены, в которой перечислены объекты с выбранными полями.
- После запроса на добавление объекта в сцене появляется новый объект.
- Повторный запрос
get_scene_infoпоказывает изменившийся состав сцены. - Инструмент
get_addon_statusвозвращает версию Blender, версию аддона и список включённых библиотек.
Если все четыре пункта выполняются, соединение работает. Если сводка приходит, а изменения не появляются, проблема в правах на изменение сцены или в том, что запрос не дошёл до нужного инструмента.
В академии Claude приведены примеры использования коннектора: очистка имён в сцене, разбор сложной сцены, которую вы не собирали, поиск объекта или материала, который что-то использует, и поиск самых тяжёлых объектов. Эти задачи хорошо ложатся на учебный пример и дают понятный результат для проверки.
Смежные варианты подключения
Способов подключения несколько, и выбор зависит от клиента. В обзоре на usingclaude.com описаны два пути: через Claude Code и через Claude Desktop. В README проекта отдельно разобраны настройки для Claude for Desktop и для Cursor. На странице каталога MCP-серверов перечислены и другие клиенты: Codex, Visual Studio Code, OpenCode, Antigravity.
| Вариант | Кому подходит | Особенность |
|---|---|---|
| Claude Code | Работа в терминале | Регистрация командой claude mcp add |
| Claude Desktop | Работа в приложении | Настройка через интерфейс приложения |
| Cursor | Работа в редакторе кода | Отдельный раздел настройки в README |
| Другие клиенты | Свои сценарии | Список на странице каталога MCP |
Отдельно стоит установка без uv. В README есть раздел про установку без uv и раздел про закрепление версии Python. Эти варианты пригодятся, если пакетный менеджер недоступен или нужна фиксированная версия интерпретатора. Там же описаны переменные окружения — они задают параметры запуска сервера.
Ещё один вариант — запуск через Docker. Он упомянут на странице каталога MCP-серверов. Этот путь выбирают, когда нужна изоляция окружения. Для первого знакомства проще начать с обычной установки через uvx.
Если вы работаете с другой моделью, порядок регистрации сервера похож; пример разобран в статье Как подключить DeepSeek к Aider.
Типичные проблемы и диагностика
Первая частая проблема — клиент не находит uvx. В README проекта есть отдельный раздел «Make your client find uvx». Решение — указать клиенту путь к пакетному менеджеру. Проверить можно командой claude mcp list: если сервер не появляется в списке, дело в пути.
Вторая проблема — сервер не запущен. Аддон стартует сервер при открытии Blender, но если этого не произошло, нужно нажать N в 3D-вьюпорте, открыть вкладку MCP for Blender и нажать Start MCP Server. Статус внутри Claude Code проверяется командой /mcp.
Третья проблема — несовпадение версий. Требования README: Blender 3.0 или новее и Python 3.10 или новее. Если версия ниже, аддон не заработает. Инструмент get_addon_status возвращает версию Blender и версию аддона — это самый быстрый способ сверить окружение.
Четвёртая проблема — путаница с именем пакета. README указывает: «New installs should use mcp-for-blender». Если команда регистрации использует старое имя, сервер может не запуститься.
Пятая проблема — ошибки в команде регистрации. Документация Anthropic по MCP напоминает, что двойное тире -- отделяет опции Claude от команды запуска сервера. Если вы добавляете --env или --scope, порядок аргументов важен.
| Симптом | Вероятная причина | Что проверить |
|---|---|---|
| Сервер не в списке | Клиент не находит uvx | Раздел «Make your client find uvx» в README |
| Сервер в списке, но не работает | Сервер не запущен в Blender | N → MCP for Blender → Start MCP Server |
| Аддон не включается | Версия Blender или Python ниже требуемой | About в Blender, версия Python в терминале |
| Команда регистрации не срабатывает | Неверное имя пакета или порядок аргументов | README и документация Anthropic по MCP |
Диагностику удобно вести по порядку: сначала список серверов, затем статус, затем версии. Это отсекает большинство сбоев на раннем этапе.
Готовый промпт для первой задачи
Когда соединение установлено, читателю нужен запрос, с которого можно начать. Ниже — промпт для учебной сцены: он просит Claude показать состав сцены и добавить один объект. Скопируйте его и вставьте в клиент без правок.
Покажи сведения о текущей сцене в Blender: перечисли объекты и их ключевые поля. Затем добавь рядом с первым объектом новый объект и дай ему понятное имя. После этого выведи обновлённый список объектов, чтобы я мог сравнить состав сцены до и после.
В квадратных скобках можно подставить свои значения: [ваша сцена], [ваш объект], [ваше имя объекта]. Формулировку задачи меняйте под себя, структуру запроса оставляйте.
Вариации той же задачи:
Разбери сцену, которую я не собирал: перечисли объекты, их материалы и связи между ними. Отметь, что выглядит нестандартно.
Найди в сцене объект или материал, который используется в нескольких местах, и покажи, где именно.
Определи самые тяжёлые объекты сцены по числу полигонов и предложи, что можно упростить.
Проверь имена объектов в сцене и предложи единый понятный формат именования.
Выведи статус аддона: версию Blender, версию аддона и список включённых библиотек и генераторов.
Эти вариации опираются на примеры, приведённые в академии Claude: очистка имён, разбор чужой сцены, поиск использования объекта или материала, поиск тяжёлых объектов. Они дают понятный результат и хорошо подходят для проверки соединения.
Частые вопросы
Как подключить Blender к Claude через MCP?
Установите uv, затем аддон командой uvx mcp-for-blender install-addon. В Blender откройте Edit → Preferences → Add-ons и включите Interface: MCP for Blender. Зарегистрируйте сервер в клиенте Claude и проверьте соединение командой claude mcp list или /mcp.
Какие версии Blender и Python нужны?
В README проекта указаны Blender 3.0 или новее и Python 3.10 или новее. Дополнительно нужен пакетный менеджер uv. Версию Blender смотрят в меню About, версию Python — в терминале.
Почему сервер не появляется в списке Claude?
Чаще всего клиент не находит uvx. В README есть раздел «Make your client find uvx» — он объясняет, как указать клиенту путь к пакетному менеджеру. Проверьте также, что команда регистрации использует имя mcp-for-blender.
Как проверить, что соединение работает?
Запустите сервер в Blender и попросите Claude показать сведения о сцене. Инструмент get_scene_info вернёт сводку с объектами. Инструмент get_addon_status покажет версию Blender, версию аддона и список включённых библиотек.
Можно ли подключить Blender к Claude Desktop?
Да, в обзоре на usingclaude.com описаны оба пути: через Claude Code и через Claude Desktop. В README проекта есть отдельный раздел настройки для Claude for Desktop. Выбор зависит от того, где вам удобнее работать с запросами.
Если вы работаете с Claude Code и хотите управлять фоновыми задачами, пригодится статья Как остановить Claude Code: прервать ответ и фоновые задачи.
