Entwicklung
GitLab
Projekte, Issues, Merge Requests und Dateien von GitLab.com oder einem auf Ihren Servern installierten GitLab.
- Token oder Zugangsdaten
- Aktionen mit Bestätigung
- Auch über VPN-Tunnel
Tools für den Agenten
Der Agent wählt selbst das passende Tool für die Frage. Im Tab MCP und Datenbanken des Agenten können Sie nicht benötigte Tools deaktivieren.
| Tool | Funktion | Typ |
|---|---|---|
search_projects | Zugängliche Projekte nach Name suchen. | Lesen |
list_issues | Issues eines Projekts (Status, Labels, Text). | Lesen |
get_issue | Details zu einem Issue mit Beschreibung und letzten Kommentaren. | Lesen |
list_merge_requests | Merge Requests eines Projekts. | Lesen |
read_file | Liest eine Datei im Repository oder listet einen Ordner auf, wenn der Pfad ein Verzeichnis ist. | Lesen |
create_issue | Erstellt ein Issue in einem Projekt. Bestätigung erforderlich. | Mit Bestätigung |
add_comment | Fügt einem Issue einen Kommentar hinzu. Bestätigung erforderlich. | Mit Bestätigung |
Aktionen, die Daten ändern, sind standardmässig deaktiviert. Sie werden in der Verbindung mit der Option Erstellen von Issues und Kommentaren zulassen (mit Bestätigung) aktiviert; danach zeigt jede Aktion im Chat eine Zusammenfassung und wird erst mit Bestätigen und ausführen ausgeführt.
Einrichtung Schritt für Schritt
Öffnen Sie in Kaiross Integrationen, wählen Sie GitLab und klicken Sie auf Neue Verbindung. Das Formular zeigt denselben Leitfaden unter Leitfaden und empfohlene Berechtigungen.
- Verwenden Sie nach Möglichkeit ein group- oder project access token (Settings → Access tokens) statt eines persönlichen Tokens.
- Scope:
read_api(schreibgeschützt) oderapi, wenn Sie Schreiben aktivieren; die Rolle Reporter reicht zum Lesen aus. - Fügen Sie den Token ein: Er bleibt im Vault. Legen Sie ein Ablaufdatum fest.
Felder des Formulars: GitLab-URL.
Einzufügen (im Vault verschlüsselt, danach nicht mehr sichtbar): Access token.
Gut zu wissen
- Liegt der Dienst im Netzwerk Ihres Unternehmens, erstellen Sie zuerst einen Tunnel unter Einstellungen → Netzwerk / VPN und wählen Sie in der Verbindung bei Erreichbar über den Tunnel. Siehe Datenbanken und ERP.
Mit einem Agenten verbinden
- Öffnen Sie Agenten, wählen Sie den Agenten und gehen Sie zum Tab MCP und Datenbanken.
- Wählen Sie unter Hinzufügen die Option Bestehende Integration verbinden und die Verbindung, oder Aus dem Katalog für eine neue (die Schaltfläche heisst dann Speichern und verknüpfen).
- Prüfen Sie unter Aktivierte Tools die aktiven Tools und unter Aktionsbestätigung, welche Aktionen eine Bestätigung verlangen.
- Klicken Sie auf Im Chat testen und stellen Sie eine Frage, die Daten aus dem Dienst braucht.
Häufige Fehler
- Ungültige Zugangsdaten
- Prüfen Sie Token, Passwort oder API-Schlüssel: Oft fehlt ein Zeichen oder das Token ist abgelaufen. Erstellen Sie ein neues und aktualisieren Sie die Verbindung.
- Unzureichende Berechtigungen
- Dem Konto oder Token fehlen Berechtigungen: Vergleichen Sie sie mit der Konfiguration oben (Leitfaden und empfohlene Berechtigungen in der App) und erstellen Sie bei Bedarf ein neues Token.
- Dienst nicht erreichbar
- Prüfen Sie Adresse, Port und Firewall. Ein Server im Firmennetz braucht einen VPN-Tunnel; ohne Tunnel sind nur öffentliche Adressen erlaubt.
- Zu viele Anfragen
- Der Dienst begrenzt die Anzahl der Aufrufe: Versuchen Sie es in ein paar Minuten erneut.