MCP Reference: vectorsearch.googleapis.com

Servidor de MCP para Agent Retrieval (antes Vector Search 2.0), que proporciona herramientas para ver y consultar colecciones, índices y realizar búsquedas.

Un servidor de Protocolo de contexto del modelo (MCP) actúa como un proxy entre un servicio externo que proporciona contexto, datos o capacidades a un modelo de lenguaje grande (LLM) o una aplicación de IA. Los servidores de MCP conectan las aplicaciones de IA a sistemas externos, como bases de datos y servicios web, y traducen sus respuestas a un formato que la aplicación de IA pueda entender.

Configuración del servidor

Debes habilitar los servidores de MCP y configurar la autenticación antes de usarlos. Para obtener instrucciones de configuración específicas del producto, consulta Usa el servidor de MCP remoto de Agent Retrieval. Para obtener información general sobre el uso de los servidores de MCP remotos de Google y Google Cloud, consulta Descripción general de los servidores de MCP de Google Cloud.

Extremos del servidor

Un extremo de servicio de MCP es la dirección de red y la interfaz de comunicación (por lo general, una URL) del servidor de MCP que una aplicación de IA (el host del cliente de MCP) usa para establecer una conexión segura y estandarizada. Es el punto de contacto para que el LLM solicite contexto, llame a una herramienta o acceda a un recurso. Los extremos de MCP de Google pueden ser globales o regionales.

El servidor de MCP de recuperación de agentes (API de Vector Search) expone un único extremo de MCP:

  • https://vectorsearch.googleapis.com/mcp

Herramientas de MCP

Una herramienta de MCP es una función o capacidad ejecutable que un servidor de MCP expone a un LLM o una aplicación de IA para realizar una acción en el mundo real.

Actualmente, el servidor de MCP de recuperación de agentes expone las siguientes herramientas en el único extremo /mcp. Si usas el protocolo sin estado de MCP 2026-07-28, cada solicitud tools/call también debe incluir un encabezado HTTP Mcp-Name cuyo valor sea igual a params.name (y Mcp-Param-Region para el enrutamiento regional directo; consulta Enrutamiento basado en encabezados); no envíes Mcp-Name con tools/list. También se aceptan las solicitudes que usan versiones anteriores del protocolo MCP, como las muestras de curl en las páginas de herramientas (con un encabezado Authorization: Bearer).

  • list_collections: Enumera las colecciones de Vector Search en un proyecto y una ubicación.
  • get_collection: Recupera el esquema y los metadatos de una colección específica.
  • list_indexes: Enumera los índices definidos en una colección.
  • get_index: Recupera la configuración de un índice específico.
  • get_data_object: Recupera un objeto de datos por ID de una colección.
  • search_data_objects: Ejecuta una búsqueda de vectores, semántica o de texto en una colección.
  • query_data_objects: Enumera los objetos de datos que coinciden con una expresión de filtro.
  • batch_search_data_objects: Ejecuta varias búsquedas en paralelo y combina los resultados con la fusión por clasificación recíproca (RRF) o la API de Vertex Ranking.
  • aggregate_data_objects: Agrega objetos de datos que coinciden con una expresión de filtro (por ejemplo, recuentos).

Obtén las especificaciones de la herramienta de MCP

Para obtener las especificaciones de todas las herramientas de un servidor de MCP, usa el método tools/list. El servidor de MCP de la API de Vector Search admite el protocolo sin estado MCP 2026-07-28: cada solicitud se describe a sí misma y, además, incluye la versión del protocolo en el encabezado HTTP MCP-Protocol-Version y el campo del cuerpo params._meta.io.modelcontextprotocol/protocolVersion, un encabezado Mcp-Method que coincide con el method de JSON-RPC y un objeto params._meta.io.modelcontextprotocol/clientCapabilities (se acepta un objeto vacío). En el siguiente ejemplo de curl, se enumeran todas las herramientas y sus especificaciones.

Solicitud de curl 
curl -X POST 'https://vectorsearch.googleapis.com/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'MCP-Protocol-Version: 2026-07-28' \
  -H 'Mcp-Method: tools/list' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {
      "_meta": {
        "io.modelcontextprotocol/protocolVersion": "2026-07-28",
        "io.modelcontextprotocol/clientCapabilities": {}
      }
    }
  }'