BIMO MCP позволяет подключить совместимого AI-агента к Autodesk Revit через локальный BIMO MCP Host. Агент может обнаруживать подключённые сессии Revit, получать контекст модели и выполнять доступные BIMO-инструменты. Для операций, требующих произвольного Python-кода, BIMO использует отдельное подтверждение пользователя.
Команда управления находится в BIMO > Interact > AI Agent Access.
Текущий AI Agent Access доступен в Revit 2024-2027 и не требует открытого документа для запуска диалога настройки.
Быстрый старт с Codex
В BIMO есть встроенная настройка подключения Codex через локальный STDIO connector. Рекомендуемый порядок:
Запустите Revit с установленным BIMO Toolbar.
Откройте BIMO > Interact > AI Agent Access.
Нажмите Enable AI Agent Access и подтвердите включение доступа.
Откройте Manage MCP client connections.
Выберите Configure Codex.
Полностью перезапустите Codex.
В новом диалоге с агентом попросите проверить доступные сессии Revit.
После настройки Codex использует установленный BIMO connector. Bearer credential не нужно вручную сохранять в конфигурации Codex.
Если Revit закрыт, подключение MCP может оставаться доступным, но список Revit-сессий будет пустым.
Что показывает AI Agent Access
Окно состояния позволяет проверить:
доступен ли локальный BIMO MCP Host;
включён ли AI Agent Access для Revit;
подключена ли текущая сессия Revit;
локальный MCP endpoint;
включён ли запуск Host при входе в Windows;
разрешено ли локально выполнение unsafe Python;
проходит ли текущая лицензия проверку, необходимую для unsafe Python.
Секретный MCP credential в окне состояния не отображается.
Управление подключением
Enable AI Agent Access
При первом включении BIMO запрашивает подтверждение постоянного поведения. После подтверждения BIMO может запускать локальный Host при необходимости и регистрировать текущую и будущие сессии Revit для AI-агентов.
Disable AI Agent Access отключает bridge текущей сессии и не подключает новые сессии Revit. Эта настройка не управляет отдельным автозапуском Host при входе в Windows.
Manage MCP client connections
Доступны следующие действия:
Configure Codex - добавить или обновить BIMO-owned подключение Codex;
Remove Codex integration - удалить только подключение, которым управляет BIMO;
Copy generic MCP connection configuration - получить URL и Authorization header для другого MCP-клиента.
Скопированную generic-конфигурацию нужно считать секретом. Не публикуйте её в issue, логах, репозитории или чате и очистите буфер обмена после настройки клиента.
Manage Bimo.McpHost
Здесь можно управлять локальным фоновым процессом:
включить или отключить запуск BIMO MCP Host при входе в Windows;
выполнить штатный restart Host.
Автозапуск Host при входе в Windows является отдельной настройкой. Для обычного сценария с Revit он не обязателен.
Rotate MCP client credential
Ротация делает старые MCP client credentials недействительными и создаёт новые. После ротации перезапустите подключённый AI-клиент. Для Codex обычно достаточно полностью перезапустить приложение.
Как работает BIMO MCP
BIMO использует локальную схему:
Host работает в пользовательской Windows-сессии и связывает MCP-клиенты с запущенными экземплярами Revit. Выполнение Revit API остаётся внутри BIMO add-in и проходит через Revit-safe execution path.
По умолчанию MCP Host использует loopback-интерфейс компьютера, а не открытый сетевой адрес.
Что можно делать через агента
Набор возможностей зависит от текущей версии BIMO и доступных MCP tools. Типичный сценарий включает:
найти запущенные сессии Revit;
выбрать нужный проект;
получить контекст активного документа и вида;
проанализировать модель;
выполнить доступный BIMO tool или подготовленный Python-сценарий;
проверить результат после выполнения.
Для потенциально изменяющих модель действий рекомендуется сначала попросить агента показать, что именно он собирается изменить.
Выполнение Python и подтверждения
Произвольный Python относится к unsafe-возможностям. Для его выполнения одновременно требуются:
включённая настройка Allow unsafe Agent Python execution;
действующая платная лицензия BIMO по текущей проверке доступа;
подтверждение BIMO для конкретного запроса.
Подтверждение в самом AI-клиенте не заменяет подтверждение BIMO. Если код, документ или другие значимые параметры изменились, BIMO может потребовать новое подтверждение.
Подключение другого MCP-клиента
Если клиент поддерживает совместимое MCP-подключение, в Manage MCP client connections выберите Copy generic MCP connection configuration.
BIMO скопирует локальный endpoint и Authorization header. Вставьте их только в конфигурацию нужного клиента. Совместимость конкретного клиента может зависеть от его реализации MCP и доступа к Windows localhost.
Встроенный Configure Codex предпочтительнее ручной generic-настройки Codex, потому что не требует сохранять bearer credential в config.toml.
Если Codex перестал подключаться
Попробуйте по порядку:
Убедитесь, что BIMO установлен и AI Agent Access включён.
Откройте окно AI Agent Access и проверьте состояние Host.
Выполните Manage Bimo.McpHost > Restart Bimo.McpHost.
Выполните Manage MCP client connections > Configure Codex ещё раз.
Полностью закройте и заново запустите Codex.
Если вы вручную изменяли BIMO-блок в %USERPROFILE%\.codex\config.toml, BIMO может перестать считать его своей конфигурацией и не будет автоматически перезаписывать его. В таком случае удалите или отключите только [mcp_servers.bimo], затем снова используйте Configure Codex.
Перед repair, upgrade или uninstall BIMO рекомендуется полностью закрыть Codex.
Важные ограничения
Текущий AI Agent Access рассчитан на Revit 2024-2027.
Возможности конкретного AI-клиента зависят от его MCP-реализации.
BIMO MCP не отменяет обычные правила безопасности Revit-проекта и не делает произвольные изменения модели автоматически безопасными.
Для важных изменений проверяйте предложенный агентом план действий и итоговое состояние модели.