Cómo registrar servidores de MCP

Vista previa

Este producto o esta función se encuentra sujeto a las "Condiciones de la oferta de la fase previa a la DG" en la sección Condiciones del servicio generales de las Condiciones específicas del servicio. Los productos y las funciones de la fase previa a la DG están disponibles “tal como están” y pueden estar sujetos a asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

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.

Nota: El registro manual no es compatible con las ubicaciones multirregionales us y eu. Debes registrar los recursos en una región compatible o en la global ubicación. Para obtener más información, consulta Ubicaciones de 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 transfieren a Agent Registry. Los servidores de MCP de Google y Google Cloud remotos disponibles se enumeran en Productos compatibles de laGoogle 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 servicios.

Nota: Si tu organización usa el centro de APIs de Apigee, puedes configurarlo para que sincronice automáticamente tus APIs con estilo de MCP en Agent Registry. Asegúrate de que la sincronización esté habilitada en el centro de APIs para conservar los datos de la API de MCP importados en Agent Registry. Para obtener más información, consulta Registra APIs de MCP.

Registra servidores de MCP externos

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

Antes de comenzar

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

Para usar los comandos de gcloud CLI en este documento, asegúrate de haber configurado 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 la especificación de la herramienta

Crea un archivo toolspec.json que describa las herramientas que proporciona el servidor. Este 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 información detallada sobre los requisitos estructurales, consulta Esquemas JSON y la referencia de REST.

**Importante:** El archivo de especificación de herramientas que subas no debe superar los 10 KB.

Registra el servidor y las herramientas

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

Console

1. En la Google Cloud consola, ve a Agent Registry:

   Ir a Agent Registry

2. En el selector de proyectos, selecciona el Google Cloud proyecto en el que configuraste Agent Registry.

3. Selecciona la pestaña Servidores de MCP.

4. Haz clic en Agregar servidor de MCP.

5. En el panel Detalles del servidor de MCP , ingresa el nombre visible, una descripción y la región geográfica.

6. 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. También puedes hacer clic en Importar herramientas en este panel para importar las herramientas de MCP desde la URL.

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

8. Selecciona todas las herramientas de MCP que deseas incluir. Puedes filtrar las herramientas de la lista por nombre o valor.

9. Haz clic en Guardar.

gcloud

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

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

Reemplaza lo siguiente:

• SERVER_NAME: Es el nombre que deseas asignarle a tu servidor de MCP, por ejemplo, custom-mcp-server.
• PROJECT_ID: Es 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 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.

Verifica el registro

Enumera, filtra y visualiza los detalles de tu servidor de MCP recién registrado. Para confirmar que tu servidor de MCP se registró correctamente, puedes enumerar los servidores en tu registro.