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 degli strumenti all'interno del registry dell'agente.

Rilevamento automatico dei server MCP Google Cloud

I server MCP ufficiali di Google e Google Cloud remoti vengono registrati automaticamente e inseriti in Agent Registry. I server MCP di Google e Google Cloud remoti disponibili sono elencati in Prodotti supportati nella Google Cloud documentazione sui server 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 nel registry degli agenti. Non è necessario configurare o caricare manualmente le specifiche degli strumenti per questi server.

Registra server MCP esterni

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

Quando registri manualmente un server MCP, il registry degli agenti 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.

Preparare le specifiche dello strumento

Crea un file toolspec.json che descriva gli strumenti forniti dal server. La dimensione massima del file per questo file di specifica è 10 kB.

Il 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

  1. Nella console Google Cloud , vai a Registro agenti:

    Vai al registry degli agenti

  2. Nel selettore di progetti, seleziona il Google Cloud progetto in cui hai configurato Agent Registry.

  3. Seleziona la scheda Server MCP.

  4. Fai clic su Aggiungi server MCP.

  5. Nel riquadro Dettagli server MCP, inserisci il nome visualizzato, una descrizione e la regione geografica.

  6. Nella sezione Tool specification (Specifica dello strumento), inserisci l'URL dell'endpoint del server MCP e incolla i contenuti del file toolspec.json.

    (Facoltativo) Fai clic su Importa strumenti in questo riquadro per importare gli strumenti MCP dall'URL. Questa opzione funziona solo se l'URL dell'endpoint del server MCP è ospitato pubblicamente su internet. Non puoi utilizzare questa funzionalità per importare strumenti da server MCP ospitati privatamente.

  7. Fai clic su Avanti.

    Il riquadro Seleziona strumenti MCP mostra un elenco di strumenti con nomi e descrizioni del tuo server MCP.

  8. Seleziona tutti gli strumenti MCP che vuoi includere. Puoi filtrare gli strumenti dall'elenco per nome o valore.

  9. 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 di 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 registry.