Agent Registry vous permet de découvrir et de gérer les serveurs MCP (Model Context Protocol) et les outils spécifiques qu'ils exposent.
Les serveurs MCP officiels de Google et Google Cloud distants sont automatiquement enregistrés et ingérés dans Agent Registry lorsque vous activez l'API Google Cloudprise en charge dans votre projet. Vous pouvez également enregistrer manuellement d'autres serveurs MCP externes. Pour en savoir plus, consultez Enregistrer des serveurs MCP.
Ce document explique comment découvrir les serveurs et outils MCP enregistrés, et comment modifier vos définitions d'outils.
Avant de commencer
Avant de pouvoir gérer les serveurs et les outils MCP, enregistrez les serveurs MCP dans Agent Registry. Vous aurez également besoin de l'ID de votre projet pour effectuer ces tâches.
Pour utiliser les commandes gcloud CLI de ce document, assurez-vous d'avoir configuré votre environnement Google Cloud CLI.
Rôles requis
Pour obtenir les autorisations nécessaires pour gérer les serveurs et outils MCP dans le registre d'agents, demandez à votre administrateur de vous accorder les rôles IAM suivants sur le projet :
-
Découvrez les serveurs et outils MCP disponibles :
Lecteur de l'API Agent Registry (
roles/agentregistry.viewer) -
Mettre à jour les définitions d'outils :
Éditeur de l'API Agent Registry (
roles/agentregistry.editor)
Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.
Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.
Découvrir les serveurs et outils MCP disponibles
Après avoir enregistré des serveurs MCP, vous pouvez les découvrir pour les associer à vos agents.
Lister tous les serveurs MCP disponibles
Vous pouvez lister tous les serveurs MCP enregistrés dans votre environnement et afficher leurs configurations détaillées, telles que leurs points de terminaison et les métadonnées associées :
Console
Dans la console Google Cloud , accédez à Agent Registry :
Dans le sélecteur de projets, sélectionnez le projet dans lequel vous avez configuré Agent Registry. Google Cloud
Sélectionnez l'onglet Serveurs MCP.
La page affiche la liste de tous les serveurs MCP enregistrés et leurs détails, tels que le nom, l'identifiant, la description, le temps d'exécution et l'emplacement.
Pour afficher tous les détails d'un serveur, cliquez sur son nom.
gcloud
Pour lister tous les serveurs MCP d'un emplacement spécifique, utilisez la commande mcp-servers list :
gcloud alpha agent-registry mcp-servers list \
--project=PROJECT_ID \
--location=REGION
Remplacez les éléments suivants :
PROJECT_ID: ID du projet.REGION: région du registre.
Filtrer les serveurs MCP enregistrés
Si vous avez plusieurs serveurs ou si vous souhaitez confirmer l'enregistrement d'un serveur spécifique, vous pouvez filtrer la liste par métadonnées du serveur :
Console
Dans la console Google Cloud , accédez à Agent Registry :
Dans le sélecteur de projets, sélectionnez le projet dans lequel vous avez configuré Agent Registry. Google Cloud
Sélectionnez l'onglet Serveurs MCP.
La page affiche la liste de tous les serveurs MCP enregistrés et leurs détails, tels que le nom, l'identifiant, la description, le temps d'exécution et l'emplacement.
Pour filtrer par zone géographique, cliquez sur le menu Zone géographique, sélectionnez les zones géographiques à filtrer, puis cliquez sur Appliquer.
La page affiche une liste filtrée des serveurs MCP enregistrés pour les conditions que vous avez sélectionnées.
gcloud
Filtrez votre liste pour n'afficher que les ressources correspondant à des métadonnées spécifiques à l'aide de l'indicateur --filter :
gcloud alpha agent-registry mcp-servers list \
--project=PROJECT_ID \
--location=REGION \
--filter="FILTER_EXPRESSION"
Remplacez FILTER_EXPRESSION par l'expression de filtre pour les serveurs MCP que vous souhaitez filtrer. Par exemple, vous pouvez utiliser les filtres suivants :
- Pour filtrer par nom à afficher, utilisez
displayName='DISPLAY_NAME'. - Pour effectuer une recherche par identifiant unique global (URN), utilisez
mcpServerId='urn:mcp:SERVER_URN'.
Afficher les détails d'un serveur MCP
Affichez les détails d'un serveur MCP spécifique, par exemple ses outils :
Console
Dans la console Google Cloud , accédez à Agent Registry :
Dans le sélecteur de projets, sélectionnez le projet dans lequel vous avez configuré Agent Registry. Google Cloud
Sélectionnez l'onglet Serveurs MCP.
La page affiche la liste de tous les serveurs MCP enregistrés et leurs détails, tels que le nom, l'identifiant, la description, le temps d'exécution et l'emplacement.
Cliquez sur le nom du serveur MCP que vous souhaitez afficher.
La page d'informations inclut des onglets pour les informations sur le serveur MCP.
Cliquez sur l'onglet correspondant pour afficher les détails spécifiques du serveur MCP :
- Présentation : informations de base du serveur MCP, y compris son nom, son identifiant, son emplacement et sa description. La vue d'ensemble affiche également un extrait de code pour vous permettre de créer vos agents à l'aide de l'Agent Development Kit (ADK).
- Observabilité : insights sur l'état opérationnel et l'utilisation du serveur MCP. Cette section présente des métriques axées sur les applications, telles que la latence, le trafic, les erreurs et les dépenses en jetons. Cet onglet s'intègre à Google Cloud Observability pour afficher les métriques de performances en temps réel et l'utilisation au niveau du système. Il vous aide ainsi à gérer les coûts, à résoudre les problèmes et à suivre l'expérience utilisateur. Pour en savoir plus, consultez Présentation de l'observabilité.
- Outils : catalogue des fonctionnalités fournies par le serveur. Cet onglet liste les fonctions spécifiques exposées par un serveur MCP que les agents peuvent appeler pour effectuer des actions spécifiques. Pour chaque outil, l'interface affiche son schéma, y compris son nom, sa description et les annotations comportementales critiques qui indiquent comment un agent d'orchestration doit interagir avec lui. Cliquez sur le nom d'un outil pour afficher un extrait de code qui vous permet de créer vos agents à l'aide de l'ADK.
gcloud
Pour afficher les métadonnées détaillées d'un serveur MCP spécifique, utilisez la commande mcp-servers describe :
gcloud alpha agent-registry mcp-servers describe SERVER_NAME \
--project=PROJECT_ID \
--location=REGION
Remplacez SERVER_NAME par le nom de votre serveur MCP, par exemple custom-mcp-server.
Mettre à jour les détails du serveur et les définitions des outils
Si votre serveur MCP ajoute de nouveaux outils ou modifie des schémas existants, vous devez mettre à jour le registre pour refléter ces modifications. Étant donné que le registre n'inspecte pas automatiquement les serveurs MCP, vous devez importer manuellement la spécification d'outil mise à jour. Le contenu que vous importez remplace les définitions d'outils existantes pour ce serveur.
Pour l'API Agent Registry, les ressources McpServer sont utilisées pour la découverte. Par conséquent, vous devez mettre à jour directement la ressource Service enregistrée.
Console
Mettez à jour les informations disponibles sur le serveur depuis la console Google Cloud :
Dans la console Google Cloud , accédez à Agent Registry :
Dans le sélecteur de projets, sélectionnez le projet dans lequel vous avez configuré Agent Registry. Google Cloud
Sélectionnez l'onglet Serveurs MCP.
La page affiche la liste de tous les serveurs MCP enregistrés et leurs détails, tels que le nom, l'identifiant, la description, le temps d'exécution et l'emplacement.
Cliquez sur le nom du serveur que vous souhaitez modifier.
Dans l'onglet Présentation du serveur, cliquez sur Modifier.
Dans le panneau Modifier le service, saisissez les informations mises à jour de votre serveur, comme son nouveau nom ou sa nouvelle description.
Cliquez sur Enregistrer.
gcloud
Préparez les spécifications de votre nouvel outil. Ensuite, mettez à jour votre fichier JSON avec les dernières définitions d'outils :
gcloud alpha agent-registry services update SERVER_NAME \
--project=PROJECT_ID \
--location=REGION \
--mcp-server-spec-content=TOOL_SPEC
Remplacez les éléments suivants :
SERVER_NAME: nom de votre serveur MCP, par exemplecustom-mcp-server.PROJECT_ID: ID du projet.REGION: région du registre.TOOL_SPEC: nom de la nouvelle spécification d'outil, par exemplenew-toolspec.json. La taille maximale du fichier de spécification est de 10 Ko.
Supprimer un serveur MCP
Pour supprimer les serveurs MCP qui ont été automatiquement enregistrés dans Agent Registry, vous devez supprimer le serveur MCP sous-jacent ou désactiver l'API Google Cloud du serveur MCP dans votre projet. Le serveur est alors automatiquement supprimé du registre.
Pour supprimer un serveur MCP enregistré manuellement du registre, vous devez supprimer la ressource Service sous-jacente. Cette action supprime le serveur MCP des résultats de recherche et le rend indétectable par d'autres outils :
Console
Dans la console Google Cloud , accédez à Agent Registry :
Dans le sélecteur de projets, sélectionnez le projet dans lequel vous avez configuré Agent Registry. Google Cloud
Sélectionnez l'onglet Serveurs MCP.
La page affiche la liste de tous les serveurs MCP enregistrés et leurs détails, tels que le nom, l'identifiant, la description, le temps d'exécution et l'emplacement.
Cliquez sur le nom du serveur que vous souhaitez supprimer.
Dans l'onglet Vue d'ensemble du serveur, cliquez sur Supprimer.
Dans la boîte de dialogue de confirmation, saisissez SUPPRIMER pour confirmer l'action.
Cliquez sur Supprimer.
gcloud
gcloud alpha agent-registry services delete SERVER_NAME \
--project=PROJECT_ID \
--location=REGION
Remplacez les éléments suivants :
SERVER_NAME: nom du serveur MCP que vous souhaitez supprimer, par exemplemy-mcp-server.PROJECT_ID: ID du projet.REGION: région du registre.
Gérer l'accès aux outils
Implémentez une gouvernance et une sécurité de niveau entreprise pour vos serveurs et outils MCP. Utilisez le registre d'agents comme catalogue centralisé et la passerelle d'agent pour l'application active des règles.
La passerelle d'agent vous permet de régir de manière sécurisée les interactions entre les agents et les outils, qu'ils s'exécutent sur Google Cloud ou qu'il s'agisse d'outils de développement externes.
Pour en savoir plus sur la gestion des accès aux outils, consultez les ressources suivantes :
- Présentation des stratégies IAM : définissez qui peut accéder à des outils spécifiques et dans quelles conditions.
- Présentation de la passerelle d'agent : découvrez comment la passerelle applique la sécurité et l'observabilité à toutes les interactions entre agent et outil (MCP).
- Afficher les résultats de sécurité : surveillez et examinez les insights sur la sécurité de votre écosystème agentique à l'aide de Gemini Enterprise Agent Platform.