MCP Reference: vectorsearch.googleapis.com

컬렉션, 색인을 보고 쿼리하고 검색을 수행하는 도구를 제공하는 에이전트 검색 (이전 명칭: 벡터 검색 2.0)용 MCP 서버입니다.

모델 컨텍스트 프로토콜 (MCP) 서버는 대규모 언어 모델 (LLM) 또는 AI 애플리케이션에 컨텍스트, 데이터 또는 기능을 제공하는 외부 서비스 간의 프록시 역할을 합니다. MCP 서버는 AI 애플리케이션을 데이터베이스 및 웹 서비스와 같은 외부 시스템에 연결하여 응답을 AI 애플리케이션이 이해할 수 있는 형식으로 변환합니다.

서버 설정

사용하기 전에 MCP 서버를 사용 설정하고 인증을 설정해야 합니다. 제품별 설정 안내는 에이전트 검색 원격 MCP 서버 사용을 참고하세요. Google 및 Google Cloud 원격 MCP 서버 사용에 관한 일반적인 내용은 Google Cloud MCP 서버 개요를 참고하세요.

서버 엔드포인트

MCP 서비스 엔드포인트는 AI 애플리케이션 (MCP 클라이언트의 호스트)이 안전하고 표준화된 연결을 설정하는 데 사용하는 MCP 서버의 네트워크 주소 및 통신 인터페이스 (일반적으로 URL)입니다. LLM이 컨텍스트를 요청하거나, 도구를 호출하거나, 리소스에 액세스하기 위한 연락 지점입니다. Google MCP 엔드포인트는 전역 또는 리전일 수 있습니다.

에이전트 검색 (Vector Search API) MCP 서버는 단일 MCP 엔드포인트를 노출합니다.

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

MCP 도구

MCP 도구는 MCP 서버가 LLM 또는 AI 애플리케이션에 노출하여 현실 세계에서 작업을 수행하는 함수 또는 실행 가능한 기능입니다.

에이전트 검색 MCP 서버는 현재 단일 /mcp 엔드포인트에서 다음 도구를 노출합니다. MCP 2026-07-28 스테이트리스(Stateless) 프로토콜을 사용하는 경우 각 tools/call 요청에는 값이 params.name인 Mcp-Name HTTP 헤더도 포함되어야 합니다(직접 리전 라우팅의 경우 Mcp-Param-Region, 헤더 기반 라우팅 참조). Mcp-Name를 tools/list와 함께 전송하지 마세요. 도구 페이지의 curl 샘플 (Authorization: Bearer 헤더 포함)과 같이 이전 MCP 프로토콜 버전을 사용하는 요청도 허용됩니다.

• list_collections – 프로젝트 및 위치의 벡터 검색 컬렉션을 나열합니다.
• get_collection – 특정 컬렉션의 스키마와 메타데이터를 가져옵니다.
• list_indexes – 컬렉션에 정의된 색인을 나열합니다.
• get_index – 특정 색인의 구성을 가져옵니다.
• get_data_object – 컬렉션에서 ID로 데이터 객체를 가져옵니다.
• search_data_objects – 컬렉션에 대해 벡터, 시맨틱 또는 텍스트 검색을 실행합니다.
• query_data_objects – 필터 표현식과 일치하는 데이터 객체를 나열합니다.
• batch_search_data_objects – 여러 검색을 동시에 실행하고 RRF (Reciprocal Rank Fusion) 또는 Vertex Ranking API를 사용하여 결과를 융합합니다.
• aggregate_data_objects – 필터 표현식과 일치하는 데이터 객체를 집계합니다 (예: 개수).

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