Administra servidores y herramientas de MCP

Agent Registry te permite descubrir y administrar servidores de Protocolo de contexto del modelo (MCP) y las herramientas específicas que exponen.

Los servidores de MCP oficiales de Google y Google Cloud remotos se registran automáticamente y se incorporan en Agent Registry cuando habilitas la API compatible Google Cloud en tu proyecto. También puedes registrar de forma manual otros servidores de MCP externos. Para obtener más información, consulta Registra servidores de MCP.

En este documento, se describe cómo descubrir herramientas y servidores de MCP registrados, y cómo modificar las definiciones de tus herramientas.

Antes de comenzar

Antes de que puedas administrar servidores y herramientas de MCP, registra los servidores de MCP en Agent Registry. También necesitas el ID de tu 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 administrar servidores y herramientas de MCP en Agent Registry, pídele a tu administrador que te otorgue los siguientes roles de IAM 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.

Descubre servidores y herramientas de MCP disponibles

Después de registrar los servidores de MCP, puedes descubrirlos para vincularlos a tus agentes.

Enumera todos los servidores de MCP disponibles

Puedes enumerar todos los servidores de MCP registrados en tu entorno y ver sus configuraciones detalladas, como sus extremos y metadatos asociados:

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.

    En la página, se muestra una lista de todos los servidores de MCP registrados y sus detalles, como el nombre, el identificador, la descripción, el tiempo de ejecución y la ubicación.

  4. Para ver los detalles completos de un servidor, haz clic en su nombre.

gcloud

Para enumerar todos los servidores de MCP en una ubicación específica, usa el comando mcp-servers list:

gcloud alpha agent-registry mcp-servers list \
  --project=PROJECT_ID \
  --location=REGION

Reemplaza lo siguiente:

  • PROJECT_ID: El ID del proyecto
  • REGION: La región del registro

Filtra los servidores de MCP registrados

Si tienes varios servidores o si deseas confirmar el registro de un servidor específico, puedes filtrar la lista por los metadatos del servidor:

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.

    En la página, se muestra una lista de todos los servidores de MCP registrados y sus detalles, como el nombre, el identificador, la descripción, el tiempo de ejecución y la ubicación.

  4. Para filtrar por ubicación, haz clic en el menú Ubicación , selecciona las ubicaciones que deseas filtrar y haz clic en Aplicar.

    En la página, se muestra una lista filtrada de los servidores de MCP registrados para las condiciones seleccionadas.

gcloud

Filtra tu lista para mostrar solo los recursos que coinciden con metadatos específicos con la marca --filter:

gcloud alpha agent-registry mcp-servers list \
  --project=PROJECT_ID \
  --location=REGION \
  --filter="FILTER_EXPRESSION"

Reemplaza FILTER_EXPRESSION por la expresión de filtro para los servidores de MCP que deseas filtrar. Por ejemplo, puedes usar los siguientes filtros:

  • Para filtrar por nombre visible, usa displayName='DISPLAY_NAME'.
  • Para buscar por el identificador único a nivel global identificador (URN), usa mcpServerId='urn:mcp:SERVER_URN'.

Consulta los detalles de un servidor de MCP

Consulta los detalles de un servidor de MCP específico, por ejemplo, sus herramientas:

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.

    En la página, se muestra una lista de todos los servidores de MCP registrados y sus detalles, como el nombre, el identificador, la descripción, el tiempo de ejecución y la ubicación.

  4. Haz clic en el nombre del servidor de MCP que deseas ver.

    La página de detalles incluye pestañas para los detalles del servidor de MCP.

  5. Haz clic en la pestaña correspondiente para ver los detalles específicos del servidor de MCP:

    • Descripción general: Detalles principales del servidor de MCP, incluidos el nombre, el identificador, la ubicación y la descripción del servidor. En la descripción general, también se muestra un fragmento de código para permitirte crear tus agentes con el Kit de desarrollo de agentes (ADK).
    • Observabilidad: Estadísticas sobre el estado operativo y el uso de l servidor de MCP. Muestra métricas centradas en la aplicación, como la latencia, el tráfico, los errores y el gasto de tokens. Esta pestaña se integra con Google Cloud Observability para mostrar métricas de rendimiento en tiempo real y la utilización a nivel del sistema para ayudarte a administrar los costos, depurar problemas y hacer un seguimiento de la experiencia del usuario. Para obtener más información, consulta la Descripción general de Observability.
    • Herramientas: El catálogo de capacidades que proporciona el servidor. En esta pestaña, se enumeran las funciones específicas que expone un servidor de MCP que los agentes pueden invocar para realizar acciones específicas. Para cada herramienta, la interfaz muestra su esquema, incluido su nombre, descripción y anotaciones de comportamiento críticas que guían cómo un agente de organización debe interactuar con ella. Haz clic en el nombre de una herramienta para mostrar un fragmento de código que te permita crear tus agentes con el ADK.

gcloud

Para ver los metadatos detallados de un servidor de MCP específico, usa el comando mcp-servers describe:

gcloud alpha agent-registry mcp-servers describe SERVER_NAME \
  --project=PROJECT_ID \
  --location=REGION

Reemplaza SERVER_NAME por el nombre de tu servidor de MCP, por ejemplo, custom-mcp-server.

Actualiza las definiciones de herramientas

Si tu servidor de MCP agrega herramientas nuevas o cambia los esquemas existentes, debes actualizar el registro para reflejar estos cambios. Debido a que el registro no inspecciona automáticamente los servidores de MCP, debes subir de forma manual la especificación de la herramienta actualizada. El contenido que subas reemplazará las definiciones de herramientas existentes para este servicio.

Para la API de Agent Registry, los recursos McpServer se usan para el descubrimiento. Por lo tanto, debes actualizar el recurso Service registrado directamente.

Prepara la nueva especificación de la herramienta. Luego, actualiza tu archivo JSON con las definiciones de herramientas más recientes:

gcloud alpha agent-registry services update SERVER_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --mcp-server-spec-content=@TOOL_SPEC

Reemplaza lo siguiente:

  • SERVER_NAME: El nombre de tu servidor de MCP, por ejemplo, custom-mcp-server.
  • PROJECT_ID: El ID del proyecto
  • REGION: La región del registro
  • TOOL_SPEC: El nombre de la nueva especificación de la herramienta, por ejemplo, new-toolspec.json.