Utiliser votre propre serveur MCP pour l'architecture de référence kagent

Présentation

Cette solution répond au besoin d'un mécanisme standardisé, sécurisé et évolutif pour intégrer des serveurs Model Context Protocol (MCP) dans des environnements Distributed Cloud logiciel uniquement (GDC) avec kagent déployé en tant que plate-forme d'IA agentive.

Le problème principal est l'absence d'interface unifiée pour connecter les applications de grands modèles de langage (LLM) aux sources de données et aux outils localisés dans les clusters GDC réglementés. Cette architecture fournit un framework BYO (Bring Your Own) qui permet aux développeurs de déployer des serveurs MCP personnalisés qui exposent des fonctionnalités d'entreprise spécifiques en tant qu'outils pour les agents IA.

Cette architecture couvre les protocoles de communication entre kagent et les serveurs MCP, ainsi que la topologie des composants sur GDC. Elle exclut la logique interne des serveurs MCP tiers.

Ce document s'adresse aux administrateurs de la plate-forme GDC, aux développeurs d'applications d'IA et aux examinateurs de sécurité chargés d'approuver les intégrations d'outils externes.

Fonctionnalités et capacités

kagent fournit un framework flexible qui permet aux organisations d'utiliser leurs propres serveurs MCP pour intégrer des LLM à des outils locaux ou propriétaires. Grâce à cette fonctionnalité, les agents peuvent interagir avec des sources de données spécialisées et effectuer des tâches complexes dans le périmètre d'un cluster GDC.

Composants fonctionnels et responsabilités

L'architecture comprend les composants fonctionnels suivants :

  • Plate-forme d'agents IA (kagent) : agit en tant qu'orchestrateur central. Il gère le cycle de vie de la session agentive, achemine les requêtes utilisateur vers le LLM et coordonne l'exécution des outils via le client MCP.
  • LLM : gère la compréhension du langage naturel et le raisonnement. Il détermine quand un outil spécifique est nécessaire pour répondre à une requête et génère les paramètres requis pour appeler cet outil.
  • Serveur MCP : expose des outils spécifiques via MCP en tant que service autonome. Il gère la logique de bas niveau de l'interaction avec les systèmes d'entreprise ou les dépôts de données backend.

Interfaces et flux de données

L'architecture de bout en bout repose sur des interfaces standardisées pour maintenir l'interopérabilité et la sécurité :

  • Transport MCP : kagent communique avec le serveur MCP à l'aide de JSON-RPC standardisé sur un transport MCP compatible, tel que Streamable HTTP (ou HTTP avec SSE) ou stdio. Cette interface définit la manière dont les outils sont découverts, décrits et appelés.
  • Flux de données : le cycle de vie de la requête suit les étapes suivantes :
    1. L'utilisateur envoie un prompt à kagent.
    2. kagent transmet le prompt au LLM.
    3. Le LLM identifie un appel d'outil et le renvoie à kagent.
    4. kagent transfère la requête au serveur MCP.
    5. Le serveur MCP exécute l'outil sur la source de données locale et renvoie le résultat.
    6. L'agent kagent renvoie le résultat au LLM pour générer la réponse finale.

Architecture

Pour montrer comment déployer et utiliser un serveur MCP BYO, cette architecture de référence utilise l'application Open Source Nextcloud, son serveur MCP et l'agent Nextcloud sur Solo Enterprise pour kagent.

Cet exemple diffuse le modèle Gemma 4 à l'aide de vLLM.

L'architecture connecte Nextcloud, kagent et le modèle Gemma 4 dans l'environnement GDC. Dans cette configuration, kagent utilise Nextcloud comme dépôt de données afin que le modèle Gemma 4 puisse accéder aux informations de Nextcloud et les traiter via des interfaces MCP standardisées.

Nextcloud est une plate-forme de collaboration et de stockage cloud Open Source auto-hébergée qui accepte le déploiement sur site pour vous aider à garder le contrôle et la confidentialité des données utilisateur. Il s'agit d'un composant d'openDesk.

Nextcloud inclut les fonctionnalités suivantes :

  • Synchronisation et partage de fichiers : stockez des fichiers, synchronisez-les sur des ordinateurs et des appareils mobiles via des applications dédiées, et partagez-les à l'aide de liens.
  • Outils de productivité : utilisez l'agenda, les contacts, la gestion des tâches et les clients de messagerie intégrés.
  • Collaboration : intégrez des suites bureautiques, telles que Collabora Online ou ONLYOFFICE, directement dans Nextcloud pour coéditer des documents, des feuilles de calcul et des présentations en temps réel.
  • Extensibilité : installez des plug-ins depuis le magasin d'applications pour ajouter des fonctionnalités telles que des gestionnaires de mots de passe, des tableaux Kanban ou des lecteurs de musique.

Cette solution nécessite GDC avec kagent et vLLM diffusant le modèle Gemma 4. Le schéma suivant illustre la configuration de la validation :

Configuration de la validation avec GDC, kagent, Nextcloud et vLLM diffusant Gemma 4.

Autres ressources