Gérer les serveurs et outils MCP

Agent Registry vous permet d'inspecter, de mettre à jour et de supprimer les serveurs et outils MCP (Model Context Protocol) enregistrés afin que vos agents disposent de schémas d'outils et de points de terminaison précis au moment de l'exécution. Vous pouvez découvrir les serveurs MCP enregistrés automatiquement et manuellement, mettre à jour les définitions d'outils enregistrées manuellement et supprimer les serveurs MCP qui ne sont plus utilisés.

Avant de commencer

  1. Configurer le registre d'agents.

  2. Pour une configuration à projet unique, obtenez l'ID de projet du projet de gouvernance où le registre d'agents est activé. Si vous avez configuré une limite de gestion pour plusieurs projets, utilisez l'ID de votre projet de gestion pour la découverte et l'enregistrement à l'échelle de la limite, ou spécifiez l'ID d'un projet membre pour les opérations sur un seul projet.

  3. Enregistrez les serveurs MCP dans Agent Registry.

  4. Pour utiliser les commandes de la Google Cloud CLI dans ce document, configurez votre environnement gcloud CLI.

Rôles requis

Pour obtenir les autorisations nécessaires pour gérer les serveurs et les outils MCP dans Agent Registry, demandez à votre administrateur de vous accorder les rôles IAM suivants sur le projet de gouvernance où Agent Registry est activé :

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 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.

Si vous avez configuré une limite de gestion, vous pouvez lister les serveurs MCP de plusieurs projets à partir de votre projet de gestion.

Pour lister tous les serveurs MCP de votre environnement, procédez comme suit :

Console

  1. Dans la console Google Cloud , accédez à Agent Registry :

    Accéder au registre d'agents

  2. Dans le sélecteur de projets, sélectionnez le projet Google Cloud dans lequel vous avez configuré Agent Registry.

  3. 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.

  4. 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, exécutez la commande gcloud agent-registry mcp-servers list :

gcloud agent-registry mcp-servers list \
    --project=PROJECT_ID \
    --location=REGION

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet. Si vous avez configuré une limite de gestion, spécifiez l'ID de votre projet de gestion pour lister les serveurs MCP à l'emplacement spécifié dans tous les projets membres de la limite. Chaque nom de ressource renvoyé conserve l'ID du serveur MCP et utilise le projet spécifié dans la requête.
  • REGION : emplacement du registre, par exemple us-central1, eu ou global. Sur un projet de gestion, la spécification d'un emplacement regroupe les serveurs MCP de cet emplacement dans tous les projets membres de la limite.

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 en fonction des métadonnées du serveur :

Console

  1. Dans la console Google Cloud , accédez à Agent Registry :

    Accéder au registre d'agents

  2. Dans le sélecteur de projets, sélectionnez le projet Google Cloud dans lequel vous avez configuré le registre d'agents.

  3. 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.

  4. 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 en transmettant l'option --filter à la commande gcloud agent-registry mcp-servers list :

gcloud agent-registry mcp-servers list \
    --project=PROJECT_ID \
    --location=REGION \
    --filter="FILTER_EXPRESSION"

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet.
  • REGION : région du registre.
  • FILTER_EXPRESSION : 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 de serveur MCP unique (URN), utilisez mcpServerId='urn:mcp:SERVER_URN'.
    • Pour filtrer par projet membre spécifique lors de l'interrogation d'un projet de gestion, utilisez project_id=MEMBER_PROJECT_ID.

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 par l'humain du serveur MCP à utiliser pour le filtrage, 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

  1. Dans la console Google Cloud , accédez à Agent Registry :

    Accéder au registre d'agents

  2. Dans le sélecteur de projets, sélectionnez le projet Google Cloud dans lequel vous avez configuré le registre d'agents.

  3. 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.

  4. Cliquez sur le nom du serveur MCP que vous souhaitez afficher.

    La page d'informations inclut des onglets pour les détails du serveur MCP.

  5. Cliquez sur l'onglet correspondant pour afficher les détails d'un serveur MCP spécifique :

    • Présentation : informations de base sur le serveur MCP, y compris son nom, son identifiant, son emplacement et sa description. La vue d'ensemble affiche également un extrait de code qui vous permet 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. Il affiche des métriques axées sur l'application, telles que la latence, le trafic, les erreurs et l'utilisation de jetons. Cet onglet s'intègre à Google Cloud Observability pour afficher des 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 de l'observabilité.
    • Outils : 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 de comportement critiques qui guident la manière dont 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, exécutez la commande gcloud agent-registry mcp-servers describe :

gcloud agent-registry mcp-servers describe SERVER_NAME \
    --project=PROJECT_ID \
    --location=REGION

Remplacez les éléments suivants :

  • SERVER_NAME : nom de votre serveur MCP, par exemple custom-mcp-server.
  • PROJECT_ID : ID du projet. Dans une limite de gestion, vous pouvez spécifier l'ID du projet de gestion ou l'ID du projet membre dans lequel le serveur est déployé. Le nom de ressource renvoyé conserve l'ID du serveur MCP et utilise le projet spécifié dans votre requête.
  • REGION : région du registre.

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 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.

Dans Agent Registry, les ressources McpServer sont des ressources de découverte en lecture seule. Pour les serveurs MCP enregistrés automatiquement, mettez à jour le déploiement ou la charge de travail dans son environnement d'exécution sous-jacent afin qu'Agent Registry synchronise les modifications. Pour mettre à jour un serveur MCP enregistré manuellement, vous devez mettre à jour sa ressource Service accessible en écriture directement en spécifiant l'ID du projet dans lequel cette ressource Service a été enregistrée. Étant donné que le registre n'inspecte pas automatiquement les serveurs MCP enregistrés manuellement, vous devez importer manuellement la spécification d'outil mise à jour, qui remplace les définitions d'outils existantes pour le serveur.

Console

Mettez à jour les détails du serveur disponibles à partir de la console Google Cloud  :

  1. Dans la console Google Cloud , accédez à Agent Registry :

    Accéder au registre d'agents

  2. Dans le sélecteur de projets, sélectionnez le projet Google Cloud dans lequel vous avez configuré le registre d'agents.

  3. 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.

  4. Cliquez sur le nom du serveur que vous souhaitez mettre à jour.

  5. Dans l'onglet Aperçu du serveur, cliquez sur Modifier.

  6. Dans le panneau Modifier le service, saisissez les informations mises à jour de votre serveur, telles que son nouveau nom ou sa nouvelle description.

  7. Cliquez sur Enregistrer.

gcloud

Préparez la spécification de votre nouvel outil. Ensuite, exécutez la commande gcloud agent-registry services update avec votre fichier JSON mis à jour :

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 : chemin d'accès au nouveau fichier de spécification de l'outil, par exemple new-toolspec.json. La taille maximale du fichier de spécification est de 10 Ko.

Terraform

Pour mettre à jour les métadonnées, l'URL du point de terminaison ou la spécification d'outil de votre serveur MCP enregistré, modifiez les paramètres de la ressource google_agent_registry_service existante dans votre configuration, puis exécutez terraform apply :

resource "google_agent_registry_service" "mcp_server" {
  location     = "REGION"
  service_id   = "SERVER_NAME"
  display_name = "DISPLAY_NAME"
  description  = "Updated description of the MCP server."

  interfaces {
    url              = "SERVER_URL"
    protocol_binding = "JSONRPC"
  }

  mcp_server_spec {
    type    = "TOOL_SPEC"
    content = file("TOOL_SPEC")
  }
}

Remplacez les éléments suivants :

  • REGION : région du registre.
  • SERVER_NAME : nom de votre serveur MCP, par exemple custom-mcp-server.
  • DISPLAY_NAME : nom à afficher lisible par l'humain de votre serveur MCP, par exemple Custom MCP Server.
  • SERVER_URL : URL du point de terminaison du serveur MCP, par exemple https://api.example.com/mcp.
  • TOOL_SPEC : chemin d'accès au fichier de spécification d'outil mis à jour, par exemple new-toolspec.json. La taille maximale du fichier de spécification est de 10 Ko.

Supprimer un serveur MCP

Pour supprimer des 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 ensuite automatiquement supprimé du registre.

Pour supprimer un serveur MCP enregistré manuellement du registre, vous devez supprimer sa ressource Service en spécifiant l'ID du projet dans lequel cette ressource Service a été enregistrée. Cette action supprime le serveur MCP des résultats de recherche et le rend invisible pour les autres outils :

Console

  1. Dans la console Google Cloud , accédez à Agent Registry :

    Accéder au registre d'agents

  2. Dans le sélecteur de projets, sélectionnez le projet Google Cloud dans lequel vous avez configuré le registre d'agents.

  3. 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.

  4. Cliquez sur le nom du serveur que vous souhaitez supprimer.

  5. Dans l'onglet Présentation du serveur, cliquez sur Supprimer.

  6. Dans la boîte de dialogue de confirmation, saisissez DELETE pour confirmer l'action.

  7. Cliquez sur Supprimer.

gcloud

Exécutez la commande gcloud agent-registry services delete :

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 entreprise pour vos serveurs MCP et vos outils. Utilisez Agent Registry comme registre central 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 pour les développeurs externes.

Pour en savoir plus sur la gestion de l'accès aux outils, consultez les ressources suivantes :