Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Cómo registrar servidores de MCP

Agent Registry actúa como un catálogo centralizado, ya que registra y administra los extremos del servidor del Protocolo de contexto del modelo (MCP) y las herramientas específicas que exponen.

En este documento, se describe cómo registrar servidores de MCP y cómo se administran sus especificaciones de herramientas en Agent Registry.

Descubrimiento automático de Google Cloud servidores de MCP

Los servidores de MCP oficiales de Google y Google Cloud remotos se registran automáticamente y se incorporan en Agent Registry. Los servidores de MCP oficiales de Google y Google Cloud remotos disponibles se enumeran en Productos compatibles de la Google Cloud documentación de los servidores de MCP.

Cuando habilitas una API Google Cloud compatible en tu proyecto, como la API de Compute Engine, el servidor de MCP correspondiente y sus herramientas se registran de inmediato y están disponibles para el descubrimiento en Agent Registry. No es necesario configurar ni subir manualmente las especificaciones de herramientas para estos servidores.

Alcance y vinculaciones para servidores de MCP administrados por Google

Los servidores de MCP remotos administrados por Google se registran automáticamente en la ubicación global de tu proyecto. Debido a que estos servidores integrados de Google residen de forma global, debes aplicarles cualquier vinculación de Identity and Access Management (IAM) en el alcance global especificando la marca --region=global. Las vinculaciones de IAM regionales, como --region=us-central1, no son compatibles con estos servidores de MCP remotos globales y muestran un error NOT_FOUND.

Registra servidores de MCP desde GKE

Puedes configurar el registro automático para servidores de MCP personalizados implementados en Google Kubernetes Engine (GKE) agregando la etiqueta registry.gke.io/functional-type: "MCP_SERVER" a tus implementaciones de GKE.

Para permitir que Agent Registry realice un análisis de introspección y descubra tus herramientas de MCP, tu implementación también debe incluir anotaciones que declaren las URLs de extremo del servidor y los detalles de capacidad. Además, configura Workload Identity con la anotación iam.gke.io/spiffe-identity-type: agent-identity para ayudar a habilitar la comunicación autenticada segura.

En el siguiente ejemplo, se muestra un manifiesto de implementación del servidor de MCP de GKE con estas configuraciones.

apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-mcp-server
  labels:
    # GKE takes this label and registers the deployment as an MCP server to the registry
    registry.gke.io/functional-type: "MCP_SERVER"
  annotations:
    # A list of endpoint URLs where the GKE controller can access this MCP server
    modelcontextprotocol.info/urls: |
      - https://my-mcp-server.default.svc.cluster.local/mcp
    # Defines structural capabilities for the MCP server card
    modelcontextprotocol.info/capabilities: |
      card:
        endpoint: "/mcp"
        protocol: "HTTP"
spec:
  selector:
    matchLabels:
      app: my-mcp-server
  template:
    metadata:
      annotations:
        # Workload Identity annotation for identity and access management
        iam.gke.io/spiffe-identity-type: agent-identity
      labels:
        app: my-mcp-server
    spec:
      containers:
      - name: server
        image: gcr.io/my-project/my-mcp-server:1.0.0

Cuando aplicas la implementación, GKE intenta obtener automáticamente la especificación de la herramienta del servidor y registra las herramientas directamente en el modelo de datos de Agent Registry.

Registra servidores de MCP externos

Para administrar y reutilizar las herramientas que proporcionan los servidores externos o las APIs personalizadas, debes registrar explícitamente el servidor de MCP.

Cuando registras un servidor de MCP de forma manual, Agent Registry registra el extremo. Sin embargo, no realiza la introspección del servidor automáticamente para determinar qué herramientas están disponibles. Para permitir que los usuarios descubran las herramientas exactas disponibles en tu servidor de MCP, debes proporcionar las especificaciones de herramientas durante el registro subiendo un archivo toolspec.json.

Antes de comenzar

Antes de comenzar, configura Agent Registry. Necesitarás el ID del proyecto para realizar estas tareas.

Para usar los comandos de gcloud CLI en este documento, asegúrate de haber configurado tu Google Cloud CLI Cloud.

Roles obligatorios

Para obtener los permisos que necesitas para registrar servidores de MCP de forma manual en Agent Registry, pídele a tu administrador que te otorgue el rol de IAM Editor de la API de Agent Registry (roles/agentregistry.editor) en el proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios mediante roles personalizados o cualquier otro rol predefinido.

Prepara la especificación de tu herramienta

Crea un archivo toolspec.json que describa las herramientas que proporciona el servidor. El tamaño máximo del archivo para este archivo de especificación es de 10 KB.

El archivo JSON debe alinearse con la especificación de MCP para los esquemas de herramientas, por ejemplo:

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

Para obtener requisitos estructurales detallados, consulta Esquemas JSON y la referencia de REST.

Registra el servidor y las herramientas

Registra el servidor de MCP y sube la definición de la herramienta de forma simultánea:

Console

En la Google Cloud consola, ve a Agent Registry:

Ir a Agent Registry
En el selector de proyectos, selecciona el Google Cloud proyecto en el que configuraste Agent Registry.
Selecciona la pestaña Servidores de MCP.
Haz clic en Agregar servidor de MCP.
En el panel Detalles del servidor de MCP , ingresa el nombre visible, una descripción y la región geográfica.
En la sección Especificación de la herramienta, ingresa la URL del extremo del servidor de MCP y pega el contenido de tu archivo toolspec.json.

De manera opcional, haz clic en Importar herramientas en este panel para importar las herramientas de MCP desde la URL. Esta opción solo funciona si la URL del extremo de tu servidor de MCP está alojada de forma pública en Internet. No puedes usar esta función para importar herramientas desde servidores de MCP alojados de forma privada.
Haz clic en Siguiente.

En el panel Seleccionar herramientas de MCP , se muestra una lista de herramientas con nombres y descripciones de tu servidor de MCP.
Selecciona todas las herramientas de MCP que deseas incluir. Puedes filtrar las herramientas de la lista por nombre o valor.
Haz clic en Guardar.

gcloud

Registra el servidor de MCP con la especificación de la herramienta:

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

Reemplaza lo siguiente:

SERVER_NAME: El nombre que deseas asignar a tu servidor de MCP, por ejemplo, custom-mcp-server.
PROJECT_ID: El ID del proyecto
REGION: La región del registro
DISPLAY_NAME: El nombre legible por humanos que deseas asignar a tu servidor, por ejemplo, Custom MCP Server.
SERVER_URL: La URL del extremo del servidor de MCP, por ejemplo, https://api.example.com/mcp.
PROTOCOL: La vinculación de protocolo para el extremo. Los valores válidos son jsonrpc, http-json o grpc. Para los servidores de MCP, este valor suele ser jsonrpc.

Terraform

Para registrar un servidor de MCP y especificar sus herramientas, configura un recurso google_agent_registry_service con el bloque 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    = "TOOL_SPEC"
    content = file("toolspec.json")
  }
}

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