Background Agents et Bugbot ont besoin de l’app GitHub de Cursor pour cloner des dépôts et pousser des modifications.

Installation

  1. Va sur Integrations in Dashboard
  2. Clique sur Connect à côté de GitHub
  3. Choisis le dépôt, soit All repositories soit Selected repositories
Pour déconnecter ton compte GitHub, retourne sur le tableau de bord des intégrations et clique sur Disconnect Account.

Utiliser Agent dans GitHub

L’intégration GitHub permet d’exécuter des workflows d’agent en arrière-plan directement depuis les pull requests et les issues. Tu peux déclencher un agent pour lire le contexte, appliquer des correctifs et pousser des commits en commentant @cursor [prompt] sur n’importe quelle PR ou issue. Si tu as Bugbot activé, tu peux commenter @cursor fix pour lire le correctif suggéré par Bugbot et déclencher un agent en arrière-plan pour traiter le problème.

Autorisations

L’app GitHub a besoin d’autorisations spécifiques pour fonctionner avec les agents en arrière-plan :
AutorisationObjectif
Repository accessCloner ton code et créer des branches de travail
Pull requestsCréer des PR avec les modifications de l’agent pour ta relecture
IssuesSuivre les bugs et les tâches que les agents découvrent ou corrigent
Checks and statusesReporter la qualité du code et les résultats de tests
Actions and workflowsSurveiller les pipelines CI/CD et l’état des déploiements
Toutes les autorisations respectent le principe du moindre privilège nécessaire au fonctionnement des agents en arrière-plan.

Configuration de la liste d’autorisation IP

Si ton organisation utilise la fonctionnalité de liste d’autorisation IP de GitHub pour restreindre l’accès à tes dépôts, tu dois d’abord contacter le support pour activer la fonctionnalité de liste d’autorisation IP pour ton équipe.

Contacter le support

Avant de configurer des listes d’autorisation IP, contacte hi@cursor.com pour activer cette fonctionnalité pour ton équipe. C’est requis pour les deux méthodes de configuration ci-dessous. L’application GitHub Cursor a déjà la liste d’IP préconfigurée. Tu peux activer la liste d’autorisation pour les applications installées afin d’hériter automatiquement de cette liste. C’est l’approche recommandée, car elle nous permet de mettre à jour la liste et ton organisation reçoit les mises à jour automatiquement. Pour l’activer :
  1. Va dans les paramètres de sécurité de ton organisation
  2. Accède aux paramètres de la liste d’autorisation IP
  3. Coche « Allow access by GitHub Apps »
Pour des instructions détaillées, consulte la documentation de GitHub.

Ajouter des adresses IP directement à ta liste d’autorisation

Si ton organisation utilise des listes d’autorisation définies par un IdP dans GitHub ou ne peut pas utiliser la liste préconfigurée, tu peux ajouter manuellement les adresses IP :
184.73.225.134
3.209.66.12
52.44.113.131
La liste des adresses IP peut occasionnellement changer. Les équipes utilisant des listes d’autorisation IP seront prévenues à l’avance avant l’ajout ou la suppression d’adresses IP.

Dépannage