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 endpoints 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 servidores Google Cloud MCP

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

Cuando habilitas una API de 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 su descubrimiento en el Registro de agentes. No es necesario que configures ni subas manualmente las especificaciones de las herramientas para estos servidores.

Alcance y vinculaciones para los servidores de MCP administrados por Google

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

Cómo registrar servidores de MCP desde GKE

Puedes configurar el registro automático para los 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 los extremos del servidor y los detalles de las capacidades.

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:
      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 automáticamente obtener la especificación de la herramienta del servidor y registra las herramientas directamente en el modelo de datos de Agent Registry. Agent Registry usa el nombre de tu implementación como el nombre visible del servidor de MCP.

Registra servidores de MCP desde Cloud Run

Puedes configurar el registro automático para los servidores de MCP personalizados implementados en Cloud Run especificando la marca --functional-type=mcp-server cuando los implementes.

Cuando implementas un servicio de Cloud Run con --functional-type=mcp-server, se registra en el catálogo de servidores de MCP en Agent Registry. Durante el registro, Cloud Run registra el nombre y el tipo del servidor (MCP_SERVER).

También puedes especificar un tipo de identidad con la marca --identity-type. Por ejemplo, especifica una identidad de agent-identity o service-account. Si no se especifica, la carga de trabajo usará de forma predeterminada una identidad de cuenta de servicio.

Para obtener información sobre cómo implementar un servicio de servidor de MCP en Cloud Run, consulta Configura funciones de Agent Platform para Cloud Run.

Para obtener más información, consulta Aloja servidores de MCP en Cloud Run y Autentica servidores de MCP.

El registro automático solo descubre los recursos implementados en el mismo proyecto deGoogle Cloud .

Cómo registrar servidores MCP externos

Para administrar y reutilizar las herramientas proporcionadas por servidores externos o 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 inspecciona automáticamente el servidor 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 la herramienta 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 configurar tu entorno de Google Cloud CLI.

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 a través de roles personalizados o cualquier otro rol predefinido.

Prepara las especificaciones de tu herramienta

Crea un archivo toolspec.json que describa las herramientas que proporciona el servidor. El tamaño máximo del 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 conocer los requisitos estructurales detallados, consulta los 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 consola de Google Cloud , 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 del MCP desde la URL. Esta opción solo funciona si la URL del extremo de tu servidor de MCP está alojada públicamente 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 quieras incluir. Puedes filtrar las herramientas de la lista por nombre o valor.
Haz clic en Guardar.

gcloud

Las marcas de especificación que usas determinan a qué colección de recursos pertenece tu servicio. Para obtener una asignación completa de las marcas a las colecciones de recursos, consulta Recursos de la API.

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: Es el nombre que deseas asignarle a tu servidor de MCP, por ejemplo, custom-mcp-server.
PROJECT_ID: El ID del proyecto
REGION: Es la región del registro.
DISPLAY_NAME: Es el nombre legible por humanos que deseas asignarle a tu servidor, por ejemplo, Custom MCP Server.
SERVER_URL: Es la URL del extremo del servidor de MCP, por ejemplo, https://api.example.com/mcp.
PROTOCOL: Es la vinculación del protocolo para el extremo. Los valores válidos son jsonrpc, http-json o grpc. En el caso de los servidores de MCP, este valor suele ser jsonrpc.

Terraform

El bloque de especificación que configuras, por ejemplo, mcp_server_spec, determina a qué colección de recursos pertenece tu servicio. Para obtener una asignación completa de las especificaciones a las colecciones de recursos, consulta Recursos de API.

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
}