Connecter GitLab (MCP)
GitLab embarque un serveur MCP officiel directement dans son instance, sans passerelle tierce nécessaire. Ce tutoriel montre comment le connecter à Mammouth en tant que connecteur MCP personnalisé, pour chacune des trois méthodes d'authentification.
Avant de commencer
Côté GitLab, il vous faut :
- GitLab 18.6 ou supérieur (le serveur MCP est en Beta, disponible sur l'offre Free)
- GitLab Duo réglé sur Always on ou On by default
- Les fonctionnalités Beta et expérimentales activées — au niveau de l'instance sur Self-Managed/Dedicated, ou pour le groupe de plus haut niveau sur GitLab.com
- L'accès au serveur MCP autorisé — au niveau de l'instance sur Self-Managed/Dedicated, ou pour le groupe de plus haut niveau sur GitLab.com
Consultez la documentation du serveur MCP GitLab pour savoir comment activer ces options.
URL du serveur
Utilisez https://<votre-instance-gitlab>/api/v4/mcp sur Self-Managed ou Dedicated, ou https://gitlab.com/api/v4/mcp sur GitLab.com. C'est la même URL pour les trois méthodes de connexion ci-dessous.
Connexion automatique (OAuth)
Le serveur MCP de GitLab supporte l'enregistrement dynamique de client OAuth 2.0 : la connexion automatique fonctionne donc sans rien configurer côté GitLab.
- Dans Mammouth, ajoutez un connecteur MCP personnalisé avec l'URL de serveur ci-dessus.
- Choisissez Connexion automatique.
- Cliquez sur Connecter. Mammouth s'enregistre auprès de GitLab et ouvre la fenêtre d'autorisation — connectez-vous et approuvez l'accès.
Clé API
Le serveur MCP de GitLab ne supporte aujourd'hui que l'OAuth : il n'accepte pas de clé API statique ni de personal access token comme identifiant (GitLab suit le support des PAT comme demande de fonctionnalité, pas encore livrée). Utilisez plutôt la connexion automatique ou la connexion manuelle.
Connexion manuelle (ID client et secret)
Nécessite GitLab 19.3 ou supérieur — les versions antérieures n'exposent pas le scope mcp dans le formulaire de création d'application OAuth.
Utilisez cette méthode si l'enregistrement dynamique de client est désactivé sur votre instance GitLab, ou si vous préférez enregistrer une seule application OAuth partagée pour toute votre équipe plutôt que de laisser chaque compte Mammouth enregistrer la sienne.
- Dans GitLab, créez une application OAuth :
- Niveau utilisateur : votre avatar → Edit profile → Access → Applications → Add new application
- Niveau groupe : Settings → Applications du groupe
- Niveau instance (administrateurs Self-Managed) : Admin Area → Applications → New application
- Réglez le Redirect URI sur celui affiché dans le formulaire de connexion manuelle de Mammouth.
- Dans Scopes, sélectionnez mcp.
- Décochez la case Confidential — la connexion manuelle de Mammouth n'envoie aucun secret client, l'application doit donc être enregistrée comme client public.
- Enregistrez l'application et copiez son Application ID.
- Dans Mammouth, choisissez Connexion manuelle, collez cet ID comme ID client, et laissez le secret client vide.
WARNING
Une application OAuth partagée unique ne peut pas servir des clients MCP utilisant des URI de redirection différentes. Si l'URI de redirection de Mammouth change un jour, il faudra mettre à jour l'application dans GitLab.