Administra servidores y herramientas de MCP

Agent Registry te permite inspeccionar, actualizar y quitar servidores y herramientas registrados del Protocolo de contexto del modelo (MCP) para que tus agentes tengan esquemas y extremos de herramientas precisos en el entorno de ejecución. Puedes descubrir automáticamente y registrar de forma manual los servidores de MCP, actualizar las definiciones de herramientas registradas de forma manual y quitar los servidores de MCP que ya no se usan.

Antes de comenzar

  1. Configura el Registro de agentes.

  2. Obtén el ID del proyecto para el proyecto de administración en el que está habilitado el Registro de agentes.

  3. Registrar servidores de MCP en Agent Registry

  4. 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 administrar los servidores de MCP y las herramientas en el Agent Registry, pídele a tu administrador que te otorgue los siguientes roles de IAM en el proyecto de administración en el que está habilitado el Agent Registry:

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 los servidores de MCP y las herramientas 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 parámetros de configuración detallados, como sus endpoints y metadatos asociados:

Console

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

    Ir al registro de agentes

  2. En el selector de proyectos, elige el proyecto de Google Cloud 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 entorno 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, ejecuta el comando gcloud agent-registry mcp-servers list:

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

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del proyecto.
  • REGION: Es la región del registro.

Filtrar servidores de MCP registrados

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

Console

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

    Ir al registro de agentes

  2. En el selector de proyectos, selecciona el proyecto de Google Cloud en el que configuraste el Registro de agentes.

  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 entorno 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 que seleccionaste.

gcloud

Filtra tu lista para que solo se muestren los recursos que coincidan con metadatos específicos. Para ello, pasa la marca --filter al comando gcloud agent-registry mcp-servers list:

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

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del proyecto.
  • REGION: Es la región del registro.
  • FILTER_EXPRESSION: Es 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 del servidor de MCP (URN) único a nivel global, usa mcpServerId='urn:mcp:SERVER_URN'.

Terraform

Para recuperar un servidor de MCP registrado específico filtrando sus metadatos, configura la fuente de datos google_agent_registry_mcp_server con el argumento filter:

data "google_agent_registry_mcp_server" "filtered_mcp_server" {
  location = "REGION"
  filter   = "displayName=\"DISPLAY_NAME\""
}

Reemplaza lo siguiente:

  • REGION: Es la región del registro.
  • DISPLAY_NAME: Es el nombre legible por humanos del servidor de MCP por el que se filtrará, por ejemplo, Custom MCP Server.

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 consola de Google Cloud , ve a Agent Registry:

    Ir al registro de agentes

  2. En el selector de proyectos, selecciona el proyecto de Google Cloud en el que configuraste el Registro de agentes.

  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 entorno 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 que puedas crear tus agentes con el Kit de desarrollo de agentes (ADK).
    • Observabilidad: estadísticas sobre el estado operativo y el uso del 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 en Google Cloud Observability para mostrar métricas de rendimiento en tiempo real y el uso 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 la observabilidad.
    • Herramientas: Son las capacidades que proporciona el servidor. En esta pestaña, se enumeran las funciones específicas que expone un servidor de MCP y que los agentes pueden invocar para realizar acciones específicas. Para cada herramienta, la interfaz muestra su esquema, incluidos su nombre, descripción y anotaciones de comportamiento críticas que guían la forma en que 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 compilar tus agentes con el ADK.

gcloud

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

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

Reemplaza lo siguiente:

  • SERVER_NAME: Es el nombre de tu servidor de MCP, por ejemplo, custom-mcp-server.
  • PROJECT_ID: Es el ID del proyecto.
  • REGION: Es la región del registro.

Terraform

Para recuperar detalles sobre un servidor de MCP registrado específico con su ID, configura la fuente de datos google_agent_registry_mcp_server:

data "google_agent_registry_mcp_server" "my_mcp_server" {
  location      = "REGION"
  mcp_server_id = "SERVER_NAME"
}

output "server_create_time" {
  description = "The timestamp when the MCP server was registered."
  value       = data.google_agent_registry_mcp_server.my_mcp_server.create_time
}

output "server_update_time" {
  description = "The timestamp when the MCP server was last updated."
  value       = data.google_agent_registry_mcp_server.my_mcp_server.update_time
}

Reemplaza lo siguiente:

  • REGION: Es la región del registro.
  • SERVER_NAME: Es el identificador único de tu servidor de MCP, por ejemplo, custom-mcp-server.

Actualiza los detalles del servidor y las definiciones de las herramientas

Si tu servidor de MCP agrega herramientas nuevas o cambia los esquemas existentes, debes actualizar el registro para reflejar estos cambios.

En el Registro de agentes, los recursos McpServer son recursos de descubrimiento de solo lectura. En el caso de los servidores de MCP registrados automáticamente, actualiza la implementación o la carga de trabajo en su entorno de ejecución subyacente para que Agent Registry sincronice los cambios. Para actualizar un servidor de MCP registrado de forma manual, debes actualizar su recurso Service escribible directamente. Debido a que el registro no inspecciona automáticamente los servidores de MCP registrados de forma manual, debes subir manualmente la especificación de la herramienta actualizada, que reemplaza las definiciones de herramientas existentes para el servidor.

Console

Actualiza los detalles del servidor disponibles desde la consola de Google Cloud :

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

    Ir al registro de agentes

  2. En el selector de proyectos, selecciona el proyecto de Google Cloud en el que configuraste el Registro de agentes.

  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 entorno de ejecución y la ubicación.

  4. Haz clic en el nombre del servidor que quieres actualizar.

  5. En la pestaña Descripción general del servidor, haz clic en Editar.

  6. En el panel Editar servicio, ingresa la información actualizada de tu servidor, como su nombre o descripción nuevos.

  7. Haz clic en Guardar.

gcloud

Prepara la especificación de tu nueva herramienta. Luego, ejecuta el comando gcloud agent-registry services update con tu archivo JSON actualizado:

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

Reemplaza lo siguiente:

  • SERVER_NAME: Es el nombre de tu servidor de MCP, por ejemplo, custom-mcp-server.
  • PROJECT_ID: Es el ID del proyecto.
  • REGION: Es la región del registro.
  • TOOL_SPEC: Es la ruta de acceso al nuevo archivo de especificación de la herramienta, por ejemplo, new-toolspec.json. El tamaño máximo del archivo de especificación es de 10 KB.

Terraform

Para actualizar los metadatos, la URL del extremo o la especificación de la herramienta de tu servidor de MCP registrado, modifica los parámetros del recurso google_agent_registry_service existente en tu configuración y, luego, ejecuta terraform apply:

resource "google_agent_registry_service" "mcp_server" {
  location     = "REGION"
  service_id   = "SERVER_NAME"
  display_name = "DISPLAY_NAME"
  description  = "Updated description of the MCP server."

  interfaces {
    url              = "SERVER_URL"
    protocol_binding = "JSONRPC"
  }

  mcp_server_spec {
    type    = "TOOL_SPEC"
    content = file("TOOL_SPEC")
  }
}

Reemplaza lo siguiente:

  • REGION: Es la región del registro.
  • SERVER_NAME: Es el nombre de tu servidor de MCP, por ejemplo, custom-mcp-server.
  • DISPLAY_NAME: Es el nombre visible legible por humanos de tu servidor de MCP, por ejemplo, Custom MCP Server.
  • SERVER_URL: Es la URL del extremo del servidor de MCP, por ejemplo, https://api.example.com/mcp.
  • TOOL_SPEC: Es la ruta de acceso al archivo de especificación de la herramienta actualizado, por ejemplo, new-toolspec.json. El tamaño máximo del archivo de especificación es de 10 KB.

Quita un servidor de MCP

Para borrar los servidores de MCP que se registraron automáticamente en Agent Registry, debes borrar el servidor de MCP subyacente o inhabilitar la API de Google Cloud del servidor de MCP en tu proyecto. Luego, el servidor se quita automáticamente del registro.

Para quitar un servidor de MCP registrado de forma manual del registro, debes borrar su recurso Service. Esta acción quita el servidor de MCP de los resultados de la búsqueda y hace que otras herramientas no puedan descubrirlo:

Console

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

    Ir al registro de agentes

  2. En el selector de proyectos, selecciona el proyecto de Google Cloud en el que configuraste el Registro de agentes.

  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 entorno de ejecución y la ubicación.

  4. Haz clic en el nombre del servidor que quieres quitar.

  5. En la pestaña Descripción general del servidor, haz clic en Borrar.

  6. En el cuadro de diálogo de confirmación, ingresa DELETE para confirmar la acción.

  7. Haz clic en Borrar.

gcloud

Ejecuta el comando gcloud agent-registry services delete:

gcloud agent-registry services delete SERVER_NAME \
    --project=PROJECT_ID \
    --location=REGION

Reemplaza lo siguiente:

  • SERVER_NAME: Es el nombre del servidor de MCP que deseas quitar, por ejemplo, my-mcp-server.
  • PROJECT_ID: Es el ID del proyecto.
  • REGION: Es la región del registro.

Terraform

Quita el recurso google_agent_registry_service que representa el servidor de MCP de tu configuración de Terraform y, luego, ejecuta terraform apply.

Administra el acceso a las herramientas

Implementa la administración y la seguridad de nivel empresarial para tus servidores y herramientas de MCP. Usa Agent Registry como tu registro central y Agent Gateway para la aplicación de políticas activas.

Agent Gateway te permite administrar de forma segura las interacciones entre agentes y herramientas, independientemente de si esos agentes se ejecutan en Google Cloud o son herramientas para desarrolladores externas.

Para obtener más información sobre cómo controlar el acceso a las herramientas, consulta los siguientes vínculos: