# GitLab (/es/deploy/gitlab)

<!-- agent-signals: reading_time_min: 5 · est_tokens: 1883 · updated: 2026-07-30 -->

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

* Mintlify usa tokens de acceso para extraer información de GitLab.
* GitLab usa webhooks para notificar a Mintlify cuando realizas cambios, lo que habilita implementaciones de vista previa para las merge requests.

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

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

<Steps>
  <Step title="Select GitLab as your provider">
    En la página de [Git Settings](https://app.mintlify.com/settings/deployment/git-settings), selecciona **Connect to GitLab** y haz clic en **Continue**.
  </Step>

  <Step title="Download your content">
    <Tip>
      Si ya tienes un repositorio de GitLab con tu documentación, puedes omitir la descarga y hacer clic en **Continue setup** directamente.
    </Tip>

    Si tu documentación está alojada en Mintlify, descárgala como un archivo zip.

    * Crea un nuevo repositorio en GitLab.
    * Extrae el contenido del zip.
    * Sube el contenido a tu repositorio.

    Haz clic en **Continue setup** para continuar.
  </Step>

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

    <Frame>
      <img src="/_assets/bb826ce16241f19d1ddc499f4b5fc82278e2567a3a38200e43e60f87899b2187" alt="La página General Settings en el dashboard de GitLab. El Project ID está destacado." />
    </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 repos privados)
    * **Scopes**: `api` y `read_api`

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

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

    <Frame>
      <img src="/_assets/f6d06d9e88e7fab6ae076e532d8856ced528e236d2537adf9fbd8bf2cc056477" alt="La página Access tokens en el dashboard de GitLab. Los parámetros a configurar para Mintlify están destacados." />
    </Frame>
  </Step>

  <Step title="Connect your repository">
    De vuelta en el asistente de configuración, completa los siguientes campos:

    * **GitLab instance URL**: Déjalo en blanco para `gitlab.com`, o ingresa la URL de tu instancia autoalojada (por ejemplo, `https://gitlab.your-domain.com`). Tu instancia debe ser accesible públicamente para que Mintlify pueda conectarse.
    * **Project ID**: El ID del proyecto de la configuración de tu proyecto de GitLab.
    * **GitLab deployment token**: El token de acceso que generaste.
    * **Branch**: Selecciona la rama desde la cual desplegar tu documentación.

    Haz clic en **Connect**.

    <Frame>
      <img src="/_assets/e692151369f14271f818eab32938733c6dacb4d1294956400454d0f9465cf537" alt="El panel de configuración de GitLab en la página Git Settings del Dashboard de Mintlify." className="block dark:hidden" />

      <img src="/_assets/c289e2dbc4fb9b0f76602dd21ea9533ae4f8dffcbed460b26b86f28b8cccb02c" alt="El panel de configuración de GitLab en la página Git Settings del Dashboard de Mintlify." className="hidden dark:block" />
    </Frame>
  </Step>
</Steps>

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

Para modificar la configuración de tu conexión con GitLab después de la configuración inicial, ve a [Git Settings](https://app.mintlify.com/settings/deployment/git-settings) y actualiza tu ID de proyecto, token de acceso, rama o URL de instancia directamente.

<div id="create-the-webhook">
  ## Volver a validar la configuración de Git [#volver-a-validar-la-configuración-de-git]

  Si tu despliegue muestra un comportamiento inesperado, como opciones de rama faltantes o una configuración desactualizada, puedes forzar a Mintlify a actualizar tu origen de Git.

  <Steps>
    <Step title="Ir a Git Settings">
      Ve a [Git Settings](https://app.mintlify.com/settings/deployment/git-settings) en tu Dashboard.
    </Step>

    <Step title="Volver a validar la configuración">
      Haz clic en la insignia verde **Active** en la esquina del recuadro de configuración de GitLab para volver a validar tu origen de Git. Un toast de éxito confirma cuando se completa la revalidación, y aparece un toast de error si tu configuración necesita revisión.
    </Step>
  </Steps>

  ## Crear el webhook [#crear-el-webhook]
</div>

Los webhooks notifican a Mintlify cuando envías cambios, para que las implementaciones se activen automáticamente.

<Steps>
  <Step title="Agregar nuevo webhook">
    1. En GitLab, ve a **Settings** > **Webhooks**.
    2. Haz clic en **Add new webhook**.

    <Frame>
      <img src="/_assets/0e4ee3d9ee09b3a73c8c65d831bbdd945cf3b468f6948c5d1c8f2d5060c8f0ae" alt="Captura de pantalla de la página de Webhooks en el dashboard de GitLab." />
    </Frame>
  </Step>

  <Step title="Configurar la URL y el webhook">
    Asigna al webhook el nombre **Mintlify**.

    En el campo **URL**, introduce el endpoint `https://leaves.mintlify.com/gitlab-webhook`.
  </Step>

  <Step title="Obtener el webtoken">
    En tu Dashboard de Mintlify, haz clic en **Show Webtoken**. Copia el webtoken.

    <Frame>
      <img src="/_assets/abf6566843c168dbd23aed587f44ab8fcd9f0da83bb56888073fadae3de95463" alt="Captura de pantalla de la conexión de GitLab en el Dashboard de Mintlify." className="block dark:hidden" />

      <img src="/_assets/8ee3868d172d45ee30cef080d04431979c6b5d660f552915022cb03d0546af8a" alt="Captura de pantalla de la conexión de GitLab en el Dashboard de Mintlify." className="hidden dark:block" />
    </Frame>
  </Step>

  <Step title="Pegar el webtoken">
    En GitLab, pega el webtoken desde tu Dashboard de Mintlify en el campo **Secret token**.
  </Step>

  <Step title="Seleccionar eventos">
    Selecciona los siguientes eventos para activar el webhook:

    * **Push events** (All branches)
    * **Merge requests events**
  </Step>

  <Step title="Verificar el webhook">
    Deberías ver la siguiente configuración después de configurar el webhook:

    * **Name**: Mintlify
    * **URL**: `https://leaves.mintlify.com/gitlab-webhook`
    * **Secret token**: el webtoken de tu Dashboard de Mintlify
    * **Events**: **Push events** (All branches) y **Merge requests events**

    Añade el webhook.

    <Frame>
      <img src="/_assets/492254d1ca23ea8f27591b7ee98a8a3ef3104f844029cecc6f1e992b9b75a30f" alt="La página de Webhooks en el dashboard de GitLab. La configuración que se debe establecer para Mintlify está resaltada." />
    </Frame>
  </Step>

  <Step title="Probar el webhook">
    Después de crear el webhook, haz clic en el menú desplegable **Test**. Haz clic en **Push events** para enviar un payload de prueba. Si la prueba devuelve `Hook executed successfully: HTTP 200`, configuraste el webhook correctamente.

    <Frame>
      <img src="/_assets/748a9164b8483a9bc811a0173638a0e62269da2fe1b72419fe519a5d306b02a6" alt="Captura de pantalla de la página de Webhooks de GitLab. El elemento de menú 'Push events' está resaltado en el menú 'Test'." />
    </Frame>
  </Step>
</Steps>