AI и автоматизация

MCP Revit Claude настройка: AI-агент в BIM-проектировании

2026-05-24 · 12 мин чтения · ЛЭНДПРОДЖЕКТ

# MCP Revit Claude настройка: как подключить AI-агента к BIM-модели

Настройка MCP Revit Claude — это способ дать большой языковой модели прямой доступ к BIM-модели: читать категории, элементы, параметры, запускать команды и менять геометрию через диалог. Model Context Protocol (MCP) — открытый стандарт от Anthropic, который превращает Revit в «инструмент» для Claude: AI-агент не угадывает, что лежит в файле, а видит реальные данные и работает с ними. В архитектурном бюро ЛЭНДПРОДЖЕКТ мы используем такую связку каждый день: от автоматической маркировки материалов до проверки коллизий на ЖК и общественных зданиях, проектируемых на полном цикле от ЭП до авторского надзора.

В этой статье — пошаговая настройка MCP-сервера для Revit, требования к окружению, типовые ошибки и реальные сценарии, которые экономят бюро десятки часов в неделю.

Что такое MCP и зачем он Revit

MCP (Model Context Protocol) — это унифицированный протокол, по которому AI-агент (Claude, ChatGPT, любой совместимый клиент) общается с внешним инструментом. Сервер выставляет набор «функций»: list_levels, get_walls, change_parameter, run_dynamo_script — а агент их вызывает.

До MCP интеграция AI с Revit делалась тремя способами:

MCP меняет схему. Архитектор пишет в чат: «Покажи все стены толщиной 250 мм с материалом «Кирпич облицовочный» на 7 этаже и выгрузи их в Excel». Агент через MCP-сервер обращается к Revit, фильтрует элементы, отдаёт данные в обработку и возвращает таблицу. Никакого кода — естественный язык.

Архитектура связки Revit ↔ MCP-сервер ↔ Claude

Базовая схема MCP Revit Claude настройка выглядит так:

Между сервером и плагином чаще всего используется JSON-RPC через socket или именованный pipe. Логика такая: Claude → MCP-сервер → JSON-команда в Revit add-in → Revit API → результат обратно по той же цепочке.

В нашем бюро ЛЭНДПРОДЖЕКТ используется аналогичный bridge: AutoCAD Bridge и Revit Bridge — плагины .NET, которые слушают command.json и пишут result.json. MCP — следующий шаг той же идеи, но стандартизированный и совместимый с любым AI-клиентом.

Требования к окружению

Перед началом настройки убедитесь, что у вас есть:

Опционально, но крайне полезно:

Шаг 1. Установка MCP-сервера для Revit

На GitHub существует несколько открытых реализаций revit-mcp-server. Установка через pip:

Минимальный скелет сервера регистрирует инструменты: list_categories, get_elements_by_category, get_parameter, set_parameter, run_command. Каждый инструмент — это функция Python с типизированными аргументами, которая отправляет JSON-запрос в Revit add-in через TCP-сокет (обычно localhost:7777) и ждёт ответ.

Сервер запускается командой `python server.py` и слушает stdio — Claude Desktop связывается с ним именно через стандартный ввод/вывод.

Шаг 2. Установка Revit add-in (Bridge)

Add-in — это .NET DLL, которая регистрируется в Revit при старте. Ключевые компоненты:

Файл `.addin` (XML-манифест) кладётся в `%APPDATA%\Autodesk\Revit\Addins\2024\RevitMCPBridge.addin`. Он указывает путь к DLL и тип приложения. После следующего запуска Revit плагин загрузится автоматически.

Важный нюанс: Revit запрещает менять документ из чужого потока. Поэтому любая команда от MCP-сервера ставится в очередь, а IExternalEventHandler в основном UI-потоке Revit её выполняет и возвращает результат. Без этой схемы Revit упадёт с InvalidOperationException.

Шаг 3. Конфигурация Claude Desktop

Откройте файл `%APPDATA%\Claude\claude_desktop_config.json` и добавьте секцию mcpServers:

После сохранения перезапустите Claude Desktop. В нижней панели появится индикатор подключённых MCP-серверов. Если revit-сервер запустился, иконка молнии будет активной — Claude теперь знает про инструменты Revit.

Для Claude Code (CLI-версия) настройка аналогичная, но через `~/.claude/mcp.json` или флаг `--mcp-config`.

Шаг 4. Первая команда из чата

Откройте Revit с любым проектом, запустите Claude, напишите: «Сколько уровней в активном документе и как они называются?»

Claude вызовет инструмент list_levels, сервер передаст запрос в Revit add-in, плагин через FilteredElementCollector соберёт все Level, вернёт JSON. Claude перепакует ответ в человеческий текст: «В вашем проекте 12 уровней: -3.500, ±0.000, +3.300, +6.600...»

Если ответ пришёл — связка работает. Дальше можно усложнять: «Создай таблицу всех окон с их размерами и материалами рамы», «Найди все стены без типа», «Покажи коллизии перекрытий и труб ОВ на 5 этаже».

Типовые ошибки настройки и как их обойти

Revit add-in не загружается

Проверьте файл `.addin`: путь к DLL должен быть абсолютный, GUID уникальный, версия .NET совпадает с целевой версией Revit. В Revit при старте появляется диалог Security — выберите Always Load.

MCP-сервер не виден в Claude

Перезапустите Claude Desktop полностью (не закрытие окна, а выход из трея). На Windows откройте логи `%APPDATA%\Claude\logs\mcp*.log` — там видны ошибки парсинга конфига.

Команды зависают

Скорее всего, add-in пытается работать с Revit API не из UI-потока. Перепишите через IExternalEvent — это единственный legal-способ.

CORS / firewall блокирует localhost

Если MCP-сервер и Revit обмениваются по TCP, Windows Defender может закрыть порт. Добавьте правило входящего подключения для нужного порта (7777, 7891 — какой выбрали).

Кириллица в путях ломает JSON

Используйте UTF-8 везде: при чтении файлов в Python — `encoding='utf-8'`, в C# — `Encoding.UTF8`. Без этого пути типа `Документы\Проекты\ЖК` приходят как мусор.

Реальные сценарии MCP Revit Claude в архитектурном бюро

В нашей практике AI-агент через MCP закрывает рутину, на которую раньше уходили часы:

Маркировка материалов и слоёв пирога

ЛЭНДПРОДЖЕКТ проектирует жилые комплексы и общественные здания с десятками типов стен. Раньше синхронизация маркировки во флажках пирога конструкции с ведомостью материалов занимала по 2–3 часа на проект и часто давала ошибки. Сейчас архитектор пишет: «Проверь маркировку всех несущих стен и обнови флажки по ведомости» — MCP-сервер вызывает pyRevit-скрипт, который проходит все элементы и приводит их к консистентному виду за минуту.

Генерация планов и подсчёт ТЭП

Для коммерческих предложений на коттеджные посёлки и ИЖС нужно быстро прикинуть площади и состав работ. AI-агент через MCP читает Revit-модель типового дома, считает площади по уровням, выгружает ТЭП в формат, который сразу подхватывает наш скрипт расчёта стоимости проектирования. От запроса до КП — 10 минут вместо полудня.

Проверка коллизий

Через MCP агент может запустить связку Revit → Navisworks: экспорт NWC, открытие в Navisworks Manage, прогон Clash Detective, выгрузка отчёта. Архитектор формулирует: «Сделай проверку коллизий АР/КР/ВК на этой модели» — и получает HTML-отчёт через 30–40 минут. На проектах реконструкции, где десятки инженерных систем сходятся в плотном объёме, это критично.

Автоматическая генерация документации

На стадии РД, когда нужно подготовить альбомы АР/КР с сотнями листов, AI-агент по запросу проставляет виды, фильтры, легенды, корректирует штампы. MCP-сервер вызывает Dynamo-скрипты или прямой Revit API. Архитектор остаётся контролёром качества, а не наборщиком.

Поддержка авторского надзора

Во время авторского надзора часто всплывают замечания: «изменили проектное решение по узлу примыкания». Через MCP агент быстро находит все экземпляры узла в модели, формирует список листов, где они показаны, и готовит лист изменений. Раньше это занимало день, сейчас — час.

MCP и наш стек: Revit, AutoCAD, Dynamo, AI

В ЛЭНДПРОДЖЕКТ AI-инструменты встроены в полный цикл проектирования. MCP — это лишь один уровень. Под ним:

MCP связывает их в единую среду: один Claude видит и BIM-модель, и базу проектов бюро, и архив коммерческих предложений. На выходе — связное проектирование, где AI не угадывает по описанию, а реально открывает модель и работает с ней.

Безопасность и ограничения

Несколько важных оговорок при настройке MCP Revit Claude:

Что дальше: куда движется AI в BIM

Связка MCP Revit Claude — это начало. Следующие шаги, которые мы тестируем в бюро:

Закажите проект в ЛЭНДПРОДЖЕКТ

Если вы хотите внедрить AI и BIM в своё бюро или ищете подрядчика, который уже работает на этом стеке — обратитесь в ЛЭНДПРОДЖЕКТ. Мы проектируем полный цикл: ИЖС и коттеджные посёлки, жилые комплексы, общественные здания, реконструкцию, интерьеры. От эскизного проекта до авторского надзора.

20+ лет команды, BIM (Revit, AutoCAD, Dynamo), собственная инфраструктура AI-агентов на Claude, выпуск проектной и рабочей документации в срок.

Сайт: landproject.net

Расскажите задачу — посчитаем стоимость и сроки за 1–2 рабочих дня.

Обсудить ваш проект

Расскажите о задаче — предложим решение за 24 часа

Оставить заявку