> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify-mintlify-add-letter-a-quickstart-82277.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# GitLab

> Sincroniza tu documentación con un repositorio de GitLab

Usamos tokens de acceso y webhooks para autenticar y sincronizar cambios entre GitLab y Mintlify.

* Mintlify usa tokens de acceso para obtener información de GitLab.
* GitLab usa webhooks para notificar a Mintlify cuando se realizan cambios, lo que habilita implementaciones de vista previa para las solicitudes de merge.

<div id="set-up-the-connection">
  ## Configura la conexión
</div>

<Note>
  **Se requiere clonación por HTTPS**: Tu proyecto de GitLab debe tener habilitada la clonación por HTTPS para que Mintlify pueda acceder a tu repositorio. Puedes verificarlo en GitLab yendo a **Settings** > **General** > **Visibility and access controls**.
</Note>

<Steps>
  <Step title="Find your project ID">
    En tu proyecto de GitLab, ve a **Settings** > **General** y localiza tu **Project ID**.

    <Frame>
      <img src="https://mintcdn.com/mintlify-mintlify-add-letter-a-quickstart-82277/KpF2ReOhVBN5TEvd/images/gitlab/gitlab-project-id.png?fit=max&auto=format&n=KpF2ReOhVBN5TEvd&q=85&s=2ed7a0ff7eb063389b1fcabe607ba3bc" alt="La página General Settings en el dashboard de GitLab. El Project ID está resaltado." width="950" height="775" data-path="images/gitlab/gitlab-project-id.png" />
    </Frame>
  </Step>

  <Step title="Generate an access token">
    Ve a **Settings** > **Access Tokens** y selecciona **Add new token**.

    Configura el token con estos parámetros:

    * **Name**: Mintlify
    * **Role**: Maintainer (obligatorio para repositorios privados)
    * **Scopes**: `api` y `read_api`

    Haz clic en **Create project access token** y copia el token.

    <Note>
      Si Project Access Tokens no está disponible, puedes usar un Personal Access Token. Ten en cuenta que los Personal Access Tokens caducan y deben actualizarse.
    </Note>

    <Frame>
      <img src="https://mintcdn.com/mintlify-mintlify-add-letter-a-quickstart-82277/KpF2ReOhVBN5TEvd/images/gitlab/gitlab-project-access-token.png?fit=max&auto=format&n=KpF2ReOhVBN5TEvd&q=85&s=35f6f8699b4b0f5c53691c84aa375f24" alt="La página Access tokens en el dashboard de GitLab. Están resaltados los parámetros que configurar para Mintlify." width="1166" height="904" data-path="images/gitlab/gitlab-project-access-token.png" />
    </Frame>
  </Step>

  <Step title="Set up the connection">
    En el [Dashboard de Mintlify](https://dashboard.mintlify.com/settings/deployment/git-settings):

    1. Ingresa tu Project ID y access token.
    2. Completa cualquier otra configuración obligatoria.
    3. Haz clic en **Guardar cambios**.

    <Frame>
      <img src="https://mintcdn.com/mintlify-mintlify-add-letter-a-quickstart-82277/KpF2ReOhVBN5TEvd/images/gitlab/gitlab-config.png?fit=max&auto=format&n=KpF2ReOhVBN5TEvd&q=85&s=d9be34d1933139776a37072d757e1cff" alt="La página Git Settings en el Dashboard de Mintlify. Están resaltadas las configuraciones de GitLab." width="2994" height="1704" data-path="images/gitlab/gitlab-config.png" />
    </Frame>
  </Step>
</Steps>

<div id="create-the-webhook">
  ## Crear el webhook
</div>

Los webhooks nos permiten recibir eventos cuando se realizan cambios para así
activar implementaciones automáticamente.

<Steps>
  <Step title="Ve a Settings > Webhooks y haz clic en 'Add new Webhook'">
    <Frame>
      <img src="https://mintcdn.com/mintlify-mintlify-add-letter-a-quickstart-82277/KpF2ReOhVBN5TEvd/images/gitlab/gitlab-webhook.png?fit=max&auto=format&n=KpF2ReOhVBN5TEvd&q=85&s=9937dc5ed02d4144f17f27addab70955" width="3014" height="1704" data-path="images/gitlab/gitlab-webhook.png" />
    </Frame>
  </Step>

  <Step title="Configura la URL y el webhook">
    En el campo "URL", introduce el endpoint `https://leaves.mintlify.com/gitlab-webhook` y nombra el webhook "Mintlify".
  </Step>

  <Step title="Pega el token">
    Pega el token del webhook generado después de configurar la conexión.

    <Frame>
      <img src="https://mintcdn.com/mintlify-mintlify-add-letter-a-quickstart-82277/KpF2ReOhVBN5TEvd/images/gitlab/gitlab-show-webtoken.png?fit=max&auto=format&n=KpF2ReOhVBN5TEvd&q=85&s=2e9040afc785c0d662b1d90836b72b32" width="555" height="527" data-path="images/gitlab/gitlab-show-webtoken.png" />
    </Frame>
  </Step>

  <Step title="Selecciona eventos">
    Selecciona estos eventos para activar el webhook:

    * **Push events** (All branches)
    * **Merge requests events**

    Cuando termines, debería verse así:

    <Frame>
      <img src="https://mintcdn.com/mintlify-mintlify-add-letter-a-quickstart-82277/KpF2ReOhVBN5TEvd/images/gitlab/gitlab-project-webtoken.png?fit=max&auto=format&n=KpF2ReOhVBN5TEvd&q=85&s=b6b282420acbe4229e24dfa94fef89a9" alt="La página de Webhooks en el dashboard de GitLab. Están resaltados los ajustes que se deben configurar para Mintlify." width="1161" height="1740" data-path="images/gitlab/gitlab-project-webtoken.png" />
    </Frame>
  </Step>

  <Step title="Prueba el webhook">
    Después de crear el webhook, haz clic en el menú desplegable "Test" y selecciona "Push events" para enviar un payload de prueba y comprobar que está configurado correctamente. Verás "Hook executed successfully: HTTP 200" si está configurado correctamente.

    Esto te ayudará a verificar que todo funciona bien y que tu documentación se sincronizará correctamente con tu repositorio de GitLab.

    <Frame>
      <img src="https://mintcdn.com/mintlify-mintlify-add-letter-a-quickstart-82277/KpF2ReOhVBN5TEvd/images/gitlab/gitlab-project-webtoken-test.png?fit=max&auto=format&n=KpF2ReOhVBN5TEvd&q=85&s=4a45be0e7dcb17bdf9214e6faf000cf2" width="1161" height="724" data-path="images/gitlab/gitlab-project-webtoken-test.png" />
    </Frame>
  </Step>
</Steps>