Onboarding-Wizard

Das dreistufige Setup eines frischen Workspace: Profil, Team-Einladungen und AI-Client-Verbindung, mit den stabilen Ids für Agents.

Ein frischer Workspace öffnet direkt nach der Registrierung den Onboarding-Wizard unter /onboarding/wizard. Er läuft genau einmal; nach dem Abschluss landet man auf dem Dashboard, wo sich das Assistant-Panel von selbst öffnet. Diese Seite dokumentiert den Wizard für Menschen und für AI-Agents, die die UI steuern.

Die drei Schritte

  1. Profil

    Name und Land. Die Felder sind gewöhnliche Formulareingaben, adressierbar über ihre sichtbaren Labels.

  2. Einladen

    Teammitglieder per E-Mail einladen oder den teilbaren Link der Form /invitation/{token} kopieren. Wer sich über diesen Link registriert, tritt dem Workspace als Waiting for Approval bei, bis ein Admin auf der Company-Seite eine Rolle zuweist und aktiviert. Dieser Schritt ist überspringbar und später auf der Company-Seite wiederholbar.

  3. AI

    Einen externen AI-Client (Claude, OpenAI, Cursor oder Gemini) mit dem MCP-Endpoint des Workspace verbinden. Der Flow erstellt einen API-Key für den gewählten Client. Auch dieser Schritt ist überspringbar; derselbe Flow bleibt über die Profil-Seite verfügbar, und der eingebaute Assistant funktioniert ohne ihn.

Stabile Ids

ControlId
Primäraktion (nächster Schritt, im letzten Schritt Abschluss)#onboarding-back und #onboarding-next

#onboarding-next geht weiter und schließt im letzten Schritt den Wizard ab; #onboarding-back führt zum vorherigen Schritt zurück. Alles innerhalb eines Schritts ist ein normales Formular: per Label ausfüllen, dann #onboarding-next aktivieren.

Häufige Fragen

Kann ich Schritte überspringen?

Der Einladungs- und der AI-Schritt sind überspringbar. Einladungen lassen sich später auf der Company-Seite verschicken, und der AI-Client-Flow bleibt auf der Profil-Seite verfügbar. Der Profil-Schritt ist erforderlich.

Was passiert mit Personen, die sich über den Einladungslink registrieren?

Sie treten dem Workspace als Waiting for Approval bei. Ein Admin weist auf der Company-Seite eine Rolle zu und aktiviert sie; bis dahin können sie nicht im Workspace arbeiten.

Brauche ich einen verbundenen AI-Client, um den Assistant zu nutzen?

Nein. Der eingebaute Assistant funktioniert ohne externen Client. Der AI-Schritt verbindet externe Tools wie Claude oder Cursor über MCP mit dem Workspace.