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 Google et les serveurs MCP à distance sont automatiquement enregistrés et ingérés dans Agent Registry lorsque vous activez l'API compatible dans votre projet. Google Cloud Google CloudVous 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 outils MCP, enregistrez les serveurs MCP dans Agent Registry. Vous avez é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 Agent Registry, demandez à votre administrateur de vous accorder les rôles IAM suivants sur le projet :
-
Découvrir 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é les serveurs MCP, vous pouvez les découvrir pour les lier à 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 Google Cloud console, accédez à Agent Registry:
Dans l'outil de sélection de projets, sélectionnez le Google Cloud projet dans lequel vous avez configuré Agent Registry.
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, l'environnement 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 dans un emplacement spécifique, utilisez la commande mcp-servers list :
gcloud 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 Google Cloud console, accédez à Agent Registry:
Dans l'outil de sélection de projets, sélectionnez le Google Cloud projet dans lequel vous avez configuré Agent Registry.
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, l'environnement d'exécution et l'emplacement.
Pour filtrer par emplacement, cliquez sur le menu Emplacement, sélectionnez les emplacements que vous souhaitez 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 ne renvoyer que les ressources correspondant à des métadonnées spécifiques à l'aide de l'indicateur --filter :
gcloud 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
identifier (URN), utilisez
mcpServerId='urn:mcp:SERVER_URN'.
Terraform
Pour récupérer un serveur MCP enregistré spécifique en filtrant ses métadonnées, configurez la source de données google_agent_registry_mcp_server avec l'argument filter :
data "google_agent_registry_mcp_server" "filtered_mcp_server" {
location = "REGION"
filter = "displayName=\"DISPLAY_NAME\""
}
Remplacez les éléments suivants :
REGION: région du registre.DISPLAY_NAME: nom lisible du serveur MCP à filtrer, par exemple,Custom MCP Server.
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 Google Cloud console, accédez à Agent Registry:
Dans l'outil de sélection de projets, sélectionnez le Google Cloud projet dans lequel vous avez configuré Agent Registry.
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, l'environnement d'exécution et l'emplacement.
Cliquez sur le nom du serveur MCP que vous souhaitez afficher.
La page de détails comprend des onglets pour les détails du serveur MCP.
Cliquez sur l'onglet correspondant pour afficher les détails spécifiques du serveur MCP :
- Présentation : détails de base du serveur MCP, y compris son nom, identifiant, emplacement et description. La présentation affiche également un extrait de code qui vous permet de créer vos agents à l'aide de l' Agent Development Kit (ADK).
- Observabilité : informations sur l'état opérationnel et l'utilisation de le serveur MCP. Elle 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 afin de vous aider à gérer les coûts, à déboguer les problèmes et à suivre l'expérience utilisateur. Pour en savoir plus, consultez la présentation d'Observability.
- 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 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.
Terraform
Pour récupérer des informations sur un serveur MCP enregistré spécifique à l'aide de son ID, configurez la source de données google_agent_registry_mcp_server :
data "google_agent_registry_mcp_server" "my_mcp_server" {
location = "REGION"
mcp_server_id = "SERVER_NAME"
}
output "server_create_time" {
description = "The timestamp when the MCP server was registered."
value = data.google_agent_registry_mcp_server.my_mcp_server.create_time
}
output "server_update_time" {
description = "The timestamp when the MCP server was last updated."
value = data.google_agent_registry_mcp_server.my_mcp_server.update_time
}
Remplacez les éléments suivants :
REGION: région du registre.SERVER_NAME: identifiant unique de votre serveur MCP, par exemple,custom-mcp-server.
Mettre à jour les détails du serveur et les définitions d'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 détails du serveur disponibles à partir de la Google Cloud console :
Dans la Google Cloud console, accédez à Agent Registry:
Dans l'outil de sélection de projets, sélectionnez le Google Cloud projet dans lequel vous avez configuré Agent Registry.
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, l'environnement d'exécution et l'emplacement.
Cliquez sur le nom du serveur que vous souhaitez mettre à jour.
Dans l'onglet Présentation du serveur, cliquez sur Modifier.
Dans le panneau Modifier le service, saisissez les informations mises à jour de votre serveur, telles que son nouveau nom ou sa nouvelle description.
Cliquez sur Enregistrer.
gcloud
Préparez votre nouvelle spécification d'outil. Ensuite, mettez à jour votre fichier JSON avec les dernières définitions d'outils :
gcloud 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 exemple,custom-mcp-server.PROJECT_ID: ID du projet.REGION: région du registre.TOOL_SPEC: nom de la nouvelle spécification d'outil, par exemple,new-toolspec.json. La taille maximale du fichier de spécification est de 10 Ko.
Terraform
Terraform n'est compatible qu'avec le type NO_SPEC pour les serveurs MCP. Vous ne pouvez pas configurer les spécifications d'outils de manière intégrée. Pour mettre à jour les définitions d'outils de votre
serveur MCP, utilisez la Google Cloud console, gcloud CLI ou l'
API Agent Registry.
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' Google Cloud API du serveur MCP dans votre projet. Le serveur est ensuite 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 pour les autres outils :
Console
Dans la Google Cloud console, accédez à Agent Registry:
Dans l'outil de sélection de projets, sélectionnez le Google Cloud projet dans lequel vous avez configuré Agent Registry.
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, l'environnement d'exécution et l'emplacement.
Cliquez sur le nom du serveur que vous souhaitez supprimer.
Dans l'onglet Présentation du serveur, cliquez sur Supprimer.
Dans la boîte de dialogue de confirmation, saisissez SUPPRIMER pour confirmer l'action.
Cliquez sur Supprimer.
gcloud
gcloud 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 exemple,my-mcp-server.PROJECT_ID: ID du projet.REGION: région du registre.
Terraform
Supprimez la ressource google_agent_registry_service représentant le serveur MCP de votre configuration Terraform, puis exécutez terraform apply.
Gérer l'accès aux outils
Mettez en œuvre une gouvernance et une sécurité de niveau professionnel pour vos serveurs et outils MCP. Utilisez Agent Registry comme catalogue centralisé et Agent Gateway pour l'application active des règles.
Agent Gateway vous permet de gérer de manière sécurisée les interactions entre les agents et les outils, que ces agents s'exécutent sur Google Cloud ou qu'il s'agisse d' outils de développement externes.
Pour en savoir plus sur la gestion de l'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 d'Agent Gateway : découvrez comment la passerelle applique la sécurité et l'observabilité à toutes les interactions entre les agents et les outils (MCP).
- Afficher les résultats de sécurité : surveillez et examinez les informations de sécurité de votre écosystème d’agents à l’aide de Gemini Enterprise Agent Platform.