Registra server MCP

Agent Registry funge da catalogo centralizzato registrando e gestendo gli endpoint del server Model Context Protocol (MCP) e gli strumenti specifici che espongono.

Questo documento descrive come registrare i server MCP e come vengono gestite le specifiche dei relativi strumenti in Agent Registry.

Rilevamento automatico dei Google Cloud server MCP

I server MCP remoti ufficiali di Google e Google Cloud vengono registrati automaticamente e inseriti in Agent Registry. I server Google e Google Cloud MCP remoti disponibili sono elencati in Prodotti supportati nella documentazione dei serverGoogle Cloud MCP.

Quando abiliti un'API Google Cloud supportata nel tuo progetto, ad esempio l'API Compute Engine, il server MCP corrispondente e i relativi strumenti vengono registrati immediatamente e resi disponibili per l'individuazione in Agent Registry. Non è necessario configurare o caricare manualmente le specifiche degli strumenti per questi servizi.

Registra server MCP esterni

Per gestire e riutilizzare gli strumenti forniti da servizi esterni o API personalizzate, devi registrare esplicitamente il server MCP.

Quando registri manualmente un server MCP, Agent Registry registra l'endpoint. Tuttavia, non esegue automaticamente l'introspezione del server per determinare quali strumenti sono disponibili. Per consentire agli utenti di scoprire gli strumenti esatti disponibili sul tuo server MCP, devi fornire le specifiche degli strumenti durante la registrazione caricando un file toolspec.json.

Prima di iniziare

Prima di iniziare, configura il registro degli agenti. Per eseguire queste attività, devi disporre dell'ID progetto.

Per utilizzare i comandi gcloud CLI in questo documento, assicurati di aver configurato l'ambiente Google Cloud CLI.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per registrare manualmente i server MCP in Agent Registry, chiedi all'amministratore di concederti il ruolo IAM Editor API Agent Registry (roles/agentregistry.editor) sul progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Prepara le specifiche dello strumento

Crea un file toolspec.json che descriva gli strumenti forniti dal server. Questo file JSON deve essere in linea con la specifica MCP per gli schemi degli strumenti, ad esempio:

{
  "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
      }
    }
  ]
}

Per i requisiti strutturali dettagliati, consulta Schemi JSON e il riferimento REST.

Registra il server e gli strumenti

Registra il server MCP e carica contemporaneamente la definizione dello strumento:

Console

Nella console Google Cloud , vai a Registro agenti:

Vai al registry degli agenti
Nel selettore di progetti, seleziona il Google Cloud progetto in cui hai configurato Agent Registry.
Seleziona la scheda Server MCP.
Fai clic su Aggiungi server MCP.
Nel riquadro Dettagli server MCP, inserisci il nome visualizzato, una descrizione e la regione geografica.
Nella sezione Tool specification (Specifica dello strumento), inserisci l'URL dell'endpoint del server MCP e incolla i contenuti del file toolspec.json. Puoi anche fare clic su Importa strumenti in questo pannello per importare gli strumenti MCP dall'URL.
Fai clic su Avanti.

Il riquadro Seleziona strumenti MCP mostra un elenco di strumenti con nomi e descrizioni del server MCP.
Seleziona tutti gli strumenti MCP che vuoi includere. Puoi filtrare gli strumenti dall'elenco in base al nome o al valore.
Fai clic su Salva.

gcloud

Registra il server MCP con la specifica dello strumento:

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

Sostituisci quanto segue:

SERVER_NAME: il nome che vuoi assegnare al server MCP, ad esempio custom-mcp-server.
PROJECT_ID: l'ID progetto.
REGION: la regione del registro.
DISPLAY_NAME: il nome leggibile che vuoi assegnare al server, ad esempio Custom MCP Server.
SERVER_URL: l'URL dell'endpoint del server MCP, ad esempio https://api.example.com/mcp.
PROTOCOL: l'associazione del protocollo per l'endpoint. I valori validi sono JSONRPC, HTTP_JSON o GRPC. Per i server MCP, questo valore è spesso JSONRPC.

Verifica la registrazione

Elenca, filtra e visualizza i dettagli del server MCP appena registrato. Per verificare che il server MCP sia stato registrato correttamente, puoi elencare i server nel registro.