Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Enregistrer des serveurs MCP

Agent Registry agit comme un catalogue centralisé en enregistrant et en gérant les points de terminaison des serveurs MCP (Model Context Protocol) et les outils spécifiques qu'ils exposent.

Ce document explique comment enregistrer des serveurs MCP et comment leurs spécifications d'outils sont gérées dans Agent Registry.

Découverte automatique des serveurs MCP Google Cloud

Les serveurs MCP officiels de Google et Google Cloud à distance sont automatiquement enregistrés et ingérés dans Agent Registry. Les serveurs MCP Google et Google Cloud distants disponibles sont listés dans Produits compatibles de la documentation sur les serveurs MCPGoogle Cloud .

Lorsque vous activez une API Google Cloud compatible dans votre projet, comme l'API Compute Engine, le serveur MCP correspondant et ses outils sont immédiatement enregistrés et mis à disposition pour la découverte dans le registre d'agents. Vous n'avez pas besoin de configurer ni d'importer manuellement les spécifications des outils pour ces serveurs.

Enregistrer des serveurs MCP externes

Pour gérer et réutiliser les outils fournis par des serveurs externes ou des API personnalisées, vous devez enregistrer explicitement le serveur MCP.

Lorsque vous enregistrez manuellement un serveur MCP, Agent Registry enregistre le point de terminaison. Cependant, il n'inspecte pas automatiquement le serveur pour déterminer les outils disponibles. Pour permettre aux utilisateurs de découvrir les outils exacts disponibles sur votre serveur MCP, vous devez fournir les spécifications des outils lors de l'enregistrement en important un fichier toolspec.json.

Avant de commencer

Avant de commencer, configurez le registre d'agents. Vous avez besoin de l'ID du 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 enregistrer manuellement des serveurs MCP dans le registre d'agents, demandez à votre administrateur de vous accorder le rôle IAM Éditeur de l'API Agent Registry (roles/agentregistry.editor) sur le projet. 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.

Préparer les spécifications de votre outil

Créez un fichier toolspec.json qui décrit les outils fournis par le serveur. La taille maximale de ce fichier de spécification est de 10 Ko.

Le fichier JSON doit correspondre à la spécification MCP pour les schémas d'outils. Par exemple :

{
  "tools": [
    {
      "name": "get_customer_info",
      "description": "Retrieves customer details from the database.",
      "annotations": {
        "title": "Get Customer Info",
        "readOnlyHint": true,
        "idempotentHint": true
      }
    },
    {
      "name": "create_support_ticket",
      "description": "Creates a new support ticket in the issue tracking system.",
      "annotations": {
        "title": "Create Support Ticket",
        "destructiveHint": true,
        "idempotentHint": false,
        "openWorldHint": true
      }
    }
  ]
}

Pour en savoir plus sur les exigences structurelles, consultez les schémas JSON et la documentation de référence REST.

Enregistrer le serveur et les outils

Enregistrez le serveur MCP et importez la définition de l'outil simultanément :

Console

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

Accéder au registre d'agents
Dans le sélecteur de projets, sélectionnez le projet Google Cloud dans lequel vous avez configuré Agent Registry.
Sélectionnez l'onglet Serveurs MCP.
Cliquez sur Ajouter un serveur MCP.
Dans le panneau Informations sur le serveur MCP, saisissez le nom à afficher, une description et la région géographique.
Dans la section Spécification de l'outil, saisissez l'URL du point de terminaison du serveur MCP et collez le contenu de votre fichier toolspec.json.

Vous pouvez également cliquer sur Importer des outils dans ce panneau pour importer les outils MCP à partir de l'URL. Cette option ne fonctionne que si l'URL du point de terminaison de votre serveur MCP est hébergée publiquement sur Internet. Vous ne pouvez pas utiliser cette fonctionnalité pour importer des outils à partir de serveurs MCP hébergés en mode privé.
Cliquez sur Suivant.

Le panneau Sélectionner des outils MCP affiche une liste d'outils avec leurs noms et descriptions provenant de votre serveur MCP.
Sélectionnez tous les outils MCP que vous souhaitez inclure. Vous pouvez filtrer les outils de la liste par nom ou par valeur.
Cliquez sur Enregistrer.

gcloud

Enregistrez le serveur MCP avec la spécification de l'outil :

gcloud agent-registry services create SERVER_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --display-name="DISPLAY_NAME" \
  --mcp-server-spec-type=tool-spec \
  --mcp-server-spec-content=toolspec.json \
  --interfaces=url=SERVER_URL,protocolBinding=PROTOCOL

Remplacez les éléments suivants :

SERVER_NAME : nom que vous souhaitez attribuer à votre serveur MCP, par exemple custom-mcp-server.
PROJECT_ID : ID du projet.
REGION : région du registre.
DISPLAY_NAME : nom lisible que vous souhaitez attribuer à votre serveur, par exemple Custom MCP Server.
SERVER_URL : URL du point de terminaison du serveur MCP, par exemple https://api.example.com/mcp.
PROTOCOL : liaison de protocole pour le point de terminaison. Les valeurs valides sont JSONRPC, HTTP_JSON ou GRPC. Pour les serveurs MCP, cette valeur est souvent JSONRPC.

Terraform

Pour enregistrer un serveur MCP et spécifier ses outils, configurez une ressource google_agent_registry_service avec le bloc mcp_server_spec :

resource "google_agent_registry_service" "mcp_server" {
  location     = "REGION"
  service_id   = "SERVER_NAME"
  display_name = "DISPLAY_NAME"
  description  = "An external MCP server registered using Terraform."

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

  mcp_server_spec {
    type    = "NO_SPEC"
  }
}

output "server_resource_name" {
  description = "The generated read-only Server resource name."
  value       = google_agent_registry_service.mcp_server.registry_resource
}