mintlify__docs/es/deploy/bitbucket.mdx

---
title: "Bitbucket Cloud"
description: "Conecta un repositorio de Bitbucket Cloud a Mintlify para despliegues automáticos, vistas previas de pull requests y sincronización continua."
keywords: ["Bitbucket Cloud", "conexión de repositorio", "OAuth", "despliegues automatizados"]
---

<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](/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>