mintlify__docs/es/deploy/gitlab.mdx

---
title: "GitLab"
description: "Conecta tu repositorio de GitLab a Mintlify para despliegues automáticos, vistas previas de merge requests y sincronización continua."
keywords: ["Integración con GitLab", "tokens de acceso", "vistas previas de merge request", "autoalojado", "instancia"]
---

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
</div>

<Steps>
  <Step title="Find your project ID">
    En tu proyecto de GitLab, ve a **Settings** > **General** y ubica tu **Project ID**.
    <Frame>
      <img src="/images/gitlab/gitlab-project-id.png" 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="/images/gitlab/gitlab-project-access-token.png" 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="Set up the connection">
    En el [Dashboard de Mintlify](https://dashboard.mintlify.com/settings/deployment/git-settings):
    1. Ingresa tu Project ID y el access token.
    2. Si tienes un monorepo y tu documentación no está en la raíz de tu repositorio, activa el toggle **Set up as monorepo** e ingresa la ruta relativa al directorio de tu documentación.
    3. Si usas una instancia autoalojada de GitLab, activa la opción **Set up as self-hosted** e ingresa la URL del host de tu instancia de GitLab (por ejemplo, `https://gitlab.your-domain.com`). Tu instancia debe ser accesible públicamente para que Mintlify pueda conectarse.
    4. Selecciona la rama desde la cual desplegar tu documentación.
    5. Haz clic en **Save Changes**.
    <Frame>
      <img src="/images/gitlab/gitlab-config-light.png" alt="El panel de configuración de GitLab en la página Git Settings del Dashboard de Mintlify." className="block dark:hidden" />
      <img src="/images/gitlab/gitlab-config-dark.png" 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="create-the-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="/images/gitlab/gitlab-webhook.png" 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="/images/gitlab/show-webtoken-light.png" alt="Captura de pantalla de la conexión de GitLab en el Dashboard de Mintlify." className="block dark:hidden" />
      <img src="/images/gitlab/show-webtoken-dark.png" 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="/images/gitlab/gitlab-project-webtoken.png" 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="/images/gitlab/gitlab-project-webtoken-test.png" 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>