GitHub
La aplicación de GitHub de Cursor conecta tus repositorios para que puedas usar funciones como los agentes en la nube y Bugbot.
Configuración
Requiere acceso de administrador de Cursor y de la organización de GitHub.
- Ve a Integraciones en el panel de control
- Haz clic en Conectar junto a GitHub (o en Gestionar conexiones si ya está conectado)
- Elige Todos los repositorios o Repositorios seleccionados
- Vuelve al panel de control para configurar las funciones de tus repositorios
Para desconectar tu cuenta de GitHub, vuelve al panel de control de integraciones y haz clic en Desconectar cuenta.
Configuración de la lista de IP permitida
Si tu organización usa la función de lista de IP permitida de GitHub para restringir el acceso a tus repositorios, Cursor puede configurarse para usar un proxy de salida alojado con un conjunto reducido de IP.
Antes de configurar listas de IP permitidas, contacta con hi@cursor.com para activar esta función para tu equipo. Esto es necesario para cualquiera de los dos métodos de configuración que se indican a continuación.
Activa la configuración de la lista de IP permitida para las aplicaciones de GitHub instaladas (recomendado)
La aplicación de GitHub de Cursor ya tiene la lista de IP preconfigurada. Puedes activar la lista de permitidos para que las aplicaciones instaladas hereden esta lista automáticamente. Este es el enfoque recomendado, ya que nos permite actualizar la lista y tu organización recibirá las actualizaciones automáticamente.
Para activarla:
- Ve a los ajustes de seguridad de tu organización
- Navega a los ajustes de la lista de IP permitida
- Marca "Permitir el acceso mediante aplicaciones de GitHub"
Para obtener instrucciones detalladas, consulta la documentación de GitHub.
Añade IP directamente a tu lista de permitidos
Si tu organización usa listas de permitidos definidas por el IdP en GitHub o no puede usar la lista de permitidos preconfigurada, añade las IP del proxy que se indican en Proxy de salida de Git y lista de IP permitida.
Redes avanzadas
Las instancias autohospedadas admiten varios métodos de conexión además de las listas de IP permitidas. Para consultar los detalles de configuración y las opciones compatibles de redes privadas, consulta Conectividad privada.
Disponible para clientes Enterprise. Usa AWS PrivateLink cuando tu GitHub Enterprise Server esté en AWS o pueda situarse detrás de un AWS Network Load Balancer. PrivateLink permite que Cursor acceda a GHES y, cuando sea necesario, que GHES envíe webhooks a Cursor sin salida a Internet público.
Ideal para: Instancias de GHES alojadas en AWS y equipos que buscan conectividad privada mediante endpoints de VPC
Seguridad: Cifrado HTTPS, AWS PrivateLink, políticas de endpoints de VPC y tokens de acceso de cuentas de servicio
Desventajas: Requiere coordinación con Cursor y configurar el servicio de endpoint de AWS.
Disponible para clientes Enterprise. Usa Cloudflare Tunnel cuando AWS PrivateLink no sea viable o necesites un modelo de implementación exclusivamente de salida. Tu red ejecuta cloudflared y Cursor proporciona el nombre de host y el token del túnel.
Ideal para: Entornos sin acceso de red entrante
Seguridad: Cifrado HTTPS, Cloudflare Tunnel y tokens de acceso de cuentas de servicio
Desventajas: Requiere ejecutar y mantener cloudflared en tu entorno.
Permisos
La aplicación de GitHub solicita los siguientes permisos para admitir las funciones de Cursor:
| Permiso | Finalidad |
|---|---|
| Acceso al repositorio | Clonar tu código y crear ramas de trabajo |
| Pull requests | Crear PR y dejar comentarios de revisión |
| Problemas | Hacer un seguimiento de los errores y las tareas detectados durante las revisiones |
| Comprobaciones y estados | Informar sobre la calidad del código y los resultados de las pruebas |
| Acciones y flujos de trabajo | Supervisar las canalizaciones de CI/CD y volver a ejecutar CI desde pull requests |
| Administración | Leer las reglas de protección de ramas y de comprobaciones obligatorias para determinar si se puede fusionar un PR |
| Roles personalizados del repositorio | Determinar los niveles de acceso de los usuarios para que aparezcan las opciones adecuadas de fusión y revisión |
| Propiedades personalizadas de la organización | Mostrar en los filtros los metadatos del repositorio definidos por la organización |
Todos los permisos cumplen el principio de privilegios mínimos.
Ámbitos de Git protegidos
Restringe tu organización de GitHub a tu organización de Cursor para que solo tus equipos puedan usar sus repositorios con agentes en la nube, automatizaciones y Bugbot. Para proteger un ámbito, necesitas acceso de propietario o administrador de la organización de GitHub. Consulta Ámbitos de Git protegidos.
Solución de problemas
- Instala la aplicación de GitHub con acceso al repositorio
- Comprueba los permisos del repositorio para repositorios privados
- Verifica los permisos de tu cuenta de GitHub
- Concede a la aplicación acceso de escritura a los pull requests
- Comprueba las reglas de protección de ramas
- Reinstala la aplicación si su instalación ha caducado
- Comprueba si está instalada a nivel de organización
- Reinstala desde github.com/apps/cursor
- Contacta con el soporte si la instalación está dañada
Próximos pasos
Una vez conectada la integración de GitHub, configura las funciones que la utilizan:
- Bugbot — revisiones automatizadas de PR que detectan errores y vulnerabilidades de seguridad
- Agentes en la nube — agentes de IA que se ejecutan en la nube en tus repositorios