Wie richtet man einen Revit-Cloud-Worksharing-Migrationsablauf mit APS und MCP ein?

Was erfahren Sie in diesem Leitfaden?

Dieser Leitfaden erklärt, wie sich ein Migrationsablauf für Revit Cloud Worksharing (RCW) mit einem Model-Context-Protocol-Server (MCP) planen lässt, der mit APS kommuniziert. Das Beispiel von Autodesk zeigt, wie ein MCP-Client eine natürlichsprachliche Anfrage in Tool-Aufrufe umwandelt, der Server die APS-Vorgänge orchestriert und die Revit-Automatisierung das Modell migriert. Die folgenden Schritte dienen dazu, die Beispielarchitektur zu verstehen; sie sind keine produktionsreife Installationsanleitung, die sich direkt auf jedes Projekt übertragen lässt.

Wichtig ist die Unterscheidung: Der KI-Client koordiniert die Migrationsentscheidung und die Tool-Aufrufe. Der eigentliche Vorgang am Modell wird auf der Seite von Design Automation for Revit ausgeführt, die die Revit API verwendet. Der MCP-Server verwaltet die Abläufe und die Autorisierung zwischen beiden Seiten.

Voraussetzungen und Zugriff

Das Beispiel von Autodesk erweitert einen Node.js-basierten MCP-Server um APS-Funktionen. Der MCP-Server muss mit einem kompatiblen Client verbunden sein und auf die APS-Daten zugreifen können, in denen sich das Quellmodell und das Zielprojekt befinden. Für die Revit-Automatisierung müssen außerdem eine geeignete Revit-Engine für die Migration und die Automatisierungsaktivitäten konfiguriert sein. Da die Quelle weder eine bestimmte Node.js-Version noch Kosten nennt, sollten hier keine Annahmen zu Versionen oder Preisen getroffen werden.

Welche Authentifizierungsmethode geeignet ist, hängt davon ab, wo der Server ausgeführt wird und wessen Daten verarbeitet werden. Bei einem Server, den ein lokaler Desktop-Client über STDIO startet, ist auf der Client-Server-Ebene möglicherweise keine separate Authentifizierung erforderlich. Für Vorgänge im Namen eines Benutzers auf APS können 3-legged OAuth (3LO) oder PKCE verwendet werden, etwa bei lokalen Prozessen, in denen sich ein Client Secret nicht sicher speichern lässt. Für Aufgaben, die eine serverweit gemeinsam genutzte Anwendungsidentität erfordern, kommen 2-legged OAuth (2LO) oder ein autorisiertes Secure Service Account (SSA) infrage. Dabei ist zu beachten, dass nicht jede API jede Art von Identität akzeptiert.

Den Migrationsablauf Schritt für Schritt planen

1. Anwendungsfall und Client festlegen. Klären Sie zunächst, ob mit den eigenen Zugriffsrechten des Benutzers oder mit einer gemeinsamen Automatisierungsidentität gearbeitet werden soll. Entscheiden Sie anschließend, ob der MCP-Server als lokaler Prozess oder remote über HTTP bereitgestellt wird. Der Leitfaden von Autodesk behandelt STDIO für die lokale Nutzung und Streamable HTTP für Remote-Szenarien mit mehreren Benutzern. Bei Servern, die über HTTP erreichbar sind, sollte die Authentifizierung zwischen Client und Server unabhängig von der APS-Authentifizierung konzipiert werden.

2. Die APS-Authentifizierungsmethode passend zu den Berechtigungen auswählen. Für den Zugriff auf persönliche Benutzerdaten kommen 3LO oder PKCE infrage, die eine Benutzeranmeldung voraussetzen. Für Ressourcen der Anwendung kann 2LO verwendet werden; für API-Aufrufe, die einen Benutzerkontext benötigen, reicht diese Methode jedoch möglicherweise nicht aus. Wenn die Automatisierung ohne fortlaufende Anmeldung eines Benutzers auf Projektdaten zugreifen muss, kann ein SSA in Betracht gezogen werden, das für die betreffenden Hubs und Projekte autorisiert ist. APS- und Client-Server-Zugriffstoken dürfen nicht verwechselt werden: Die Token beider Ebenen erfüllen unterschiedliche Zwecke.

3. Die Aufgaben der MCP-Tools voneinander trennen. Im Beispiel von Autodesk kann der Server mit vorhandenen Datenverwaltungs-Tools Projekte und Ordner ermitteln. Das Feld extensionType im Ordnerinhalt hilft dabei, RCW-Modelle zu erkennen. Das zusätzlich für die Migration vorgesehene Tool migrate-rcw-model erhält das Quellmodell, das Zielprojekt und den Zielordner sowie die Zielversion von Revit. Die Anwendung bereitet anhand dieser Angaben einen APS-Automation-Auftrag vor und übermittelt ihn. Wenn Ermittlung und datenverändernde Migration als getrennte Aufgaben konzipiert werden, ist für den Client klarer, welcher Vorgang gestartet wird.

4. Voraussetzungen prüfen lassen und die Zustimmung des Benutzers einholen. Im Beispielablauf dient check-migrator-setup dazu, konfigurierte Revit-Engines und Automatisierungsaktivitäten zu überprüfen. Autodesk weist darauf hin, dass Workflow-Anweisungen den Assistenten dazu anleiten können, Voraussetzungen zu prüfen und vor der Migration die Zustimmung des Benutzers einzuholen. Übermitteln Sie den Migrationsauftrag erst, wenn Zielprojekt, Ordner und Revit-Version feststehen, und bestätigen Sie diese Auswahl mit dem Benutzer.

5. Asynchrone Aufträge nachverfolgbar machen. Da die Migration mehrere Minuten dauern kann, bedeutet die Rückgabe einer Auftrags-ID nicht, dass der Auftrag abgeschlossen ist. Im Beispiel ruft get-migration-status den Auftragsstatus und Fehlerinformationen ab; cancel-migration fordert den Abbruch ausstehender Aufträge an. Bei kompatiblen Clients mit MCP Apps kann ein Statuspanel aktive Aufträge, abgeschlossene Migrationen, Fehlerdetails und Abbruchoptionen anzeigen. Diese Ebene sollte getrennt von dem Tool betrachtet werden, das den Migrationsauftrag startet.

6. Den Ablauf sicher und kontrolliert testen. Prüfen Sie zuerst, ob sich die verfügbaren Modelle auflisten lassen und die Konfigurationsprüfung funktioniert. Übermitteln Sie anschließend mit Zustimmung des Benutzers ein einzelnes Modell an das Zielprojekt und kontrollieren Sie, ob Auftrags-ID, Status und Fehlerinformationen wie erwartet zurückgegeben werden. APS-Token an den Client weiterzugeben oder ein Client-Token direkt an APS zu übermitteln, ist nicht der richtige Ansatz. Legen Sie für einen Remote-MCP-Server außerdem fest, wer auf den Server zugreifen darf. Diese Ebene ist von derjenigen getrennt, die bestimmt, mit welcher Identität APS aufgerufen wird.

Bedeutung für Arbeitsabläufe in Architektur und Visualisierung

Architekturbüros, die mit mehreren Revit-Projekten oder RCW-Modellen arbeiten, können davon profitieren, Migrationen in natürlicher Sprache anzustoßen und ihren Fortschritt im selben Client zu verfolgen. Für Entwickler bieten MCP-Tools ein Beispiel dafür, wie sich vorhandene APS-Automatisierung mit unterschiedlichen kompatiblen Clients verbinden lässt. BIM-Koordination und die Analyse von Modellabhängigkeiten werden dadurch jedoch nicht automatisch gelöst.

Die Quellen enthalten keine Angaben zu Hardware- oder Lizenzkosten. Vor einer Entscheidung sollte daher separat geprüft werden, ob der APS-Zugriff des Unternehmens, die ausgewählte Revit-Automatisierungskonfiguration und die Berechtigungen des gewählten Authentifizierungsverfahrens zu den Projektanforderungen passen. Insbesondere Teams, die mit verknüpften Modellen arbeiten, sollten nicht davon ausgehen, dass die zugehörigen Modelle zusammen mit dem migrierten Modell übertragen werden.

Häufige Fehler und nächste Schritte

Die wichtigste Einschränkung besteht darin, dass sich das Beispiel auf einzelne RCW-Modelle konzentriert: Beziehungen zu verknüpften Modellen werden nicht automatisch migriert und Verknüpfungen im Zielprojekt nicht repariert. Bei Projekten mit verknüpften Modellen sind daher eine separate Analyse der Abhängigkeiten, eine Vorabprüfung und Koordination erforderlich. Die Quelle beschreibt diese Funktionen als mögliche künftige Erweiterungen.

Ein weiterer häufiger Entwurfsfehler ist, die Authentifizierung zwischen MCP-Client und Server mit dem APS-Zugriff gleichzusetzen. Legen Sie zunächst für jede Ebene fest, welche Partei gegenüber wem authentifiziert wird. Prüfen Sie anschließend Tools, Berechtigungen und Zustimmung des Benutzers anhand dieser Unterscheidung. Für die technische Umsetzung können das Beispiel-Repository von Autodesk und die APS-MCP-Beispiele zur Authentifizierung als Ausgangspunkt dienen. Sicherheitsanforderungen und Anforderungen an verknüpfte Modelle müssen für den Produktivbetrieb gesondert berücksichtigt werden.

Quelle und Lizenz

Der Inhalt wurde anhand der Leitfäden von Autodesk Platform Services „Bringing Revit Cloud Worksharing Migration to AI Assistants with APS and MCP“, „Building Custom MCP Servers with Autodesk Platform Services“ und „Authentication Patterns for APS MCP Servers“ erstellt. In den bereitgestellten Quellenangaben ist der Lizenzstatus als serbest aufgeführt; eine konkrete Open-Source-Lizenz wird jedoch nicht genannt. Daher wird der Inhalt nicht als unter einer Lizenz wie CC BY veröffentlicht bezeichnet.