Intégrer le Model Context Protocol

Bienvenue dans la partie 7 de notre guide en huit parties, Démarrer avec GitLab Duo Agent Platform, où vous apprendrez à maîtriser la création et le déploiement d'agents d'IA et de workflows au sein de votre cycle de vie de développement. Suivez des tutoriels qui vous guideront de votre première interaction jusqu'à la mise en place de workflows d'automatisation entièrement personnalisés et prêts pour la mise en production.

L'intelligence artificielle (IA) accélère le développement : elle génère du code, débogue et automatise les tâches répétitives. Cependant, seule, elle reste limitée à ses données d'entraînement ou aux sources publiques, alors que les équipes de développement doivent souvent utiliser des systèmes internes : suivi de projet, tableaux de bord, bases de données, fichiers de design dans Figma ou documents Google Drive.

Désormais intégré à GitLab Duo Agent Platform, le Model Context Protocol (MCP) permet à l'IA d'accéder en toute sécurité aux services internes pour que les équipes de développement bénéficient d'une assistance complète, directement accessibles dans les workflows.

🎯 Essayez GitLab Duo Agent Platform dès aujourd'hui !

Qu'est-ce que le MCP ?

Introduit pour la première fois par Anthropic en 2024, le MCP est une norme ouverte qui connecte l'IA aux données et aux outils. Il fonctionne comme un canal bidirectionnel sécurisé : les clients MCP (applications d'IA, agents d'IA autonomes ou outils de développement) envoient des requêtes de données ou d'actions, tandis que les serveurs MCP répondent avec des informations fiables et autorisées issues de leurs sources de données connectées.

Les serveurs MCP agissent comme des passerelles sécurisées vers divers systèmes : ils peuvent se connecter à des bases de données, des API, des systèmes de fichiers, des services cloud ou tout autre service externe pour collecter et transmettre des données. Les outils et agents d'IA, lorsqu'ils utilisent le MCP, ne se limitent plus aux informations sur lesquelles ils ont été entraînés. Ils peuvent accéder à des informations en temps réel et exécuter des actions concrètes (par exemple, reprogrammer des réunions ou vérifier la disponibilité dans un calendrier), tout en garantissant des contrôles rigoureux en matière de sécurité, de confidentialité et d'audit.

Exemples de MCP orientés développement

Les équipes de développement profitent de fonctionnalités puissantes lorsqu'elles connectent le MCP à leurs outils et workflows de développement. Voici des exemples pratiques des possibilités de l'IA avec les serveurs MCP dans un contexte de développement :

• Examiner les tickets ouverts et créer des merge requests
• Récupérer les logs de déploiement et les traces d'erreur
• Consulter les messages d'équipe dans Slack concernant les décisions techniques
• Reprogrammer des réunions ou vérifier la disponibilité dans le calendrier pour la coordination d'équipe

Ces capacités orientées développement permettent à l'IA de fournir une assistance significative directement au sein des workflows des équipes, sans nécessiter de changement de contexte entre les outils.

Pourquoi utiliser le MCP ?

Vous vous demandez peut-être : pourquoi utiliser le MCP si l'IA peut déjà appeler directement les API des systèmes ? Le passage par le MCP s'impose, car chaque API possède ses propres mécanismes d'authentification, formats de données et comportements. L'IA devrait donc recourir à des connecteurs spécifiques pour chaque système et les mettre à jour en permanence à mesure que les API évoluent, ce qui rendrait les intégrations directes complexes et propices aux erreurs. Le MCP résout ce problème : il offre une interface standardisée et sécurisée qui gère automatiquement l'authentification, les autorisations et la conversion des données. Les outils d'IA peuvent ainsi se connecter de manière cohérente à n'importe quel système, avec des intégrations rapides, stables et fiables.

Prise en charge du MCP par GitLab

Avec l'intégration du MCP, GitLab Duo Agentic Chat franchit une nouvelle étape : l'IA n'est plus isolée, mais pleinement connectée aux outils que les équipes de développement utilisent quotidiennement. Ces dernières peuvent interagir en langage naturel avec l'ensemble de leurs outils, sans jamais quitter leur environnement de développement intégré (IDE) favori. GitLab Duo Agent Platform leur apporte une assistance complète sans casser leur rythme ni perturber leur concentration.

GitLab offre une prise en charge complète du MCP par le biais de deux workflows complémentaires :

• Workflow client MCP : GitLab Duo Agent Platform sert de client MCP et permet à ses fonctionnalités d'accéder à divers outils et services externes.
• Workflow serveur MCP : GitLab agit aussi comme serveur MCP. Des outils d'IA comme Claude Desktop, Cursor et d'autres applications compatibles peuvent ainsi se connecter en toute sécurité à votre instance GitLab.

Démonstration interactive du workflow client MCP

Imaginez un lundi matin classique : le service de paiement de votre entreprise renvoie soudainement des erreurs de délai d'attente dépassé. Les clients ne peuvent plus finaliser leurs achats, et vous devez rapidement en trouver la cause. En temps normal, vous ouvrez Jira pour consulter le ticket d'incident, vous parcourez Slack à la recherche de mises à jour, puis vous vérifiez les tableaux de bord Grafana pour repérer d'éventuels pics d'erreurs. Grâce à la prise en charge du MCP dans GitLab, vous pouvez désormais effectuer toutes ces actions, directement depuis le chat intégré à votre IDE. Le MCP met en corrélation les données de tous vos systèmes et vous offre instantanément une vue d'ensemble, sans que vous deviez quitter votre workflow de développement.

Pour découvrir cette fonctionnalité par vous-même, nous avons créé une démonstration interactive qui reproduit le scénario du service de paiement décrit ci-dessus. Cliquez sur l'image ci-dessous pour lancer la démo.

Configuration du client MCP dans GitLab

Pour commencer à poser des questions dans GitLab Duo Agentic Chat ou le flow Software Development, vous devez configurer le MCP dans votre environnement de développement. Voici comment procéder :

• Activer l'aperçu des fonctionnalités : dans les paramètres de votre groupe, accédez à GitLab Duo dans la barre latérale gauche, puis cochez la case « Activer les fonctionnalités expérimentales et bêta de GitLab Duo » dans la section Aperçu des fonctionnalités.
• Activer le MCP pour votre groupe : activez la prise en charge du MCP dans les paramètres de votre groupe GitLab pour que les fonctionnalités de GitLab Duo puissent se connecter à des systèmes externes.
• Configurer les serveurs MCP : définissez les serveurs MCP au format JSON dans le fichier mcp.json. Créez ce fichier à cet emplacement :
• Windows : C:\Users\<username>\AppData\Roaming\GitLab\duo\mcp.json
• Autres systèmes d'exploitation : ~/.gitlab/duo/mcp.json

Pour des configurations spécifiques à un workspace, consultez la section Configuration du workspace.

      {
  "mcpServers": {
    "server-name": {
      "type": "stdio",
      "command": "path/to/server",
      "args": ["--arg1", "value1"],
      "env": {
        "ENV_VAR": "value"
      }
    },
    "http-server": {
      "type": "http",
      "url": "http://localhost:3000/mcp"
    },
    "sse-server": {
      "type": "sse",
      "url": "http://localhost:3000/mcp/sse"
    }
  }
}

    

• Installer et configurer votre IDE : assurez-vous que VSCodium ou Visual Studio Code est installé, ainsi que l'extension GitLab Workflow (version 6.28.2 ou ultérieure pour une prise en charge de base du MCP, version 6.35.6 ou ultérieure pour une prise en charge complète).

Pour des instructions détaillées étape par étape, des exemples de configuration et des conseils de dépannage, consultez la documentation sur les clients MCP de GitLab.

Exemple de projet

En complément de cette démonstration, nous partageons le projet qui a servi de base. Ce projet vous permet de reproduire le même flow dans votre propre environnement et d'expérimenter concrètement les capacités du MCP de GitLab.

Ce projet illustre le fonctionnement du MCP dans une configuration d'entreprise simulée, à l'aide de données fictives provenant de Jira, Slack et Grafana pour modéliser un scénario de réponse aux incidents. Le fichier mcp.json inclus montre comment se connecter à un serveur MCP local (enterprise-data-v2) ou, en option, comment étendre cette configuration aux services AWS pour une intégration cloud.

      {
  "mcpServers": {
    "enterprise-data-v2": {
      "type": "stdio",
      "command": "node",
      "args": ["src/server.js"],
      "cwd": "/path/to/your/project"
    },
    "aws-knowledge": {
      "type": "stdio"
      "command": "npx",
      "args": ["mcp-remote", "https://knowledge-mcp.global.api.aws"]
    },
    "aws-console": {
      "type": "stdio"
      "command": "npx",
      "args": ["@imazhar101/mcp-aws-server"],
      "env": {
        "AWS_REGION": "YOUR_REGION",
        "AWS_PROFILE": "default"
      }
    }
  }
}

    

Remarque de sécurité : le composant aws-console utilise un paquet de serveur MCP développé par la communauté (@imazhar101/mcp-aws-server) pour l'intégration avec AWS qui n'a pas été vérifié de manière indépendante. Il est exclusivement destiné à des fins de démonstration et de formation. Pour une utilisation en environnement de production, évaluez soigneusement les paquets ou privilégiez des solutions officielles.

En outre, configurez vos identifiants AWS à l'aide de profils d'interface de ligne de commande AWS (AWS CLI) ou de rôles Identity and Access Management (IAM), plutôt que de les coder en dur dans le fichier de configuration. Le SDK AWS détectera automatiquement les identifiants présents dans votre environnement, ce qui constitue l'approche recommandée pour garantir une bonne gouvernance et assurer la conformité aux politiques de sécurité de niveau entreprise.

Pour commencer, clonez le projet, installez les dépendances avec npm install, puis démarrez le serveur MCP local avec npm start. Créez un fichier ~/.gitlab/duo/mcp.json avec la configuration ci-dessus, mettez à jour le chemin d'accès du fichier pour qu'il corresponde à votre configuration locale et redémarrez VS Code pour charger la configuration MCP. Vous pouvez également ajouter vos identifiants AWS pour activer une intégration cloud en direct.

Clonez le projet ici : démo MCP de GitLab Duo.

Exemples de prompts à tester avec le projet de démonstration

Une fois le projet de démo configuré, vous pouvez commencer à explorer vos données et outils directement depuis GitLab Duo Agentic Chat dans votre IDE. Voici plusieurs prompts à tester :

• « À quels outils peux-tu accéder via le MCP ? »

• « Montre-moi des discussions Slack récentes concernant le problème avec la base de données. »

Capacités du serveur MCP de GitLab

Jusqu'à présent, nous avons vu comment GitLab Duo Agent Platform agit comme un client MCP, en se connectant à des serveurs MCP externes. Penchons-nous maintenant sur les capacités du serveur MCP de GitLab.

Le serveur MCP de GitLab permet à des outils d'IA comme Cursor ou Claude Desktop de se connecter en toute sécurité à votre instance GitLab et d'interagir avec vos données de développement en langage naturel. L'authentification repose sur le mécanisme d'enregistrement dynamique des clients OAuth 2.0, ce qui permet aux outils d'IA de s'enregistrer automatiquement et d'accéder à vos données GitLab avec les autorisations appropriées.

Actuellement, le serveur prend en charge les actions suivantes :

• Tickets : pour obtenir des informations ou créer de nouveaux tickets
• Merge requests : pour afficher les informations, les commits et les modifications de fichiers
• Pipelines : pour répertorier les jobs et les pipelines associés aux merge requests
• Informations sur le serveur : pour vérifier la version du serveur MCP

Pour obtenir la liste complète des outils et des fonctionnalités disponibles, consultez la documentation relative au serveur MCP.

Démonstration interactive du serveur MCP de GitLab

Découvrez le serveur MCP de GitLab grâce à notre démonstration interactive.

Elle vous guide pas à pas dans la configuration de Cursor avec le serveur MCP et l'utilisation de Cursor Chat pour vous connecter en toute sécurité à votre instance GitLab. Vous découvrirez comment afficher des tickets, en créer de nouveaux ou encore consulter les merge requests, le tout en langage naturel, sans jamais quitter votre environnement de développement.

Comment configurer le serveur MCP dans votre outil d'IA

Prérequis :

• Assurez-vous que Node.js et npm sont installés.
• Vérifiez que tout le monde peut accéder à npx en exécutant npx --version dans votre terminal.

1. Activer les feature flags
   • Activez mcp_server et oauth_dynamic_client_registration dans votre instance GitLab.
2. Ajouter la configuration du serveur MCP de GitLab à votre outil d'IA
   • Ajoutez l'entrée correspondant au serveur MCP au fichier de configuration de votre outil (mcp.json pour Cursor, claude_desktop_config.json pour Claude Desktop) :

      {
  "mcpServers": {
    "GitLab": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://<your-gitlab-instance>/api/v4/mcp",
        "--static-oauth-client-metadata",
        "{\"scope\": \"mcp\"}"
      ]
    }
  }
}

    

Enregistrement et authentification

Lors de la première connexion, l'outil d'IA va :

• S'enregistrer automatiquement en tant qu'application OAuth
• Demander l'autorisation pour la portée mcp

Autorisation dans le navigateur

Lors de la connexion, le client MCP ouvrira automatiquement votre navigateur par défaut pour finaliser le flux OAuth. Examinez et approuvez la requête d'accès dans GitLab afin d'autoriser la connexion et d'obtenir un token pour accéder à l'API de manière sécurisée.

Utilisation du serveur MCP

Dès que votre outil d'IA est connecté au serveur MCP, vous pouvez interagir avec vos données GitLab (tickets, merge requests, pipelines), directement depuis votre environnement de développement. Par exemple :

• Obtenir les informations du ticket 42 dans le projet 123
• Créer un nouveau ticket intitulé « Corriger le bug de connexion » avec une description concernant les caractères spéciaux des mots de passe
• Afficher tous les commits dans la merge request 15 du projet gitlab-org/gitlab
• Quels fichiers ont été modifiés dans la merge request 25 ?
• Afficher tous les jobs du pipeline 12345

Cette fonctionnalité est expérimentale, contrôlée par un feature flag et n'est pas encore destinée à une utilisation en production. Pour des instructions détaillées étape par étape, des exemples de configuration et des conseils de dépannage, consultez la documentation concernant le serveur MCP de GitLab.

Résumé

GitLab Duo Agent Platform prend en charge le MCP et offre des workflows de développement optimisés par l'IA avec intégration d'outils externes. Avec la prise en charge du MCP, GitLab agit à la fois comme un client et un serveur :

• Client MCP : GitLab Duo Agent Platform peut accéder en toute sécurité aux données et services de systèmes externes et apporte un contexte complet directement dans l'IDE.
• Serveur MCP : des outils d'IA externes comme Cursor ou Claude Desktop peuvent se connecter à votre instance GitLab, accéder aux données de projet et effectuer des actions, le tout dans un cadre sécurisé et conforme à vos politiques de confidentialité. Cette prise en charge bidirectionnelle réduit le changement de contexte, accélère les workflows de développement et permet à l'IA de fournir une assistance pertinente à travers l'ensemble de vos outils.

Perspectives

Vous maîtrisez désormais l'utilisation des agents, la création de flows, la découverte de solutions dans le catalogue d'IA, la gestion des workflows via la section Automatisation et l'extension des capacités avec le MCP. La dernière étape consiste à personnaliser GitLab Duo en fonction des besoins spécifiques de votre équipe. Pour ce faire, consultez la Partie 8, où vous apprendrez à créer des règles de chat personnalisées, à élaborer des prompts système efficaces, à configurer les outils des agents, à mettre en place des intégrations MCP et à adapter les flows aux workflows uniques de votre équipe.

Ressources

• Documentation relative aux clients MCP
• Documentation relative au serveur MCP
• Qu'est-ce que le Model Context Protocol ?
• GitLab Duo Agent Platform

Article suivant : Partie 8 : personnaliser GitLab Duo Agent Platform : règles de chat, prompts et workflows

Article précédent : Partie 6 : surveiller, gérer et automatiser les workflows d'IA