Как настроить перенос Revit Cloud Worksharing с помощью APS и MCP?

Что вы узнаете из этого руководства?

В руководстве объясняется, как организовать процесс переноса Revit Cloud Worksharing (RCW) с помощью сервера Model Context Protocol (MCP), взаимодействующего с APS. Пример Autodesk показывает, как MCP-клиент преобразует запрос на естественном языке в вызовы инструментов, сервер управляет операциями APS, а автоматизация Revit переносит модель. Описанные шаги помогут разобраться в архитектуре примера, но это не готовая к эксплуатации инструкция по настройке для любого проекта.

Важно различать роли компонентов: ИИ-клиент координирует принятие решения о переносе и вызовы инструментов, а фактическая работа с моделью выполняется средствами Design Automation for Revit с использованием Revit API. MCP-сервер управляет операциями и авторизацией между этими компонентами.

Требования и доступ

В примере Autodesk сервер MCP на Node.js расширен функциями APS. MCP-сервер должен подключаться к совместимому клиенту и иметь доступ к данным APS, где находятся исходная модель и целевой проект. Для автоматизации Revit также должны быть настроены подходящий для переноса движок Revit и автоматизированные операции. В исходных материалах не указаны конкретная версия Node.js или стоимость, поэтому предполагать их здесь не следует.

Выбор способа аутентификации зависит от места запуска сервера и того, чьи данные используются. Если сервер запускается локальным настольным клиентом через STDIO, отдельная аутентификация на уровне клиента и сервера может не понадобиться. Для выполнения операций в APS от имени пользователя можно использовать 3-legged OAuth (3LO), а в локальных процессах и других случаях, когда нельзя безопасно хранить секрет, — PKCE. Для задач, которым нужны общие для сервера учетные данные приложения, можно рассмотреть 2-legged OAuth (2LO) или авторизованную учетную запись Secure Service Account (SSA). Учтите, что не каждый API принимает все типы учетных данных.

Планирование переноса шаг за шагом

1. Определите сценарий использования и клиент. Сначала решите, будет ли работа выполняться с доступом конкретного пользователя или от имени общей учетной записи автоматизации. Затем выберите, будет ли MCP-сервер работать как локальный процесс или предоставляться удаленно через HTTP. В руководстве Autodesk для локального использования рассматривается STDIO, а для удаленных сценариев с несколькими пользователями — Streamable HTTP. При открытии сервера по HTTP аутентификацию между клиентом и сервером нужно проектировать отдельно от аутентификации APS.

2. Выберите способ аутентификации APS с подходящими правами. Для доступа к личным данным пользователя можно использовать 3LO или PKCE с входом пользователя. Для ресурсов самого приложения подходит 2LO, но его может быть недостаточно для вызовов API, которым нужен пользовательский контекст. Если автоматизации требуется доступ к данным проекта без постоянного входа пользователя, можно рассмотреть SSA, авторизованную для нужных hub и проектов. Не путайте токен доступа между сервером и клиентом с токеном APS: они служат разным целям и относятся к разным уровням.

3. Разделите задачи инструментов MCP. В примере Autodesk сервер может находить проекты и папки с помощью существующих инструментов управления данными; поле extensionType в содержимом папки помогает определять модели RCW. Для переноса добавлен инструмент migrate-rcw-model, который принимает исходную модель, целевой проект и папку, а также целевую версию Revit. На основе этих данных приложение подготавливает и отправляет задание APS Automation. Если отделить поиск от изменяющего данные действия переноса, клиенту будет понятнее, какую операцию он запускает.

4. Проверьте предварительные условия и запросите подтверждение пользователя. В примере предусмотрен check-migrator-setup для проверки настроенных движков Revit и автоматизированных операций. По словам Autodesk, инструкции рабочего процесса могут направлять ассистента на проверку предварительных условий и запрос подтверждения перед переносом. Не отправляйте задание, пока не определены целевой проект, папка и версия Revit; сверьте эти параметры с запросом пользователя.

5. Обеспечьте возможность отслеживать асинхронное задание. Перенос может занять несколько минут, поэтому возврат идентификатора задания не означает, что работа завершена. В примере get-migration-status возвращает статус задания и сведения об ошибках, а cancel-migration запрашивает отмену ожидающих заданий. В совместимых клиентах с поддержкой MCP Apps панель статуса может отображать активные задания, завершенные переносы, сведения об ошибках и элементы управления отменой. Этот уровень следует рассматривать отдельно от инструмента, который запускает перенос.

6. Проведите ограниченное и безопасное тестирование рабочего процесса. Для начала убедитесь, что список доступных моделей отображается, а проверка конфигурации завершается успешно. Затем, получив подтверждение пользователя, отправьте одну модель в целевой проект и проверьте, правильно ли возвращаются идентификатор задания, статус и сведения об ошибках. Не передавайте токены APS клиенту и не перенаправляйте токен клиента напрямую в APS. Для удаленного MCP-сервера отдельно определите, кто может получить к нему доступ: это не тот же уровень, который устанавливает, с какой учетной записью выполняются операции APS.

Что это значит для рабочих процессов архитектуры и визуализации

Архитектурные бюро, работающие с несколькими проектами Revit или моделями RCW, могут использовать возможность запускать перенос запросом на естественном языке и отслеживать ход работы в одном клиенте. Для разработчиков инструменты MCP — пример подключения существующей автоматизации APS к разным совместимым клиентам. Однако этот подход сам по себе не решает задачи BIM-координации и анализа зависимостей модели.

В источниках нет сведений о стоимости оборудования или лицензий. Поэтому перед принятием решения отдельно проверьте доступ организации к APS, выбранную конфигурацию автоматизации Revit и соответствие выбранного способа аутентификации разрешениям проекта. В частности, команды, работающие со связанными моделями, не должны считать, что связанные модели переносятся вместе с основной.

Частые ошибки и дальнейшие шаги

Главное ограничение примера — работа с отдельными моделями RCW: связи между связанными моделями автоматически не переносятся, а ссылки в целевом проекте не восстанавливаются. В проектах со связанными моделями необходимы отдельный анализ зависимостей, предварительная проверка и координация; в источниках эти возможности рассматриваются как потенциальные дополнения в будущем.

Еще одна распространенная ошибка — считать аутентификацию между MCP-клиентом и сервером тем же самым, что и доступ к APS. Сначала определите, какая сторона и перед кем проходит проверку на каждом уровне. Затем оцените инструменты, разрешения и подтверждение пользователя с учетом этого разделения. При переходе к реализации в качестве отправной точки используйте примерный репозиторий Autodesk и примеры аутентификации APS MCP; требования безопасности и работы со связанными моделями для производственной среды необходимо обеспечить отдельно.

Источник и лицензия

Материал подготовлен на основе руководств Autodesk Platform Services «Bringing Revit Cloud Worksharing Migration to AI Assistants with APS and MCP», «Building Custom MCP Servers with Autodesk Platform Services» и «Authentication Patterns for APS MCP Servers». В предоставленных записях источников статус лицензии указан как serbest («свободная»), однако конкретная лицензия с открытым исходным кодом не названа. Поэтому материал не обозначен как опубликованный, например, по лицензии CC BY.