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 te permite registrar servidores del Protocolo de contexto del modelo (MCP) de forma automática o manual para que los desarrolladores y los agentes de organización puedan descubrir y llamar a herramientas estandarizadas en todo tu ecosistema de IA.

El registro automático de los servidores de MCP personalizados implementados en Google Kubernetes Engine (GKE) o Cloud Run solo descubre los recursos implementados en el proyecto de administración en el que está habilitado Agent Registry. Para registrar servidores de MCP personalizados implementados en proyectos de Google Cloud independientes o alojados de forma externa, consulta Registra servidores de MCP externos.

Detección automática de servidores de MCP

Los servidores de MCP remotos de Google y Google Cloud se registran y se transfieren automáticamente a Agent Registry.

Cuando habilitas una API de Google Cloud con compatibilidad con MCP en tu proyecto, como la API de Compute Engine, el servidor de MCP correspondiente y sus herramientas se registran de inmediato y se ponen a disposición para su descubrimiento en el Registro de agentes. No es necesario que configures ni subas manualmente las especificaciones de las herramientas para estos servidores.

Ubicación y condiciones

Cuando Agent Registry registra automáticamente un servidor de MCP remoto de Google o de Google Cloud, crea el recurso McpServer solo en la ubicación global, no en regiones individuales como us-central1. Si el servicio proporciona extremos regionales (REP), el Registro de agentes incluye esas URLs regionales en el campo interfaces de ese único recurso global McpServer.

Debido a que el recurso registrado de forma automática solo existe en global, ten en cuenta las siguientes condiciones cuando consultes el servidor o configures las políticas de acceso de Identity-Aware Proxy (IAP):

Usa global para los servidores registrados automáticamente: Especifica la ubicación de global cuando consultes el servidor en el Registro de agentes con --location=global o le apliques políticas de IAP con --region=global. Si especificas una región como us-central1, el comando devuelve un error NOT_FOUND porque no existe ningún recurso McpServer regional allí de forma predeterminada.
Registra manualmente en una región para la residencia de datos: Si necesitas conservar los metadatos del registro en una región específica, registra manualmente el servidor de MCP y su URL de extremo regional en esa región y, luego, aplica tu política de IAP en esa misma región.

Para obtener más información, consulta Alcance de la administración en ubicaciones regionales y globales y No se encontró el servidor de MCP remoto en una ubicación regional.

Antes de comenzar

Configura el Registro de agentes.
Obtén el ID del proyecto para el proyecto de administración en el que está habilitado el Registro de agentes.
Para usar los comandos de Google Cloud CLI en este documento, configura tu entorno de gcloud CLI.

Roles obligatorios

Para obtener los permisos que necesitas para registrar servidores de MCP en el Registro de agentes, pídele a tu administrador que te otorgue el rol de IAM de editor de la API de Agent Registry (roles/agentregistry.editor) en el proyecto de administración en el que está habilitado el Registro de agentes. 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.

Registra servidores de MCP desde GKE

Para registrar servidores de MCP personalizados implementados en GKE, agrega las etiquetas y anotaciones de Kubernetes requeridas a tu manifiesto de implementación. En el siguiente ejemplo, se muestra un manifiesto de implementación del servidor de MCP de GKE configurado para el registro automático:

apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-mcp-server
  labels:
    # GKE takes this label and registers the deployment as an MCP server
    registry.gke.io/functional-type: "MCP_SERVER"
  annotations:
    # 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
      annotations:
        # Agent Identity annotation for identity and access management
        iam.gke.io/spiffe-identity-type: agent-identity
    spec:
      containers:
      - name: server
        image: gcr.io/PROJECT_ID/my-mcp-server:1.0.0

Reemplaza PROJECT_ID por el ID del proyecto de Google Cloud .

Para configurar y aplicar el manifiesto de implementación, haz lo siguiente:

En metadata.labels del manifiesto de Deployment, agrega la etiqueta registry.gke.io/functional-type: "MCP_SERVER".

Nota: GKE también admite la anotación apphub.cloud.google.com/functional-type: "MCP_SERVER" para la retrocompatibilidad. Sin embargo, usa la etiqueta registry.gke.io/functional-type: "MCP_SERVER" para tus implementaciones de GKE.
En metadata.annotations del manifiesto de Deployment, habilita el descubrimiento automatizado de tus herramientas de MCP proporcionando las anotaciones modelcontextprotocol.info/urls y modelcontextprotocol.info/capabilities para declarar las URLs de los extremos del servidor y los detalles de las capacidades.
En spec.template.metadata.annotations de la plantilla del Pod, habilita la comunicación autenticada configurando Agent Identity con la anotación iam.gke.io/spiffe-identity-type: agent-identity.
Aplica el manifiesto de Deployment a tu clúster.

Cuando aplicas la implementación, GKE intenta obtener automáticamente la especificación de la herramienta del servidor y registra el servidor y sus herramientas directamente en un recurso de descubrimiento McpServer de solo lectura en 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 registrar automáticamente servidores de MCP personalizados cuando los implementas como servicios de Cloud Run especificando la marca --functional-type=mcp-server. La marca --functional-type=mcp-server identifica el servicio de Cloud Run como un servidor de MCP, en lugar de una carga de trabajo estándar alojada en contenedores, lo que indica a Cloud Run que registre el servidor en Agent Registry. Durante el registro, Cloud Run agrega automáticamente el nombre del servidor y el tipo MCP_SERVER al registro.

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

Para configurar el registro automático en un servicio de Cloud Run nuevo o existente, consulta Configura las funciones de Gemini Enterprise Agent Platform para Cloud Run. Para implementar y proteger servidores de MCP en Cloud Run, consulta Aloja servidores de MCP en Cloud Run y Autentica servidores de MCP.

Registra servidores de MCP externos

Para administrar y reutilizar las herramientas que proporcionan los servidores externos o las APIs personalizadas, debes registrar manualmente 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 las herramientas durante el registro subiendo un archivo toolspec.json.

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 de 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 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 al registro de agentes
En el selector de proyectos, selecciona el proyecto de Google Cloud en el que configuraste el Registro de agentes.
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 de extremo de tu servidor de MCP se aloja públicamente en Internet. No puedes usar esta función para importar herramientas de 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 componente. Para obtener una asignación completa de las marcas a las colecciones de recursos, consulta [Recursos de servicio y recursos de descubrimiento](/agent-registry/data-model#service-resources).

Registra el servidor de MCP con la especificación de la herramienta con el comando gcloud agent-registry services create:

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. El nombre debe tener entre 4 y 63 caracteres, y solo puede contener letras minúsculas, números y guiones.
PROJECT_ID: Es el ID del proyecto.
REGION: Es la región del registro.
DISPLAY_NAME: Es el nombre legible por humanos que quieres darle 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. Para los servidores de MCP, este valor suele ser jsonrpc.

Terraform

El bloque de especificación que configures determina a qué colección de recursos pertenece tu componente. Para obtener una asignación completa de las especificaciones a las colecciones de recursos, consulta [Recursos de servicio y recursos de descubrimiento](/agent-registry/data-model#service-resources).

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 McpServer resource name."
  value       = google_agent_registry_service.mcp_server.registry_resource
}