Saltar al contenido principal
Background Agents y Bugbot necesitan la app de GitHub de Cursor para clonar repositorios y enviar cambios.

​
Instalación

  1. Ve a Integrations in Dashboard
  2. Haz clic en Connect junto a GitHub
  3. Elige entre All repositories o Selected repositories
Para desconectar tu cuenta de GitHub, vuelve al panel de integraciones y haz clic en Disconnect Account.

​
Usar Agent en GitHub

La integración con GitHub habilita flujos de trabajo de agentes en segundo plano directamente desde pull requests e issues. Podés activar un agente para leer el contexto, aplicar correcciones y hacer push de commits comentando @cursor [prompt] en cualquier PR o issue. Si tenés Bugbot habilitado, podés comentar @cursor fix para leer la corrección sugerida por Bugbot y activar un agente en segundo plano que resuelva el problema.

​
Permisos

La app de GitHub requiere permisos específicos para trabajar con agentes en segundo plano:
PermisoPropósito
Acceso al repositorioClonar tu código y crear ramas de trabajo
Pull requestsCrear PR con cambios del agente para tu revisión
IssuesHacer seguimiento de errores y tareas que los agentes descubren o corrigen
Checks and statusesInformar sobre la calidad del código y los resultados de las pruebas
Actions and workflowsSupervisar pipelines de CI/CD y el estado del despliegue
Todos los permisos siguen el principio de mínimo privilegio necesario para la funcionalidad de los agentes en segundo plano.

​
Configuración de la lista de IP permitidas

Si tu organización usa la función de lista de IP permitidas de GitHub para restringir el acceso a tus repositorios, primero tienes que contactar al soporte para habilitar esta funcionalidad para tu equipo.

​
Contactar al soporte

Antes de configurar las listas de IP permitidas, contacta a hi@cursor.com para habilitar esta función para tu equipo. Esto es obligatorio para ambos métodos de configuración a continuación. La app de GitHub de Cursor ya tiene la lista de IP preconfigurada. Puedes habilitar la lista de permitidos para las apps instaladas y heredar automáticamente esta lista. Este es el enfoque recomendado, ya que nos permite actualizar la lista y tu organización recibe las actualizaciones automáticamente. Para habilitar esto:
  1. Ve a la configuración de Seguridad de tu organización
  2. Ve a la configuración de la lista de IP permitidas
  3. Marca “Allow access by GitHub Apps”
Para ver instrucciones detalladas, consulta la documentación de GitHub.

​
Agregar IP directamente a tu lista de permitidos

Si tu organización usa listas de permitidos definidas por un IdP en GitHub o por algún motivo no puede usar la lista preconfigurada, puedes agregar manualmente las direcciones IP: 
184.73.225.134
3.209.66.12
52.44.113.131
La lista de direcciones IP puede cambiar esporádicamente. A los equipos que usan listas de permitidos de IP se les avisará con anticipación antes de agregar o quitar direcciones IP.

​
Solución de problemas

  • Instala la app de GitHub con acceso al repositorio
  • Revisa los permisos del repositorio para repos privados
  • Verifica los permisos de tu cuenta de GitHub
  • Dale a la app acceso de escritura a los pull requests
  • Revisa las reglas de protección de ramas
  • Reinstala si la instalación de la app venció
  • Revisa si está instalada a nivel de organización
  • Reinstala desde github.com/apps/cursor
  • Contacta al soporte si la instalación está dañada