Entwicklung
GitHub
Repository, Code, Commits, Issues und Pull Requests von GitHub (auch Enterprise).
- Token oder Zugangsdaten
- Aktionen mit Bestätigung
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_repositories | Repositorys suchen (GitHub-Suchsyntax, z. B. "org:firma rechnungen"). | Lesen |
list_issues | Issues und Pull Requests eines Repositorys, nach Status und Labels filterbar. | Lesen |
search_issues | Issues und Pull Requests mit GitHub-Syntax suchen (z. B. "repo:firma/app is:open bug"). | Lesen |
get_issue | Details zu einem Issue oder Pull Request mit Beschreibung und letzten Kommentaren. | Lesen |
read_file | Liest eine Datei (oder listet einen Ordner auf) in einem Repository. Mit startLine/endLine werden nur diese Zeilen nummeriert zurückgegeben: Verwenden Sie dies für lange Dateien und um pfad:zeile zu zitieren. | Lesen |
search_code | Sucht im Code des Standard-Branches und zeigt die gefundenen Dateien und Ausschnitte. | Lesen |
list_tree | Dateibaum eines Repositorys (rekursiv), nach Ordner filterbar: nützlich zur Orientierung, bevor Sie Dateien lesen. | Lesen |
get_commit | Details zu einem Commit: vollständige Nachricht und geänderte Dateien mit den Unterschieden. | Lesen |
list_pull_requests | Pull Requests eines Repositorys, nach Status und Ziel-Branch filterbar. | Lesen |
get_pull_request | Details zu einer Pull Request: Beschreibung, geänderte Dateien mit den Unterschieden und Reviews. | Lesen |
list_commits | Letzte Commits eines Repositorys, auch nach Branch oder Pfad. | Lesen |
create_issue | Erstellt ein Issue. Bestätigung erforderlich. | Mit Bestätigung |
add_comment | Fügt einem Issue oder Pull Request 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 GitHub und klicken Sie auf Neue Verbindung. Das Formular zeigt denselben Leitfaden unter Leitfaden und empfohlene Berechtigungen.
- GitHub → Settings → Developer settings → Fine-grained tokens → Generate new token.
- Repository access: only the required repositories. Permissions: Contents and Issues/Pull requests in Read-only (Read and write only if you enable writing), Metadata Read-only.
- Paste the token: it stays in the Vault. Set an expiration date and renew it.
Felder des Formulars: Standardorganisation oder -benutzer, API-URL (nur GitHub Enterprise Server).
Einzufügen (im Vault verschlüsselt, danach nicht mehr sichtbar): Personal access token.
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.
- Zu viele Anfragen
- Der Dienst begrenzt die Anzahl der Aufrufe: Versuchen Sie es in ein paar Minuten erneut.