Le Model Context Protocol (MCP) est une norme Open Source permettant de connecter des applications d'IA à des systèmes externes. Il établit un ensemble spécifique d'entités et une structure définie, qui servent de méthode standard pour connecter diverses sources de données et outils à des modèles d'IA.
Vous pouvez utiliser les outils MCP pour connecter votre application d'agent à un serveur MCP existant.
Limites
Les limites suivantes s'appliquent :
- CX Agent Studio n'est compatible qu'avec les serveurs basés sur StreamableHttpTransport. Les serveurs de transport SSE ne sont pas compatibles.
Créer ou sélectionner un serveur MCP
Pour créer votre propre serveur MCP, nous vous recommandons d'utiliser les SDK MCP officiels ou d'autres SDK tiers fiables tels que FastMCP. Une fois le serveur MCP créé, déployez-le sur un service d'hébergement. Vous pouvez utiliser Cloud Run ou Compute Engine pour héberger le serveur MCP. Pour comprendre le processus de bout en bout, consultez ce guide : Créer et déployer un serveur MCP distant en moins de 10 minutes Google Cloud .
Au lieu de créer un serveur MCP de toutes pièces, vous pouvez également utiliser un serveur MCP prédéfini, tel qu'un Google Cloud serveur MCP.
Authentification
Les outils MCP disposent des mêmes options d'authentification que les outils OpenAPI.
En-têtes personnalisés
Vous pouvez fournir des en-têtes HTTP personnalisés à envoyer dans les requêtes au serveur MCP. Vous pouvez également injecter des variables du contexte de session dans ces en-têtes. Pour en savoir plus, consultez la section Variables de contexte de session.
Tester le serveur MCP indépendamment
Avant de connecter vos agents au serveur MCP, nous vous recommandons de tester le serveur MCP indépendamment.
Les serveurs créés à l'aide de StreamableHttpTransport
se terminent par le suffixe (/mcp ou /mcp/).
Par exemple, si le serveur est hébergé sur https://example.com,
l'URL correcte pour envoyer des requêtes au serveur est https://example.com/mcp.
Pour tester le serveur localement, vous pouvez utiliser curl ou Postman (qui est compatible en mode natif avec les connexions MCP). Cela permet de s'assurer que le serveur est opérationnel et que les informations d'authentification requises pour communiquer avec le serveur sont comprises.
En-têtes personnalisés
Vous pouvez définir des en-têtes personnalisés qui sont inclus lors de l'envoi de requêtes HTTP au serveur MCP (requêtes de liste d'outils et exécution d'outils). Les valeurs de ces en-têtes doivent être fournies par des variables, par conséquent, pour définir un en-tête personnalisé, vous devez d'abord définir une variable qui contiendra la valeur de l'en-tête. Si une variable ne contient pas de valeur et qu'aucune valeur par défaut n'est définie au moment de l'exécution, l'en-tête ne sera pas inclus dans les requêtes.
Créer l'outil MCP
Pour créer un outil MCP à partir de la console :
- Cliquez sur l'icône d'outil à droite du générateur d'agents.
- Sélectionnez Outil MCP.
- Indiquez un nom pour l'outil.
- Indiquez une description pour l'outil.
- Indiquez l'adresse du serveur MCP.
- Sélectionnez un type d'authentification.
- Vous pouvez également définir des en-têtes personnalisés en fournissant des noms d'en-tête et des variables qui seront utilisées comme valeurs d'en-tête.
- Cliquez sur Créer.
Pour les serveurs hébergés sur Cloud Run, l'option d'authentification recommandée est Jeton d'ID de l'agent de service.
Cette méthode utilise le compte de service CX Agent Studio (au format service-{PROJECT_NUMBER}@gcp-sa-ces.iam.gserviceaccount.com) pour envoyer des requêtes à la tâche Cloud Run.
Attribuez le
rôle Invoker Cloud Run
au compte de service CX Agent Studio
afin qu'il puisse envoyer des requêtes au serveur en utilisant sa propre identité.
Avant d'ajouter d'autres outils à l'agent, nous vous recommandons de tester au moins un outil pour vous assurer que les informations d'authentification sont correctement configurées.