> ## Documentation Index
> Fetch the complete documentation index at: https://www.mintlify.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Bitbucket Cloud

> Conecta un repositorio de Bitbucket Cloud a Mintlify para despliegues automáticos, vistas previas de pull requests y sincronización continua.

<Info>
  Bitbucket Cloud requiere un [plan Enterprise](https://mintlify.com/pricing?ref=bitbucket-cloud).
</Info>

Mintlify se conecta a Bitbucket Cloud mediante OAuth. Después de conectar un repositorio, Mintlify despliega automáticamente los cambios enviados a tu rama de despliegue y crea despliegues de vista previa para las pull requests.

Mintlify admite repositorios de Bitbucket Cloud alojados en `bitbucket.org`. Bitbucket Data Center, el agente de Slack y las automatizaciones no son compatibles con los repositorios de Bitbucket.

<div id="requirements">
  ## Requisitos
</div>

* Una cuenta de Bitbucket Cloud
* Permiso para crear un webhook en el repositorio que quieres conectar
* Acceso de administrador a tu organización de Mintlify
* Un archivo `docs.json` en tu repositorio

<div id="set-up-a-new-bitbucket-connection">
  ## Configurar una nueva conexión con Bitbucket
</div>

Cuando abres [Git Settings](https://app.mintlify.com/settings/deployment/git-settings) por primera vez, un asistente de configuración te guía en la conexión de tu repositorio de Bitbucket.

<Steps>
  <Step title="Selecciona Bitbucket como tu proveedor">
    1. En la página de [Git Settings](https://app.mintlify.com/settings/deployment/git-settings), selecciona **Connect to Bitbucket**.
    2. Haz clic en **Continue**.
  </Step>

  <Step title="Mueve el contenido alojado en Mintlify">
    Si actualmente alojas tu contenido en un repositorio gestionado por Mintlify, descárgalo como un archivo zip. Extrae el contenido del zip y súbelo a tu repositorio de Bitbucket.

    Si tu contenido ya está en Bitbucket, haz clic en **Continue setup**.
  </Step>

  <Step title="Autoriza Bitbucket">
    1. Haz clic en **Connect Bitbucket**.
    2. Bitbucket abre una nueva página para autorizar a Mintlify a acceder a tu cuenta de Bitbucket. Autoriza a Mintlify a acceder al repositorio que quieres conectar.

    Después de la autorización, Bitbucket te redirige a la configuración de Git de Mintlify.
  </Step>

  <Step title="Configura el repositorio">
    Introduce los siguientes valores:

    * **Workspace**: El slug del workspace de Bitbucket que posee el repositorio. Por ejemplo, en `https://bitbucket.org/acme/docs`, `acme` es el slug del workspace.
    * **Repository**: El slug del repositorio. Por ejemplo, en `https://bitbucket.org/acme/docs`, `docs` es el slug del repositorio.
    * **Deploy branch**: La rama que se publica en tu sitio de documentación en producción, como `main`.
  </Step>

  <Step title="Configura un directorio de contenido (opcional)">
    1. Si tu archivo `docs.json` está en un subdirectorio, activa **Docs are in a subdirectory** en tu página de configuración de Git.
    2. Introduce la ruta al directorio que contiene tu archivo `docs.json`. Por ejemplo, si tu `docs.json` está en el directorio `apps/docs/`, introduce `apps/docs`.
  </Step>

  <Step title="Conecta el repositorio">
    1. Haz clic en **Connect**.
    2. Confirma el cambio. Mintlify verifica que la cuenta de Bitbucket autorizada pueda acceder a tu repositorio y registra el webhook que activa los despliegues y las vistas previas de pull requests.
  </Step>
</Steps>

<div id="update-an-existing-connection">
  ## Actualizar una conexión existente
</div>

1. Navega a la página de [Git Settings](https://app.mintlify.com/settings/deployment/git-settings) de tu dashboard de Mintlify.
2. Expande la sección **Bitbucket OAuth**.
3. Activa o desactiva repositorios individuales. Desactivar un repositorio elimina su webhook de Mintlify.

Revocar una conexión elimina los webhooks de Mintlify de todos los repositorios conectados a través de esa cuenta.

<div id="configure-multiple-repositories">
  ## Configurar varios repositorios
</div>

Puedes combinar contenido de varios repositorios de Bitbucket en un solo sitio. Todas las fuentes del despliegue deben usar Bitbucket, y debes activar cada repositorio en **Bitbucket OAuth** antes de añadirlo como fuente.

Consulta [Despliegues multirrepositorio](/docs/es/deploy/multi-repo) para ver las instrucciones de configuración e información sobre rutas URL, fuentes base y navegación.

<div id="troubleshooting">
  ## Solución de problemas
</div>

<AccordionGroup>
  <Accordion title="Repositorio no autorizado">
    Si Mintlify informa de que ninguna instalación conectada puede acceder a tu repositorio, comprueba lo siguiente:

    * Los valores de workspace y repository usan los slugs correctos, no los nombres visibles.
    * La cuenta de Bitbucket conectada tiene los permisos necesarios para acceder al repositorio.
    * Has activado el repositorio en la sección **Bitbucket OAuth** de la configuración de Git de Mintlify.

    Si el repositorio no aparece, vuelve a conectar tu cuenta de Bitbucket con una cuenta que tenga acceso al repositorio.
  </Accordion>

  <Accordion title="Los despliegues no se activan automáticamente">
    En Bitbucket, abre **Repository settings** > **Webhooks** y verifica que exista un webhook activo llamado **Mintlify**. Si falta, vuelve a la configuración de Git de Mintlify, desactiva el repositorio en **Bitbucket OAuth** y actívalo de nuevo.

    Verifica que la rama en la configuración de Git de Mintlify coincida con la rama de Bitbucket a la que envías los cambios.
  </Accordion>

  <Accordion title="Las vistas previas de pull requests no aparecen">
    Verifica que el webhook de Mintlify esté activo e incluya los eventos de pull request. Si tus permisos de Bitbucket cambiaron después de conectar el repositorio, vuelve a conectar tu cuenta de Bitbucket y activa el repositorio de nuevo.
  </Accordion>
</AccordionGroup>


## Related topics

- [¿Qué es Mintlify?](/docs/es/what-is-mintlify.md)
- [Crear documentación para desarrolladores](/docs/es/guides/developer-documentation.md)
- [Conceptos de Git para la documentación](/docs/es/guides/git-concepts.md)