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 sert de méthode standard pour connecter diverses sources de données et outils avec 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 l'ensemble du processus, nous vous recommandons de suivre ce guide : Créer et déployer un serveur MCP distant sur Google Cloud Run en moins de 10 minutes.
Au lieu de créer un serveur MCP à partir de zéro, 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.
Tester le serveur MCP de manière indépendante
Avant de connecter vos agents au serveur MCP, nous vous recommandons de tester le serveur MCP de manière indépendante.
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, envisagez d'utiliser curl ou Postman (qui prend en charge les connexions MCP de manière native). 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.
Créer l'outil MCP
Pour créer un outil MCP à partir de la console :
- Cliquez sur l'icône Outils à droite du générateur d'agents.
- Sélectionnez Outil MCP.
- Indiquez un nom pour l'outil.
- Fournissez une description de l'outil.
- Indiquez l'adresse du serveur MCP.
- Sélectionnez un type d'authentification.
- Cliquez sur Créer.
Pour les serveurs hébergés sur Cloud Run, l'option d'authentification recommandée est le jeton d'identité 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 au job Cloud Run.
Attribuez le rôle d'invocateur 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.