> ## Documentation Index > Fetch the complete documentation index at: https://wiki.another-horizon.eu/llms.txt > Use this file to discover all available pages before exploring further. # GitLab > Connectez un référentiel GitLab pour des déploiements automatisés et des prévisualisations de builds. Nous utilisons des jetons d’accès et des webhooks pour authentifier et synchroniser les changements entre GitLab et Mintlify. * Mintlify utilise des jetons d’accès pour récupérer des informations depuis GitLab. * GitLab utilise des webhooks pour avertir Mintlify lorsque des changements sont effectués, ce qui permet des déploiements de prévisualisation pour les merge requests.
## Configurer la connexion
**Clonage HTTPS requis** : votre projet GitLab doit avoir le clonage HTTPS activé pour que Mintlify puisse accéder à votre référentiel. Vous pouvez le vérifier dans GitLab en allant dans les **Settings** de votre projet > **General** > **Visibility and access controls**. Dans votre projet GitLab, accédez à **Settings** > **General** et repérez votre **Project ID**. La page General Settings dans le tableau de bord GitLab. Le Project ID est mis en évidence. Accédez à **Settings** > **Access Tokens** et sélectionnez **Add new token**. Configurez le jeton avec les paramètres suivants : * **Name** : Mintlify * **Role** : Maintainer (requis pour les référentiels privés) * **Scopes** : `api` et `read_api` Cliquez sur **Create project access token** et copiez le jeton. Si les Project Access Tokens ne sont pas disponibles, vous pouvez utiliser un Personal Access Token. Notez que les Personal Access Tokens expirent et doivent être renouvelés. La page Access Tokens dans le tableau de bord GitLab. Les paramètres à configurer pour Mintlify sont mis en évidence. Dans le [Tableau de bord Mintlify](https://dashboard.mintlify.com/settings/deployment/git-settings) : 1. Saisissez votre ID de projet et votre jeton d'accès. 2. Renseignez les autres configurations requises. 3. Cliquez sur **Enregistrer les modifications**. La page Git Settings dans le Tableau de bord Mintlify. Les paramètres de configuration GitLab sont mis en évidence.
## Créer le webhook
Les webhooks nous permettent de recevoir des événements lorsque des modifications sont effectuées, afin de déclencher automatiquement des déploiements. Capture d’écran de la page Webhooks dans le tableau de bord GitLab. Dans le champ « URL », saisissez l’endpoint `https://leaves.mintlify.com/gitlab-webhook` et nommez le webhook « Mintlify ». Collez le jeton de webhook généré après la configuration de la connexion. Capture d’écran de la connexion GitLab dans le Tableau de bord Mintlify. Le bouton Show Webtoken est mis en évidence. Sélectionnez ces événements pour déclencher le webhook : * **Push events** (toutes les branches) * **Merge requests events** Une fois terminé, cela devrait ressembler à ceci : La page Webhooks dans le tableau de bord GitLab. Les paramètres à configurer pour Mintlify sont mis en évidence. Après avoir créé le webhook, cliquez sur le menu déroulant « Test » et sélectionnez « Push events » pour envoyer une charge utile d’exemple et vérifier qu’il est correctement configuré. Un message « Hook executed successfully: HTTP 200 » s’affichera si tout est correctement configuré. Cela vous aidera à vérifier que tout fonctionne correctement et que votre documentation se synchronise correctement avec votre référentiel GitLab. Capture d’écran de la page GitLab Webhooks. L’élément de menu « Push events » est mis en évidence dans le menu « Test ».