GitLab MCP : connecter GitLab à Claude, Cursor et votre IA (guide 2026)

Publié le · Développement & SDK · 4 min de lecture

Par Amir N., éditeur de serveurmcp.com

GitLab MCP est le serveur MCP intégré à GitLab. Il donne à Claude, Cursor ou tout autre client MCP un accès sécurisé à vos projets, issues, merge requests et pipelines, directement via votre instance GitLab.

Accessible dès l’offre gratuite depuis GitLab 19.2, il passe en disponibilité générale avec GitLab 19.5. Ce guide détaille sa configuration, ses outils et l’alternative open source la plus utilisée.

GitLab MCP en bref

  • Éditeur : GitLab, serveur intégré au produit, sans rien à installer côté serveur.
  • Adresse : https://votre-instance/api/v4/mcp, soit https://gitlab.com/api/v4/mcp sur GitLab.com.
  • Connexion : OAuth avec enregistrement dynamique du client : l’outil d’IA s’enregistre lui-même auprès de GitLab.
  • Disponibilité : GitLab.com, Self-Managed et Dedicated, offres Free, Premium et Ultimate.

Prérequis

  • Sur GitLab Self-Managed et Dedicated, un administrateur doit d’abord autoriser l’accès au serveur MCP pour l’instance.
  • Les clients qui passent par le pont mcp-remote, comme Claude Desktop, demandent Node.js.

Installer GitLab MCP

GitLab recommande le transport HTTP, qui se connecte directement à l’instance sans dépendance supplémentaire.

Dans Claude Code

claude mcp add -s user --transport http GitLab https://gitlab.com/api/v4/mcp

Lancez ensuite /mcp pour vous connecter à GitLab dans le navigateur. Remplacez gitlab.com par l’adresse de votre instance si vous êtes en Self-Managed.

Dans Cursor

Ouvrez Settings, puis Cursor Settings, puis Tools & MCP, et ajoutez le serveur dans mcp.json :

{
  "mcpServers": {
    "GitLab": {
      "url": "https://gitlab.com/api/v4/mcp"
    }
  }
}

Enregistrez : la page d’autorisation OAuth s’ouvre dans votre navigateur. Sinon, redémarrez Cursor.

Dans Claude Desktop

Claude Desktop se connecte via le pont mcp-remote, à déclarer dans claude_desktop_config.json :

{
  "mcpServers": {
    "GitLab": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://gitlab.com/api/v4/mcp"]
    }
  }
}

Notre guide pour ajouter un serveur MCP à Claude détaille l’emplacement de ce fichier.

Choisir les groupes d’outils

GitLab regroupe ses outils par ensembles. Sans réglage, les groupes par défaut sont actifs :

Groupe Actif par défaut
meta Toujours
core Oui
merge_requests Oui
work_items Oui
repository Oui
ci Oui
duo_agent_platform Oui
wikis Non, à activer
code_security Non, à activer

Pour restreindre la liste, envoyez l’en-tête X-Gitlab-Enabled-Mcp-Server-Toolsets, ou la valeur all pour tout activer. Exemple dans Claude Code :

claude mcp add -s user --transport http GitLab https://gitlab.com/api/v4/mcp --header "X-Gitlab-Enabled-Mcp-Server-Toolsets: core,work_items"

L’en-tête X-Gitlab-Enabled-Mcp-Server-Tools ajoute des outils précis : GitLab renvoie alors l’union des deux listes.

Ce que GitLab MCP sait faire

  • Explorer : lire un projet avec get_project, ou chercher dans l’instance avec search.
  • Contribuer : committer un lot de modifications de fichiers avec add_commit.
  • Relire et livrer : créer ou mettre à jour une merge request avec save_merge_request.
  • Suivre le travail : lire et enregistrer des issues et autres éléments de travail avec get_work_item et save_work_item.

Quelques demandes types : « Résume les issues ouvertes de ce projet par priorité », « Pourquoi le dernier pipeline a-t-il échoué ? » ou « Ouvre une merge request pour cette branche, avec une description des changements ».

L’alternative open source : @zereight/mcp-gitlab

Avec environ 2 000 étoiles sur GitHub, @zereight/mcp-gitlab est le serveur communautaire le plus utilisé. Il fonctionne avec un jeton d’accès personnel ou OAuth, et convient aux instances plus anciennes, sans serveur MCP intégré.

{
  "mcpServers": {
    "gitlab": {
      "command": "npx",
      "args": ["-y", "@zereight/mcp-gitlab"],
      "env": {
        "GITLAB_PERSONAL_ACCESS_TOKEN": "votre_jeton",
        "GITLAB_API_URL": "https://gitlab.com/api/v4"
      }
    }
  }
}

Le mode lecture seule s’active avec l’option --permission-mode=readonly, et la variable GITLAB_TOOLSETS choisit les groupes d’outils.

Sécurité

  • Avec le serveur intégré, chaque outil d’IA s’enregistre comme application OAuth : vous pouvez révoquer son accès depuis GitLab à tout moment.
  • N’activez que les groupes d’outils utiles, surtout ceux qui écrivent dans vos dépôts.
  • Avec un jeton personnel, préférez la portée read_api quand la lecture suffit, et ne le placez jamais dans un fichier commité.
  • Relisez chaque commit et chaque merge request proposés par l’assistant avant de les valider.

Notre checklist de sécurité MCP complète ces règles.

Questions fréquentes

GitLab propose-t-il un serveur MCP officiel ?

Oui. Il est intégré à GitLab et répond à l’adresse https://votre-instance/api/v4/mcp.

GitLab MCP est-il gratuit ?

Oui. Depuis GitLab 19.2, il est disponible dans les offres Free, Premium et Ultimate.

Comment ajouter GitLab MCP à Claude Code ?

Avec claude mcp add -s user --transport http GitLab https://gitlab.com/api/v4/mcp, puis /mcp pour vous connecter.

GitLab MCP fonctionne-t-il avec GitLab Self-Managed ?

Oui, une fois que l’administrateur a autorisé l’accès au serveur MCP pour l’instance.

Quelle alternative pour une ancienne version de GitLab ?

Le serveur open source @zereight/mcp-gitlab, avec un jeton d’accès personnel ou OAuth.

Sources

D’autres serveurs sont classés par usage dans notre sélection 2026.

Recevez gratuitement le guide complet du MCP

Une newsletter simple, sans spam. Désinscription en un clic.