Schnellstart Aufbau mit AI Portal
Wir haben festgestellt: KI-Vibe-Coding bringt durchaus ansprechende Seiten hervor, tut sich aber schwer damit, an ein reales Geschäftssystem anzudocken – oder es baut Authentifizierung, Berechtigungen und Tabellenentwurf noch einmal von Grund auf nach.
NocoBase als Low-Code-/No-Code-Plattform bringt all das bereits mit. Sie können es als Basis für den Systemkern verwenden: Der AI Agent kümmert sich um die Geschäftslogik, NocoBase liefert die zuverlässige Infrastruktur für Authentifizierung, Datenbank, API und Berechtigungen.
Dafür stellen wir einen Anwendungseinstieg namens AI Portal bereit. Dessen Quellcode liegt lokal und ist dem AI Agent zum Schreiben vorbehalten. Der in diesem Einstieg geschriebene Code kann direkt auf die Basisfähigkeiten von NocoBase zugreifen, und die gebauten Seiten sind unmittelbar aufrufbar.

Was NocoBase bereitstellt
Beim Aufbau eines Geschäftssystems geht die Zeit meist nicht für die Seiten selbst drauf, sondern für alles dahinter – Benutzeranmeldung, Berechtigungsprüfung, Tabellenentwurf, CRUD-Schnittstellen, Datei-Upload und -Download. Das braucht jedes System, und es jedes Mal neu zu bauen lohnt sich nicht.
All das bringt NocoBase bereits mit:
- Authentifizierungssystem – Anmeldung mit Benutzername und Passwort funktioniert sofort. OIDC, SAML, CAS, LDAP, SMS, DingTalk, WeCom und weitere Verfahren stehen bereit, sobald sie serverseitig aktiviert sind; das Frontend muss sie nur noch anbinden
- Datenbank und mehrere Datenquellen – integrierte Verwaltung von Datentabellen sowie Anbindung externer Datenquellen wie MySQL oder PostgreSQL
- REST API – sobald eine Datentabelle existiert, sind ihre CRUD-Schnittstellen automatisch vorhanden, inklusive Filterung, Sortierung, Paginierung und Beziehungsfeldern
- Berechtigungssteuerung – rollenbasierte ACL bis auf Feld- und Datensatzebene. Das Frontend kann die Berechtigungen des aktuellen Benutzers auslesen und daraus ableiten, was angezeigt wird
- Workflow – Automatisierung von Geschäftsprozessen, ausgelöst aus dem Frontend oder durch Datenänderungen
- Dateispeicher – Upload und Download

Auf Basis dieser Fähigkeiten haben wir einen standardisierten Systemvorlagen-Code gebaut, den der AI Agent einfach kopieren kann, um eine lauffähige Grundanwendung zu erhalten. Zusätzlich stellt NocoBase eine Reihe von Skills wie Datenmodellierung und Berechtigungskonfiguration bereit. Sobald Sie Ihre Geschäftsanforderungen beschreiben, generiert der AI Agent also nicht nur Frontend-Seiten, sondern legt auch die Datentabellen an und konfiguriert die Berechtigungen – am Ende steht ein vollständiges Geschäftssystem.
Voraussetzungen
- NocoBase >= 3.0.0-alpha.6
- Node.js >= 22
- pnpm – die Portal-Vorlage installiert damit Abhängigkeiten und startet den Entwicklungsserver
- Die Alpha-Version der
nocobase cli(Hinweis: derzeit wird nur die Alpha-Version unterstützt)npm install -g @nocobase/cli@alpha- sowie eine NocoBase-Anwendung, die bereits über
nb init --uiinitialisiert wurde, siehe Anbindungsanleitung für AI Agents
- Ein AI Agent, zum Beispiel Claude Code, Codex oder Cursor
Schritt 1: Prüfen, ob Sie bereits ein AI Portal haben
Vergewissern Sie sich zunächst, dass das standardmäßige main tatsächlich vorhanden ist:

Die Ausgabe listet Portal-Name, Zugriffs-URL, Portal-Typ, source storage, Entwicklungspfad, Aktivierungsstatus und Standardstatus auf.
Nachdem Sie den Quellcode gezogen haben, liefert info weitere Details, etwa wohin Entwicklungspfad und Deployment-Pfad jeweils zeigen:
Schritt 2: Entwicklungsmodus starten
Der Entwicklungsserver läuft standardmäßig unter http://localhost:5173.
Die Vorlage bringt eine Benutzerverwaltungsseite auf Basis der NocoBase-Datentabelle users mit. Melden Sie sich an und sehen Sie sich das Ergebnis an – zugleich ist es ein gutes Ausgangsbeispiel, an dem sich die KI orientieren kann.

Schritt 3: Die KI eine Seite ändern lassen
Wechseln Sie in den Entwicklungs-Workspace des Portals (pull legt ihn standardmäßig unter ./main an; im Zweifel prüfen Sie den Entwicklungspfad mit nb portal info main), öffnen Sie dort Ihren AI Agent – etwa Claude Code, Codex oder Cursor – und geben Sie einen Prompt ein:
Die KI liest die vorhandenen Seiten und Erweiterungen durch, schreibt die neue Seite nach den Konventionen der Vorlage, und Sie sehen das Ergebnis unter http://localhost:5173.
Wie Sie effizient mit einem AI Agent zusammenarbeiten, lesen Sie unter Aufbau mit einem AI Agent.
Schritt 4: Deployen
Wenn die lokalen Änderungen passen, pushen Sie den Quellcode auf die Gegenstelle und deployen ihn anschließend:
Wohin push den Quellcode schickt, hängt von der source-storage-Konfiguration dieses Portals ab. Standard ist nocobase, der Quellcode wird also von NocoBase verwaltet. Haben Sie ihn mit nb portal config auf git gestellt, committet und pusht push den Quellcode in das von Ihnen angegebene Git-Repository, und --message wird zur Git-Commit-Message. Details finden Sie unter Deployment und Quellcodeverwaltung.
Nach dem Deployment rufen Sie /x/main/ auf und sehen dort Ihre Änderungen.
Damit ist der komplette Kreislauf einmal durchlaufen – Anforderung beschreiben, KI schreibt den Code, lokal das Ergebnis prüfen, pushen und deployen.
Wenn Sie weitere Einstiege brauchen
Eine Anwendung kann mehrere Portale haben. Zum Beispiel eines für interne Mitarbeiter und eines für externe Kunden: Seiten und Berechtigungen bleiben vollständig getrennt, während die Daten gemeinsam genutzt werden:
Beim Erstellen entsteht im aktuellen Verzeichnis ./customer als Entwicklungs-Workspace; mit --path können Sie einen anderen Ort angeben. Ein neues Portal wird genauso mit nb portal dev entwickelt und mit nb portal deploy deployt – wechseln Sie einfach in seinen Workspace und öffnen Sie dort Ihren AI Agent. Ausführlich beschrieben ist das unter Deployment und Quellcodeverwaltung.
Demo ausprobieren
Wenn Sie den Aufbau mit AI Portal einmal erleben möchten, können Sie unter https://demo.nocobase.com/new eine Demo-Umgebung anfordern. Nachdem Sie das Formular ausgefüllt haben, erzeugen wir für Sie eine eigene Demo-Umgebung – darin enthalten sind mehrere AI-Portal-Anwendungen, die auf der NocoBase-Basis umgesetzt wurden.

Anschließend wählen Sie ein AI Portal aus und rufen es auf:

Auf der Willkommensseite des Portals stellen wir außerdem einen Prompt bereit, mit dem sich Ihr AI Agent direkt mit dieser AI-Portal-Anwendung verbinden, den Anwendungscode ziehen, lokal einen Entwicklungsserver starten, Seiten ändern und das Ergebnis zurück in die Demo-Umgebung pushen und deployen kann. Nach erfolgreichem Deployment aktualisieren Sie die Seite und sehen das Ergebnis.
Wie geht es weiter?
- Aufbau mit einem AI Agent – wie Sie Prompts schreiben und wie Sie zurückrollen, wenn die KI etwas falsch macht
- Projektstruktur und Technologie-Stack – die Verzeichniskonventionen der Vorlage und die gängigen Befehle
- Deployment und Quellcodeverwaltung – Portal-Quellcode unter Git stellen sowie Deployment über mehrere Umgebungen
Verwandte Links
- Aufbau mit einem AI Agent – Portal-Seiten in natürlicher Sprache von der KI schreiben lassen
- Projektstruktur und Technologie-Stack – die Verzeichniskonventionen der Vorlage und die gängigen Befehle
- Standardkomponenten und Erweiterungen – die shadcn/ui-Komponentenbasis und der Erweiterungsmechanismus
- Deployment und Quellcodeverwaltung – der komplette Ablauf aus Entwicklung, Push und Deployment
- Anbindungsanleitung für AI Agents – NocoBase CLI installieren und Initialisierung abschließen
- Schnellstart KI-Builder – die andere Art des Aufbaus, ohne Code zu schreiben
- Versionsverwaltung – Versions-Snapshots beim No-Code-Aufbau
nb portalBefehlsreferenz – vollständige Parameterbeschreibung aller Portal-Befehle

