Intégration MCP

Ce que vous allez apprendre

Vue d'ensemble de l'intégration Model Context Protocol (MCP) dans Verdent for VS Code, incluant la configuration, les paramètres et les options d'extensibilité.

Qu'est-ce que MCP (Model Context Protocol) ?

Model Context Protocol (MCP) est un système d'intégration qui étend les capacités de Verdent en le connectant à des outils, des sources de données et des services externes.

Concept fondamental : MCP permet à Verdent d'interagir avec des systèmes au-delà de son ensemble d'outils intégrés, permettant une intégration fluide avec :

• Des APIs externes et des services web
• Des systèmes de bases de données
• Des plateformes cloud (AWS, Azure, GCP)
• Des outils de gestion de projet
• Des pipelines CI/CD
• Des outils internes personnalisés

Architecture : Les serveurs MCP agissent comme des ponts entre Verdent et les systèmes externes. Chaque serveur MCP expose des capacités spécifiques que Verdent peut invoquer pendant les sessions de développement, à l'image des outils intégrés comme file_read ou bash.

Stockage de la configuration : Les configurations des serveurs MCP sont stockées dans ~/.verdent/mcp.json et gérées via le menu des paramètres.

Avantages de l'intégration MCP

Capacités étendues

Accès aux systèmes externes : Connectez Verdent à des outils et services indisponibles via les fonctionnalités intégrées. Interrogez des bases de données, interagissez avec des services cloud ou intégrez des APIs spécifiques à un projet sans quitter votre flux de travail de développement.

Développement d'outils personnalisés : Créez des serveurs MCP adaptés aux exigences propres à votre projet. Construisez des intégrations spécialisées pour des outils internes, des APIs propriétaires ou des systèmes spécifiques à un domaine.

Interopérabilité

Effet de levier de l'écosystème : Exploitez l'écosystème MCP en pleine croissance. Les serveurs MCP développés par la communauté offrent des intégrations prêtes à l'emploi pour des outils et services populaires.

Protocole standardisé : MCP fournit une interface cohérente pour l'intégration d'outils, garantissant que les nouvelles capacités s'intègrent harmonieusement au système d'outils existant de Verdent.

Automatisation des flux de travail

Intégration fluide : Les serveurs MCP font désormais partie de l'ensemble d'outils de Verdent. L'agent utilise automatiquement les outils MCP lorsque c'est approprié, ou vous pouvez les invoquer explicitement pour des tâches spécifiques.

Opérations contextuelles : Les intégrations MCP comprennent le contexte de votre base de code, permettant des interactions intelligentes avec les systèmes externes en fonction de l'état actuel du développement.

Configuration des serveurs MCP

Processus de configuration

Accéder aux paramètres MCP :

1. Ouvrez le menu des paramètres dans Verdent
2. Accédez à la section Serveurs MCP
3. Consultez ou modifiez la configuration de ~/.verdent/mcp.json

Fichier de configuration : Les serveurs MCP sont configurés via le fichier ~/.verdent/mcp.json, qui définit les connexions au serveur, l'authentification et les paramètres d'intégration.

Gestion de la configuration

Ajout de serveurs : Configurez de nouveaux serveurs MCP en ajoutant des entrées à mcp.json avec les détails de connexion et les identifiants d'authentification.

Serveurs multiples : Verdent prend en charge plusieurs serveurs MCP simultanés, permettant l'intégration de plusieurs systèmes externes en même temps.

Test des connexions : Validez les configurations des serveurs MCP pour garantir des connexions réussies avant de les utiliser dans vos flux de travail de développement.

Plugins et extensions MCP

Plugins disponibles

Les plugins MCP offrent des intégrations prêtes à l'emploi pour des outils et services courants.

Catégories de plugins attendues :

• Intégrations de bases de données : outils de requête PostgreSQL, MySQL, MongoDB
• Services cloud : interactions API AWS, Azure, GCP
• Outils de développement : intégrations GitHub, GitLab, Jira, Linear
• Plateformes CI/CD : Jenkins, GitHub Actions, CircleCI
• Services de supervision : Datadog, New Relic, Sentry
• Communication : notifications Slack, Discord, Microsoft Teams

Installation des plugins

Méthodes d'installation : Les plugins sont installés et configurés via l'interface des paramètres MCP, nécessitant généralement :

• Un identifiant ou une source de plugin
• Des paramètres de configuration
• Des identifiants d'authentification (le cas échéant)

Gestion des dépendances : Les plugins MCP peuvent avoir des dépendances vis-à-vis de services ou de bibliothèques externes. Les processus d'installation gèrent automatiquement la résolution des dépendances lorsque cela est possible.

Développement de serveurs MCP personnalisés

Création de serveurs personnalisés

Les utilisateurs avancés peuvent créer des serveurs MCP personnalisés pour intégrer des outils propriétaires ou des systèmes spécifiques à un domaine.

Approche de développement : Les serveurs MCP personnalisés mettent en œuvre la spécification du protocole MCP, exposant des capacités d'outils que Verdent peut invoquer.

Cas d'usage pour les serveurs personnalisés :

• Intégration API interne : connexion aux APIs et services spécifiques à l'entreprise
• Ponts vers des systèmes existants : permettre à Verdent d'interagir avec une infrastructure existante
• Sources de données spécialisées : accès à des bases de données ou entrepôts de données propriétaires
• Automatisation des flux de travail : déclenchement de pipelines personnalisés de build, de déploiement ou de test

Modèles d'intégration

Configuration au niveau de l'espace de travail : Les serveurs MCP peuvent être configurés au niveau de l'espace de travail pour des intégrations spécifiques à un projet, permettant aux équipes de partager les configurations MCP via le contrôle de version.

Interopérabilité des outils : Les outils fournis par MCP s'intègrent parfaitement aux outils intégrés de Verdent (file_read, bash, spawn_subagent), permettant des flux de travail complexes combinant plusieurs types d'outils.

Exemples de flux de travail MCP

Intégration de requêtes de base de données

Scénario : interroger une base de données de production pour déboguer des problèmes de données.

Approche MCP :

User: "Check the orders table for customer ID 12345"
Verdent: [Uses MCP database server to execute safe read-only query]
        Results: 3 orders found for customer 12345
        [Displays formatted results]

Le serveur de base de données MCP gère l'authentification, la validation des requêtes et le formatage des résultats.

Interaction avec un service cloud

Scénario : vérifier les journaux d'une fonction AWS Lambda pour détecter des erreurs.

Approche MCP :

User: "Show me recent errors from the payment-processor Lambda function"
Verdent: [Invokes MCP AWS integration]
        [Retrieves CloudWatch logs for specified function]
        [Filters for ERROR level entries]
        [Presents formatted error summaries]

Le serveur AWS MCP gère l'authentification, les appels API et l'analyse des journaux.

Supervision de pipeline CI/CD

Scénario : vérifier le statut d'un build avant de déployer des modifications.

Approche MCP :

User: "Is the main branch build passing?"
Verdent: [Queries MCP CI/CD integration]
        Build #245: ✓ Passed (2 minutes ago)
        All tests passed, ready for deployment

Le serveur CI/CD MCP suit le statut du pipeline et fournit un retour en temps réel.

Considérations de sécurité

Authentification et autorisation

Gestion des identifiants : Les serveurs MCP gèrent l'authentification auprès des services externes. Les identifiants sont stockés de manière sécurisée dans la configuration MCP et ne sont jamais exposés dans l'historique des conversations ni dans le code.

Limitation des permissions : Configurez les serveurs MCP avec les permissions minimales nécessaires. Utilisez un accès en lecture seule lorsque c'est possible et restreignez les opérations destructrices.

Opérations sécurisées

Revue des commandes : Les opérations impliquant des outils MCP peuvent être passées en revue dans Manual Accept Mode avant leur exécution, offrant visibilité et contrôle.

Journalisation d'audit : Les opérations des serveurs MCP apparaissent dans l'historique des conversations de Verdent, créant une piste d'audit des interactions avec les systèmes externes.

Résolution des problèmes d'intégration MCP

Problèmes courants

Échecs de connexion :

• Vérifiez la connectivité réseau au serveur MCP
• Vérifiez les identifiants d'authentification dans mcp.json
• Assurez-vous que le serveur MCP est en cours d'exécution et accessible
• Validez la syntaxe du fichier de configuration

Erreurs de permissions :

• Confirmez que les clés ou identifiants API disposent des permissions requises
• Vérifiez les quotas de service ou les limites de débit
• Vérifiez que les règles de pare-feu autorisent le trafic MCP

Problèmes d'invocation d'outils :

• Assurez-vous que le serveur MCP expose correctement les outils attendus
• Vérifiez que les formats des paramètres d'outils correspondent aux attentes du serveur
• Consultez les journaux du serveur MCP pour connaître les détails des erreurs

Obtenir de l'aide

Canaux de support :

• Support Verdent : support@verdent.ai
• Documentation du protocole MCP
• Communauté Discord Verdent pour une assistance en temps réel

Informations de diagnostic : Lorsque vous signalez des problèmes MCP, fournissez :

• Le type et la version du serveur MCP
• Les détails de configuration (sans les identifiants)
• Les messages d'erreur de l'historique des conversations
• Les journaux du serveur MCP (si accessibles)

Ressources documentaires MCP

Documentation officielle

À venir :

• Des guides pas à pas pour la configuration des serveurs MCP
• Des tutoriels d'installation et de configuration de plugins
• Des tutoriels de développement de serveurs personnalisés
• Des bonnes pratiques pour l'intégration MCP
• L'optimisation des performances pour les flux de travail MCP

Ressources provisoires

Informations actuelles sur MCP :

• Spécification du protocole MCP (externe)
• Serveurs MCP et exemples développés par la communauté
• Dépôts GitHub de l'écosystème MCP

Contact pour plus de détails : Pour une assistance immédiate concernant l'intégration MCP, contactez support@verdent.ai en précisant votre cas d'usage et vos besoins d'intégration.

Voir aussi