Servidor MCP para Recuperação de Agentes (antigo busca vetorial 2.0), que oferece ferramentas para visualizar e consultar coleções, índices e realizar pesquisas.
Um servidor do Protocolo de Contexto de Modelo (MCP) atua como um proxy entre um serviço externo que fornece contexto, dados ou recursos para um modelo de linguagem grande (LLM) ou aplicativo de IA. Os servidores MCP conectam aplicativos de IA a sistemas externos, como bancos de dados e serviços da Web, traduzindo as respostas em um formato que o aplicativo de IA possa entender.
Configuração do servidor
É necessário ativar os servidores MCP e configurar a autenticação antes do uso. Para instruções de configuração específicas do produto, consulte Usar o servidor MCP remoto de Recuperação de Agentes. Para informações gerais sobre como usar os servidores MCP remotos do Google e do Google Cloud, consulte Visão geral dos servidores MCP do Google Cloud.
Endpoints do servidor
Um endpoint de serviço MCP é o endereço de rede e a interface de comunicação (geralmente um URL) do servidor MCP que um aplicativo de IA (o host do cliente MCP) usa para estabelecer uma conexão segura e padronizada. É o ponto de contato para o LLM solicitar contexto, chamar uma ferramenta ou acessar um recurso. Os endpoints do MCP do Google podem ser globais ou regionais.
O servidor MCP de Recuperação de Agentes (API de busca vetorial) expõe um único endpoint MCP:
https://vectorsearch.googleapis.com/mcp
Ferramentas do MCP
Uma ferramenta MCP é uma função ou recurso executável que um servidor MCP expõe a um LLM ou aplicativo de IA para realizar uma ação no mundo real.
No momento, o servidor MCP de recuperação de agentes expõe as seguintes ferramentas no endpoint /mcp único. Se você usar o protocolo sem estado MCP 2026-07-28, cada solicitação tools/call também precisará incluir um cabeçalho HTTP Mcp-Name com valor igual a params.name (e Mcp-Param-Region para roteamento regional direto; consulte Roteamento baseado em cabeçalho). Não envie Mcp-Name com tools/list. As solicitações que usam versões anteriores do protocolo MCP, como as amostras curl nas páginas de ferramentas (com um cabeçalho Authorization: Bearer), também são aceitas.
list_collections: lista as coleções da Pesquisa Vetorial em um projeto e local.get_collection: recupera o esquema e os metadados de uma coleção específica.list_indexes: lista os índices definidos em uma coleção.get_index: recupera a configuração de um índice específico.get_data_object: recupera um objeto de dados por ID de uma coleção.search_data_objects: execute uma pesquisa vetorial, semântica ou de texto em uma coleção.query_data_objects: lista objetos de dados que correspondem a uma expressão de filtro.batch_search_data_objects: execute várias pesquisas em paralelo e combine os resultados com a Fusão de Classificação Recíproca (RRF, na sigla em inglês) ou a API Vertex Ranking.aggregate_data_objects: agrega dados agregados que correspondem a uma expressão de filtro (por exemplo, contagens).
Receber especificações da ferramenta MCP
Para receber as especificações de todas as ferramentas em um servidor MCP, use o método tools/list. O servidor MCP da API de busca vetorial oferece suporte ao protocolo sem estado MCP 2026-07-28: cada solicitação é autodescritiva e inclui a versão do protocolo no cabeçalho HTTP MCP-Protocol-Version e no campo de corpo params._meta.io.modelcontextprotocol/protocolVersion, um cabeçalho Mcp-Method que corresponde ao JSON-RPC method e um objeto params._meta.io.modelcontextprotocol/clientCapabilities (um objeto vazio é aceito). O exemplo de curl a seguir lista todas as ferramentas e as especificações delas.
| Solicitação 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": {} } } }' |