Intégration MCP et sécurité

Model Context Protocol (MCP) est un protocole ouvert qui relie les applications d’IA aux systèmes externes. Les clients compatibles peuvent obtenir du contexte, appeler des outils ou utiliser des prompts prédéfinis via un MCP Server, sans concevoir un protocole d’intégration spécifique à chaque source de données.

Fonctionnement de MCP

Un MCP Host peut se connecter à plusieurs MCP Server et créer un MCP Client distinct pour chacun.

MCP comporte une couche de données et une couche de transport : la première définit les messages JSON-RPC, la découverte des capacités et les Primitives ; la seconde détermine comment les messages circulent entre processus locaux ou sur le réseau. Les clients encapsulent généralement ces détails. Privilégiez leur interface de configuration MCP pour l’intégration.

Capacités proposées par un serveur

Un MCP Server expose principalement trois types de Primitives :

Le serveur déclare les capacités qu’il prend en charge, puis le client découvre les Tools, Resources et Prompts disponibles. Une capacité proposée n’est pas nécessairement activée par le client : le comportement dépend aussi de la version du Host, de sa politique d’autorisation et des choix de l’utilisateur.

Choisir le transport

La spécification MCP actuelle définit deux transports standard : stdio et Streamable HTTP.

Avec stdio, le stdout du serveur doit contenir uniquement des messages MCP ; les journaux doivent aller sur stderr. En cas d’échec de connexion, examinez les journaux stderr capturés par le client, mais ne transmettez pas à un tiers des journaux complets contenant des identifiants.

Streamable HTTP utilise actuellement un unique Endpoint POST ; il n’est pas nécessaire de configurer une adresse GET distincte ou une ancienne adresse HTTP+SSE. Le serveur détermine l’authentification. S’il propose OAuth, suivez de préférence sa page d’autorisation plutôt que d’inscrire des identifiants durables dans une configuration partagée.

Comprendre la configuration

Les noms des champs et l’emplacement de la configuration varient selon les clients. Les exemples ci-dessous montrent uniquement des structures courantes et ne sont pas directement exécutables. Remplacez tous les paramètres fictifs par les commandes, arguments, URL et méthodes d’authentification réels fournis par l’éditeur du serveur.

{
  "mcpServers": {
    "replace-with-server-name": {
      "command": "/absolute/path/to/server-command",
      "args": [
        "--replace-with-required-argument"
      ],
      "env": {
        "SERVICE_API_KEY": "replace-with-client-supported-secret-reference"
      }
    }
  }
}

Étapes d’intégration sécurisée

Liste de vérification des autorisations

Pour un serveur distant, connectez uniquement des adresses HTTPS fiables et suivez leur procédure d’autorisation. Pour un serveur local, privilégiez un chemin de commande absolu, des répertoires isolés et les droits d’un utilisateur standard, plutôt que des privilèges administrateur par commodité.

Problèmes fréquents

Recommandations pour une utilisation durable

• Réexaminez régulièrement les serveurs connectés, leurs versions, leurs Tool et leurs autorisations ;
• Utilisez des identifiants distincts, révocables et aux privilèges minimaux pour chaque serveur ;
• Conservez la confirmation humaine, notamment pour les suppressions, écritures, paiements, messages et opérations de production ;
• Ne considérez pas les instructions de Resource inconnues ou de résultats de Tool comme des instructions système fiables ;
• Retirez des journaux, captures d’écran et rapports d’erreur les Key, Token, données clients et chemins sensibles ;
• Lorsque vous cessez d’utiliser un serveur, retirez sa configuration du client et révoquez les identifiants associés.

Pour configurer AGTCloud dans un client de modèle, commencez par le tutoriel d’intégration CC-Switch ou choisissez un outil dans « Intégrations tierces » à gauche. Pour les endpoints et les champs de requêtes, consultez la Référence API. La documentation officielle MCP fait référence pour les détails du protocole et ses évolutions.