# Conectar Gitea

> Conecta tu propio servidor Gitea a AI CodeOps con un token de acceso personal: la URL de la instancia, los scopes de token que necesita y cómo se abren los pull requests por ti.

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

AI CodeOps funciona con los servidores Gitea que tú gestionas. Te conectas con la dirección de tu servidor y un token de acceso personal. Después, las sesiones escriben los cambios en una rama nueva y abren un pull request en tu servidor para su revisión.

## Antes de empezar

- La dirección **https** pública de tu servidor Gitea, por ejemplo `https://gitea.example.com`. AI CodeOps se ejecuta en la nube, así que debe poder llegar al servidor por internet.
- Las direcciones de redes privadas, `localhost`, las direcciones link-local y los nombres `.local` o `.internal` se rechazan. También las URL con una cadena de consulta o un `#fragment`. El error dice: "Use the public https address of your Git server".
- Una cuenta con acceso de escritura a los repositorios que quieres usar.

## Crea un token en Gitea

1. En Gitea, abre **Settings → Applications** y genera un token nuevo.
2. Dale acceso de lectura y escritura a **repository** (para clonar, hacer push de ramas, y crear y fusionar pull requests) y acceso de lectura a **user** (para mostrar qué cuenta está conectada).
3. Copia el token. Gitea 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 **Gitea**, 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 tu servidor antes de guardarlo. Si no puede conectar, el mensaje dice qué parte hay que corregir: Gitea 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 Gitea 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 tu propio 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 tu 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.

## 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 Gitea. Para rotar un token, desconecta y vuelve a conectar con el nuevo.

## Siguientes pasos

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