Background Agents und Bugbot benötigen die Cursor-GitHub-App, um Repositories zu klonen und Änderungen zu pushen.

​
Installation

  1. Geh zu Integrations im Dashboard
  2. Klick auf Connect neben GitHub
  3. Wähl das Repository: entweder All repositories oder Selected repositories
Um dein GitHub-Konto zu trennen, geh zurück zum Integrations-Dashboard und klick auf Disconnect Account.

​
Agent in GitHub verwenden

Die GitHub-Integration ermöglicht Hintergrund-Workflows mit dem Agent direkt aus Pull Requests und Issues. Du kannst einen Agenten triggern, der Kontext liest, Fixes umsetzt und Commits pusht, indem du @cursor [prompt] in einem beliebigen PR oder Issue kommentierst. Wenn du Bugbot aktiviert hast, kannst du @cursor fix kommentieren, um den vorgeschlagenen Fix von Bugbot zu übernehmen und damit einen Hintergrund-Agenten zu starten, der das Issue behebt.

​
Berechtigungen

Die GitHub-App benötigt bestimmte Berechtigungen, um mit Hintergrundagenten zu arbeiten:
BerechtigungZweck
Repository-ZugriffDeinen Code klonen und Arbeits-Branches erstellen
Pull RequestsPRs mit Agent-Änderungen zu deiner Durchsicht erstellen
IssuesBugs und Aufgaben verfolgen, die Agenten entdecken oder beheben
Checks und StatusÜber Codequalität und Testergebnisse berichten
Actions und WorkflowsCI/CD-Pipelines und den Bereitstellungsstatus überwachen
Alle Berechtigungen folgen dem Prinzip der geringstmöglichen Rechte, die für die Funktionalität der Hintergrundagenten erforderlich sind.

​
Konfiguration der IP-Allowlist

Wenn deine Organisation die IP-Allowlist-Funktion von GitHub nutzt, um den Zugriff auf eure Repositories einzuschränken, musst du zuerst den Support kontaktieren, damit die IP-Allowlist für dein Team aktiviert wird.

​
Support kontaktieren

Bevor du IP-Allowlists konfigurierst, kontaktiere hi@cursor.com, um diese Funktion für dein Team zu aktivieren. Das ist für beide unten beschriebenen Konfigurationsmethoden erforderlich. Die Cursor-GitHub-App hat die IP-Liste bereits vorkonfiguriert. Du kannst die Allowlist für installierte Apps aktivieren, damit diese Liste automatisch übernommen wird. Das ist der empfohlene Ansatz, da wir die Liste pflegen können und deine Organisation Updates automatisch erhält. So aktivierst du das:
  1. Geh zu den Sicherheitseinstellungen deiner Organisation
  2. Navigiere zu den IP-Allowlist-Einstellungen
  3. Aktiviere „Allow access by GitHub Apps“
Ausführliche Anleitungen findest du in GitHubs Dokumentation.

​
IPs direkt zu deiner Allowlist hinzufügen

Wenn deine Organisation in GitHub IdP-definierte Allowlists verwendet oder die vorkonfigurierte Allowlist nicht nutzen kann, kannst du die IP-Adressen manuell hinzufügen: 
184.73.225.134
3.209.66.12
52.44.113.131
Die Liste der IP-Adressen kann sich gelegentlich ändern. Teams, die IP-Allowlists verwenden, werden im Voraus benachrichtigt, bevor IP-Adressen hinzugefügt oder entfernt werden.

​
Fehlerbehebung