GitLab.com

Voraussetzungen

Ein GitLab.com-Konto mit Zugriff auf die Projekte, die Sie verbinden möchten
Mindestens Developer-Zugriff auf die jeweilige Gruppe oder die Projekte

Access Token erstellen

KI-DACH benötigt ein Access Token, um auf Ihre GitLab-Repositories zugreifen und Webhooks einrichten zu können. Es werden sowohl Personal Access Tokens als auch Group Access Tokens unterstützt.

Personal Access Token

Melden Sie sich bei GitLab.com an — idealerweise mit einem dedizierten Service-Account.
Navigieren Sie zu Einstellungen > Access Tokens oder öffnen Sie direkt: gitlab.com/-/user_settings/personal_access_tokens
Klicken Sie auf Add new token und vergeben Sie einen aussagekräftigen Namen, z.B. KI-DACH.
Wählen Sie den Scope api aus. Dieser ist erforderlich für den vollen Funktionsumfang (Merge Requests, Kommentare, Webhooks).
Setzen Sie optional ein Ablaufdatum. Ohne Angabe gilt standardmäßig ein Jahr.
Klicken Sie auf Create personal access token und kopieren Sie den Token-Wert sofort — er wird nur einmal angezeigt.

Group Access Token

Group Access Tokens sind eine Alternative, die automatisch einen Bot-User in der Gruppe erstellen. Dies ist besonders praktisch, wenn Sie keinen separaten User-Account anlegen möchten.

Navigieren Sie zu Ihrer GitLab-Gruppe und öffnen Sie Einstellungen > Access Tokens.
Erstellen Sie ein neues Group Access Token mit dem Scope api und mindestens Developer-Zugriff.
Kopieren Sie den Token-Wert und verwenden Sie ihn bei der Verbindung in KI-DACH.

Empfehlung: Dedizierten Account nutzen

Wir empfehlen, einen separaten GitLab-User als Service-Account für KI-DACH anzulegen. Vorteile:

Reviews und Kommentare erscheinen unter einem eigenen Bot-Account, nicht unter Ihrem persönlichen Profil
Zugriffsrechte lassen sich unabhängig von Ihrem persönlichen Account verwalten
Bei Team-Änderungen bleibt die Integration bestehen

Empfohlene Einstellungen für den Service-Account:

Benutzername: ki-dach oder ki-dach-bot
E-Mail: Eine dedizierte Adresse, z.B. ki-dach@ihre-firma.de
Zugriff: Mindestens Developer auf die relevante Gruppe oder die Projekte

Mit KI-DACH verbinden

Öffnen Sie das KI-DACH-Dashboard und navigieren Sie zu Integrationen > GitLab.
Klicken Sie auf GitLab verbinden.
Fügen Sie Ihr Access Token ein (beginnt mit glpat-...).
Klicken Sie auf Verbinden. KI-DACH validiert das Token und stellt die Verbindung her.

Nach erfolgreicher Verbindung werden Ihre GitLab-Projekte automatisch synchronisiert und in der Übersicht angezeigt.

Projekte konfigurieren

Nach dem Verbinden können Sie für jedes Projekt individuell festlegen, welche Funktionen aktiv sein sollen.

Merge-Request-Reviews

Automatisch bei Erstellung — KI-DACH Agent erstellt automatisch ein Review, wenn ein neuer Merge Request geöffnet wird.
Bei Label — KI-DACH Agent erstellt ein Review, wenn das Label ki-dach dem Merge Request zugewiesen wird.

Issue-Automatisierung

Bei Label — KI-DACH Agent verarbeitet Issues, die mit dem Label ki-dach versehen werden.

Aktivieren Sie die gewünschten Optionen pro Projekt über den Schalter in der Projektliste. Beim Aktivieren eines Projekts wird automatisch ein Webhook auf GitLab eingerichtet.

Token aktualisieren

Falls Ihr Access Token abläuft oder Sie es erneuern möchten:

Erstellen Sie ein neues Token auf GitLab (siehe Access Token erstellen).
Öffnen Sie die GitLab-Integration im KI-DACH-Dashboard.
Verwenden Sie die Option zum Aktualisieren des Tokens bei der betroffenen Verbindung.

Fehlerbehebung

Ungültiges Access Token

Ungültiges Zugriffstoken. Bitte überprüfen Sie, ob Ihr Token korrekt ist, nicht abgelaufen ist und den erforderlichen Bereich (api) hat.

Stellen Sie sicher, dass der Token den Scope api besitzt
Prüfen Sie, ob der Token abgelaufen ist
Erstellen Sie bei Bedarf einen neuen Token

Unzureichende Berechtigungen für Webhooks

Ihr Access Token hat nicht die erforderlichen Berechtigungen, um Webhooks zu erstellen.

Bei einem Project Access Token ist mindestens die Rolle Maintainer erforderlich
Bei einem Personal Access Token stellen Sie sicher, dass der Scope api vorhanden ist
Prüfen Sie, ob der User mindestens Developer-Zugriff auf das Projekt hat

GitLab nicht erreichbar

GitLab konnte nicht erreicht werden.

Prüfen Sie Ihre Internetverbindung
Überprüfen Sie den GitLab-Status auf aktuelle Störungen

Webhook konnte nicht erstellt werden

Der Webhook konnte nicht auf GitLab erstellt werden.

Stellen Sie sicher, dass Ihr Token den Scope api besitzt und der User ausreichende Berechtigungen hat
Kontaktieren Sie den KI-DACH-Support, falls das Problem weiterhin besteht