Passer au contenu principal
Background Agents et Bugbot requièrent l’application GitHub de Cursor pour cloner des dépôts et pousser des modifications.

Installation

  1. Va sur Intégrations dans le tableau de bord
  2. Clique sur Connect à côté de GitHub
  3. Choisis le dépôt : All repositories ou 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 quel PR ou issue. Si tu as Bugbot activé, tu peux commenter @cursor fix pour lire la correction suggérée par Bugbot et déclencher un agent en arrière‑plan pour traiter le problème.

Permissions

L’appli GitHub a besoin d’autorisations spécifiques pour fonctionner avec les agents en arrière-plan :
PermissionPurpose
Repository accessCloner ton code et créer des branches de travail
Pull requestsCréer des PR avec les changements des agents pour que tu puisses les relire
IssuesSuivre les bugs et les tâches que les agents découvrent ou corrigent
Checks and statusesRendre compte de la qualité du code et des 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 d’IP

Si ton organisation utilise la fonctionnalité de liste d’autorisation d’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 d’IP pour ton équipe.

Contacter le support

Avant de configurer des listes d’autorisation d’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 d’IP
  3. Coche « Allow access by GitHub Apps »
Pour des instructions détaillées, consulte la documentation de GitHub.

Ajouter des 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 d’autorisation préconfigurée, tu peux ajouter les adresses IP manuellement :
184.73.225.134
3.209.66.12
52.44.113.131
La liste d’adresses IP peut occasionnellement changer. Les équipes utilisant des listes d’autorisation d’IP seront prévenues à l’avance avant tout ajout ou suppression d’adresses IP.

Dépannage

  • Installe l’app GitHub avec accès au dépôt
  • Vérifie les permissions du dépôt pour les dépôts privés
  • Vérifie les permissions de ton compte GitHub
  • Accorde à l’app l’accès en écriture aux pull requests
  • Vérifie les règles de protection de branches
  • Réinstalle si l’installation de l’app a expiré
  • Vérifie si elle est installée au niveau de l’organisation
  • Réinstalle depuis github.com/apps/cursor
  • Contacte le support si l’installation est corrompue
I