Enregistrer des serveurs MCP

Agent Registry fait office de catalogue centralisé en enregistrant et en gérant les points de terminaison du serveur 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 Google Cloud MCP

Les serveurs MCP Google officiels et Google Cloud distants 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 Google Cloud documentation sur les serveurs MCP.

Lorsque vous activez une API compatible Google Cloud dans votre projet, telle que l' API Compute Engine, le serveur MCP correspondant et ses outils sont immédiatement enregistrés et mis à disposition pour la découverte dans Agent Registry. Vous n'avez pas besoin de configurer ni d'importer manuellement les spécifications d'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.

Lors de l'enregistrement manuel d'un serveur MCP, Agent Registry enregistre le point de terminaison. Toutefois, 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 Agent Registry. 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 Agent Registry, 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 la spécification de votre outil

Créez un fichier toolspec.json qui décrit les outils fournis par le serveur. Ce fichier JSON doit être conforme à 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 connaître les exigences structurelles détaillées, consultez 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

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

    Accéder à Agent Registry

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

  3. Sélectionnez l'onglet Serveurs MCP.

  4. Cliquez sur Ajouter un serveur MCP.

  5. Dans le panneau Détails du serveur MCP , saisissez le nom à afficher, une description et la région géographique.

  6. 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 de manière privée.

  7. Cliquez sur Suivant.

    Le panneau Sélectionner les outils MCP affiche une liste d'outils avec les noms et les descriptions de votre serveur MCP.

  8. Sélectionnez tous les outils MCP que vous souhaitez inclure. Vous pouvez filtrer les outils de la liste par nom ou par valeur.

  9. Cliquez sur Enregistrer.

gcloud

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

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

Vérifier l'enregistrement

Listez, filtrez et affichez les détails de votre serveur MCP nouvellement enregistré. Pour vérifier que votre serveur MCP a bien été enregistré, vous pouvez lister les serveurs de votre registre.