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
I