Administra servidores y herramientas de MCP

Agent Registry te permite descubrir y administrar servidores de Model Context Protocol (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 del proyecto para realizar estas tareas.

Para usar los comandos de gcloud CLI en este documento, asegúrate de haber configurado tu Google Cloud CLI Cloud.

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 mediante 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 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 que solo muestre los recursos que coinciden con metadatos específicos, usando el indicador --filter:

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

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: La región del registro
  • DISPLAY_NAME: El nombre legible por humanos del servidor de MCP por el que se filtrará, por ejemplo, Custom MCP Server

Visualiza los detalles de un servidor de MCP

Visualiza 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 compilar 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 y 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 debe interactuar con ella un agente de organización. 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, usa el comando mcp-servers describe:

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

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: La región del registro
  • SERVER_NAME: El identificador único de tu servidor de MCP, por ejemplo, custom-mcp-server

Actualiza los detalles del servidor y 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 herramientas actualizada. El contenido que subas reemplazará las definiciones de herramientas existentes para este servidor.

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

Console

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

  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 que deseas 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 nuevo nombre o descripción.

  7. Haz clic en Guardar.

gcloud

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

gcloud 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 herramientas, por ejemplo, new-toolspec.json El tamaño máximo del archivo de especificación es de 10 KB.

Terraform

Terraform solo admite el tipo NO_SPEC para los servidores de MCP. No puedes configurar las especificaciones de herramientas en línea. Para actualizar las definiciones de herramientas de tu servidor de MCP, usa la Google Cloud consola, gcloud CLI o la API de Agent Registry.

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 Google Cloud API del servidor de MCP en tu proyecto. Luego, el servidor se quitará automáticamente del registro.

Para quitar un servidor de MCP registrado de forma manual del registro, debes borrar el recurso Service subyacente. 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 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 que deseas quitar.

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

  6. En el diálogo de confirmación, escribe BORRAR para confirmar la acción.

  7. Haz clic en Borrar.

gcloud 

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

Reemplaza lo siguiente:

  • SERVER_NAME: El nombre del servidor de MCP que deseas quitar, por ejemplo, my-mcp-server
  • PROJECT_ID: El ID del proyecto
  • REGION: 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 el catálogo centralizado y Agent Gateway para la aplicación activa de políticas.

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 de desarrollador externas.

Para obtener más información sobre la administración del acceso a las herramientas, consulta lo siguiente: