AI CodeOps

Conectar GitHub

Conecta una cuenta de GitHub.com a AI CodeOps con OAuth o con un token de acceso personal, los scopes que necesita y lo que hace la plataforma con tus repositorios.

AI CodeOps trabaja en tus repositorios de GitHub mediante una conexión que haces una sola vez. Después, las sesiones clonan el repositorio, escriben el cambio en una rama nueva y abren un pull request para su revisión.

Antes de empezar

  • Una cuenta de GitHub.com con acceso a los repositorios que quieres usar.
  • GitHub Enterprise Server no es compatible. Para servidores Git que gestionas tú, AI CodeOps admite GitLab, Gitea y Forgejo.

Conectar con OAuth

  1. En tu espacio de trabajo, abre Configure → Settings y desplázate hasta Git Providers.
  2. En la tarjeta GitHub, elige Connect.
  3. GitHub te pide que autorices a AI CodeOps. Apruébalo, y vuelves a Settings con la cuenta listada en Connected Accounts.

AI CodeOps pide a GitHub estos scopes de OAuth:

ScopePara qué
repoLeer y escribir en los repositorios a los que tienes acceso: clonar, hacer push de una rama, abrir y fusionar pull requests. Incluye los repositorios privados.
read:userMostrar qué cuenta de GitHub está conectada.
user:emailSe pide junto con los scopes de inicio de sesión; AI CodeOps no lee la dirección mediante esta conexión.

Si la tarjeta no tiene botón Connect, o ves "GitHub sign-in isn't available for this server", la aplicación OAuth de la plataforma no está disponible. Conéctate con un token.

Conectar con un token de acceso personal

En la tarjeta de GitHub, pega un token en or access token (no OAuth app) y elige Connect with token. AI CodeOps comprueba el token con GitHub antes de guardarlo. Un token que GitHub no reconoce recibe "GitHub didn't recognise this token"; uno que no puede leer tu cuenta recibe un mensaje que indica los permisos que hay que añadir.

El token tiene que poder leer tu perfil de usuario, leer repositorios, hacer push de ramas, y crear y fusionar pull requests. En GitHub eso significa:

  • un token classic con el scope repo, o
  • un token fine-grained para los repositorios que quieras, con Contents y Pull requests en lectura y escritura (la lectura de Metadata va incluida).

Los tokens de acceso personal no se renuevan. Cuando el token caduque en GitHub, desconecta y vuelve a conectar con uno nuevo.

Qué hace AI CodeOps con el repositorio

  • Explorar: Develop → Repositories lista los repositorios que la cuenta puede ver, con sus ramas, archivos y pull requests.
  • Sesiones: una sesión clona el repositorio del proyecto en su sandbox y escribe allí el cambio.
  • Ramas y pull requests: cuando un cambio se aprueba y supera sus controles de calidad, AI CodeOps hace push de una rama llamada codeops/run-<id> y abre un pull request hacia la rama predeterminada del proyecto. El autor de los commits es "AI CodeOps".
  • Fusión: un pull request que abrió la consola se puede fusionar desde la consola. Antes se vuelve a ejecutar el control de publicación.

Las sesiones no registran webhooks en tus repositorios, y AI CodeOps no publica comentarios de revisión en GitHub. Un repositorio que conectas en Build & Test → Builds es la excepción: recibe un webhook, para que un push o un pull request puedan iniciar un build, y un estado de commit con el resultado de cada build.

Tu token y tu acceso

  • Las conexiones te pertenecen a ti, no al espacio de trabajo. Cada miembro conecta su propia cuenta, y los permisos del espacio de trabajo siguen decidiendo qué puede hacer.
  • Los tokens se cifran en reposo (AES-256-GCM) y nunca se escriben en la configuración de Git de un repositorio.
  • Para retirar el acceso, elige Disconnect junto a la cuenta. También puedes revocar la aplicación o el token en GitHub.

Siguientes pasos

¿Te resultó útil esta página?