MCP Reference: vectorsearch.googleapis.com

Serveur MCP pour Agent Retrieval (anciennement Vector Search 2.0), fournissant des outils pour afficher et interroger des collections et des index, et effectuer des recherches.

Un serveur MCP (Model Context Protocol) sert de proxy entre un service externe qui fournit du contexte, des données ou des capacités à un grand modèle de langage (LLM) ou à une application d'IA. Les serveurs MCP connectent les applications d'IA à des systèmes externes tels que des bases de données et des services Web, et traduisent leurs réponses dans un format que l'application d'IA peut comprendre.

Configuration du serveur

Vous devez activer les serveurs MCP et configurer l'authentification avant de les utiliser. Pour obtenir des instructions de configuration spécifiques au produit, consultez Utiliser le serveur MCP distant Agent Retrieval. Pour obtenir des informations générales sur l'utilisation des serveurs MCP distants Google et Google Cloud, consultez Présentation des serveurs MCP Google Cloud.

Points de terminaison du serveur

Un point de terminaison de service MCP est l'adresse réseau et l'interface de communication (généralement une URL) du serveur MCP qu'une application d'IA (l'hôte du client MCP) utilise pour établir une connexion sécurisée et standardisée. Il s'agit du point de contact permettant au LLM de demander du contexte, d'appeler un outil ou d'accéder à une ressource. Les points de terminaison Google MCP peuvent être globaux ou régionaux.

Le serveur MCP Agent Retrieval (API Vector Search) expose un seul point de terminaison MCP :

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

Outils MCP

Un outil MCP est une fonction ou une capacité exécutable qu'un serveur MCP expose à un LLM ou à une application d'IA pour effectuer une action dans le monde réel.

Le serveur MCP de récupération d'agent expose actuellement les outils suivants sur le point de terminaison /mcp unique. Si vous utilisez le protocole sans état MCP 2026-07-28, chaque requête tools/call doit également inclure un en-tête HTTP Mcp-Name dont la valeur est égale à params.name (et Mcp-Param-Region pour le routage régional direct ; consultez Routage basé sur les en-têtes). N'envoyez pas Mcp-Name avec tools/list. Les requêtes qui utilisent des versions antérieures du protocole MCP, telles que les exemples curl sur les pages d'outils (avec un en-tête Authorization: Bearer), sont également acceptées.

• list_collections : lister les collections Vector Search d'un projet et d'un emplacement.
• get_collection : récupère le schéma et les métadonnées d'une collection spécifique.
• list_indexes : liste les index définis sur une collection.
• get_index : récupère la configuration d'un index spécifique.
• get_data_object : récupère un objet de données par ID à partir d'une collection.
• search_data_objects : exécutez une recherche vectorielle, sémantique ou textuelle sur une collection.
• query_data_objects : lister les objets de données qui correspondent à une expression de filtre.
• batch_search_data_objects : exécutez plusieurs recherches en parallèle et fusionnez les résultats avec Reciprocal Rank Fusion (RRF) ou l'API Vertex Ranking.
• aggregate_data_objects : agrège les objets de données qui correspondent à une expression de filtre (par exemple, les nombres).

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": {}
      }
    }
  }'