# Conectar Forgejo

> Conecta un servidor Forgejo, como Codeberg o tu propia instancia, a AI CodeOps con un token de acceso personal, y mira qué hace la plataforma con tus repositorios.

Fuente: https://aicodeops.dev/es/docs/git/forgejo

AI CodeOps funciona con servidores Forgejo, tanto si gestionas el tuyo como si usas una instancia pública. Te conectas con la dirección del servidor y un token de acceso personal. Después, las sesiones escriben los cambios en una rama nueva y abren un pull request para su revisión.

## Antes de empezar

- La dirección **https** pública del servidor, por ejemplo `https://forgejo.example.com`. AI CodeOps se ejecuta en la nube y tiene que llegar a él por internet.
- Las direcciones de redes privadas, `localhost`, las direcciones link-local y los nombres `.local` o `.internal` se rechazan, igual que las URL con una cadena de consulta o un `#fragment`.
- Una cuenta con acceso de escritura a los repositorios que quieres usar.
- En Codeberg (`https://codeberg.org`), lee primero sus [Condiciones de uso](https://codeberg.org/Codeberg/org/src/branch/main/TermsOfUse.md): no permiten proyectos que consistan en su mayor parte en código escrito por herramientas de IA generativa.

## Crea un token en Forgejo

1. En Forgejo, abre **Settings → Applications** y genera un token de acceso nuevo.
2. Concede lectura y escritura en **repository** (clonar, hacer push de ramas, crear y fusionar pull requests) y lectura en **user** (mostrar qué cuenta está conectada).
3. Copia el token ahora. Forgejo solo lo muestra una vez.

## Conecta el token

1. En tu espacio de trabajo, abre **Configure → Settings** y desplázate hasta **Git Providers**.
2. En la tarjeta **Forgejo**, introduce la **Instance URL**. Es obligatoria.
3. Pega el token en **or access token** y elige **Connect with token**.

AI CodeOps comprueba el token con el servidor antes de guardarlo. Si no puede conectar, el mensaje dice qué parte hay que corregir: Forgejo no reconoció el token, el token no tiene permiso para leer tu cuenta (indica los scopes que hay que añadir), o ninguna API de Forgejo respondió en esa dirección.

## OAuth

**Connect via OAuth** solo funciona para el único servidor Gitea o Forgejo en el que está registrada la aplicación OAuth de la plataforma, así que la tarjeta lo ofrece solo para ese servidor. Para cualquier otro servidor, usa un token.

## 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.
- **Ramas y pull requests:** cuando un cambio se aprueba y supera sus [controles de calidad](https://aicodeops.dev/es/docs/quality-gates), 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 instalan webhooks en el servidor, y AI CodeOps no comenta en los pull requests. 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. AI CodeOps tampoco lee los resultados de Forgejo Actions; las pruebas se ejecutan en el sandbox propio de la sesión.

## Tu token y tu acceso

- Una conexión te pertenece a ti, no al espacio de trabajo. Los roles del espacio de trabajo siguen decidiendo qué puede hacer cada miembro.
- El token se cifra en reposo (AES-256-GCM) y no se escribe en la configuración de Git de ningún repositorio.
- Para retirar el acceso, elige **Disconnect**, o elimina el token en Forgejo. Para rotarlo, desconecta y vuelve a conectar.

## Siguientes pasos

- [Crea un proyecto](https://aicodeops.dev/es/docs/projects) a partir de un repositorio de Forgejo.
- [Ejecuta tu primera sesión](https://aicodeops.dev/es/docs/sessions).
- [Solución de problemas](https://aicodeops.dev/es/docs/troubleshooting)
