# Conectar Bitbucket

> Conecta una cuenta de Bitbucket Cloud a AI CodeOps con OAuth para que las sesiones puedan hacer push de ramas y abrir pull requests, y conoce los límites de las conexiones con token.

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

AI CodeOps funciona con los repositorios de los espacios de trabajo de Bitbucket Cloud. Conecta tu cuenta de Bitbucket una vez; después, las sesiones escriben los cambios en una rama nueva y abren un pull request para su revisión.

## Antes de empezar

- Una cuenta de Bitbucket Cloud con acceso de escritura a los repositorios que quieres usar.
- Bitbucket Server y Data Center no son compatibles.

## Conectar con OAuth

Esta es la forma recomendada de conectar Bitbucket.

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

Bitbucket muestra los permisos en su pantalla de consentimiento. AI CodeOps los usa para leer tu cuenta y tus repositorios, hacer push de ramas, y crear y fusionar pull requests. Los tokens de OAuth se renuevan automáticamente antes de que caduquen.

Si la tarjeta no tiene botón **Connect**, o ves "Bitbucket sign-in isn't available for this server", el consumidor OAuth de la plataforma no está disponible. Contacta con soporte.

## Conexiones con token

La tarjeta tiene también un campo de token, **or access token (no OAuth app)**. AI CodeOps envía ese token a Bitbucket como token Bearer. Las app passwords de Bitbucket y los API tokens que necesitan tu nombre de usuario o tu correo electrónico junto a ellos no funcionan en este campo. Si Bitbucket no reconoce un token, conéctate con OAuth.

## 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 añaden webhooks a tus repositorios, 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.
- Los tokens se cifran en reposo (AES-256-GCM) y no se escriben en la configuración de Git de ningún repositorio.
- Para retirar el acceso, elige **Disconnect** junto a la cuenta. También puedes revocar el acceso de AI CodeOps en los ajustes de tu Bitbucket.

## Siguientes pasos

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