UI5 MCP Server einrichten

Der UI5 MCP Server läuft als lokaler stdio-Prozess und lässt sich in wenigen Schritten mit einem MCP-fähigen Client verbinden.

Voraussetzungen

Installiere Node.js in Version 20.17.0 oder 22.9.0 (oder neuer) sowie npm ab Version 8. Ein bestehendes UI5-Projekt ist nicht zwingend nötig – create_ui5_app kann auch ein neues Projekt von Grund auf gerüsten.

Server mit dem Client verbinden

Für die meisten MCP-Clients funktioniert die Standardkonfiguration mit npx -y @ui5/mcp-server als stdio-Befehl. Claude-Code-Nutzer richten den Server direkt über die CLI ein:

claude mcp add --transport stdio --scope user ui5-mcp-server -- npx -y @ui5/mcp-server

Für Codex existiert der analoge Befehl codex mcp add --transport stdio ui5-mcp-server -- npx -y @ui5/mcp-server. VS Code bietet zusätzlich die Installation direkt aus der GitHub-MCP-Server-Registry. Unter nativem Windows (außerhalb von WSL) muss npx gegebenenfalls über cmd /c aufgerufen werden, da der Prozessaufruf sonst fehlschlagen kann.

Projektkonventionen für den Agenten hinterlegen

Damit ein Agent den Server auch von sich aus nutzt, empfiehlt die offizielle Dokumentation, eine kurze Regel in die projektweite AGENTS.md beziehungsweise CLAUDE.md aufzunehmen: den Agenten anzuweisen, vor UI5-spezifischen Aufgaben zunächst get_guidelines aufzurufen, um aktuelle Coding-Standards abzurufen, statt sich auf möglicherweise veraltetes Trainingswissen zu verlassen.

Erste Schritte mit dem Agenten

Für ein neues Projekt lässt sich der Agent bitten, create_ui5_app mit einer passenden Vorlage aufzurufen. In einem bestehenden Projekt liefert get_project_info zunächst einen Überblick über Framework-Variante (SAPUI5 oder OpenUI5) und Version. Vor größeren Änderungen lohnt sich ein Blick in get_api_reference für die betroffenen Steuerelemente, und nach Abschluss einer Änderung prüfen run_ui5_linter und run_manifest_validation, ob der erzeugte Code den offiziellen Konventionen entspricht.

Konfiguration anpassen

Reicht die Standard-Domainliste (localhost, services.odata.org) nicht aus, weil das Projekt zusätzliche OData-Services einbindet, lässt sich UI5_MCP_SERVER_ALLOWED_DOMAINS als Umgebungsvariable in der Client-Konfiguration um weitere Domains ergänzen. Wer ausschließlich mit SAPUI5 statt OpenUI5 arbeitet, muss in der Regel nichts anpassen – der Server erkennt die Framework-Variante automatisch aus der Projektkonfiguration und wählt die passende CDN-Quelle.

Typische Stolperfallen

Fehlt eine unterstützte Node.js-Version, startet der Server gar nicht erst; ein node --version-Check vor der Einrichtung erspart unnötige Fehlersuche. Wird eine externe Domain für API-Aufrufe benötigt, die nicht in der Allowlist steht, schlagen die betroffenen Werkzeuge fehl, bis die Domain ergänzt wurde. Da der Server rein lokal läuft, funktioniert er nicht als gemeinsam genutzter Team-Endpunkt – jede entwickelnde Person richtet ihn einzeln auf der eigenen Maschine ein.

Im Team einheitlich einrichten

Weil jede Person den Server lokal selbst startet, lohnt es sich, die Client-Konfiguration (etwa den claude mcp add-Befehl oder den entsprechenden Eintrag für Codex/Cursor) zusammen mit der AGENTS.md-Regel zum Aufruf von get_guidelines im Projekt-Repository zu dokumentieren, statt sie nur mündlich weiterzugeben. So starten neue Teammitglieder mit derselben Konfiguration und demselben Agentenverhalten, ohne dass sich abweichende lokale Einstellungen einschleichen und zu inkonsistentem, teils gegen die UI5-Konventionen verstoßendem Code führen.