Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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 las especificaciones de sus herramientas en Agent Registry.

Descubrimiento automático de servidores Google Cloud MCP

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

Cuando habilitas una API compatible Google Cloud 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.

Registra 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 se registra un servidor de MCP de forma manual, Agent Registry registra el extremo. Sin embargo, no introspecciona 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 el registro de agentes. 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 la 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 proyecto en el que configuraste Agent Registry. Google Cloud
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 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

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 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

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    = "NO_SPEC"
  }
}

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