MCP Reference: vectorsearch.googleapis.com

Agent Retrieval（旧称: ベクトル検索 2.0）用の MCP サーバー。コレクション、インデックスの表示とクエリ、検索の実行を行うツールを提供します。

Model Context Protocol（MCP）サーバーは、大規模言語モデル（LLM）または AI アプリケーションにコンテキスト、データ、機能を提供する外部サービスとの間のプロキシとして機能します。MCP サーバーは、AI アプリケーションをデータベースやウェブサービスなどの外部システムに接続し、そのレスポンスを AI アプリケーションが理解できる形式に変換します。

サーバーの設定

使用する前に、MCP サーバーを有効にして認証を設定する必要があります。プロダクト固有の設定手順については、Agent Retrieval リモート MCP サーバーを使用するをご覧ください。Google と Google Cloud リモート MCP サーバーの使用に関する一般的な情報については、Google Cloud MCP サーバーの概要をご覧ください。

サーバー エンドポイント

MCP サービス エンドポイントは、安全で標準化された接続を確立するために AI アプリケーション（MCP クライアントのホスト）が使用する MCP サーバーのネットワーク アドレスと通信インターフェース（通常は URL）です。これは、LLM がコンテキストをリクエストしたり、ツールを呼び出したり、リソースにアクセスしたりするための接続ポイントとなります。Google MCP エンドポイントをグローバルまたはリージョンにすることができます。

Agent Retrieval（ベクトル検索 API）MCP サーバーは、1 つの MCP エンドポイントを公開します。

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

MCP ツール

MCP ツールは、現実世界でアクションを実行する目的で MCP サーバーが LLM または AI アプリケーションに対して公開する関数または実行可能な機能です。

Agent Retrieval MCP サーバーは現在、単一の /mcp エンドポイントで次のツールを公開しています。MCP 2026-07-28 ステートレス プロトコルを使用する場合、各 tools/call リクエストには、値が params.name（直接リージョン ルーティングの場合は Mcp-Param-Region。ヘッダーベースのルーティングを参照）と等しい Mcp-Name HTTP ヘッダーも含める必要があります。Mcp-Name を tools/list と一緒に送信しないでください。以前の MCP プロトコル バージョンを使用するリクエスト（ツールページの curl サンプルなど、Authorization: Bearer ヘッダーを含むリクエスト）も受け入れられます。

• list_collections - プロジェクトとロケーションのベクトル検索コレクションを一覧表示します。
• get_collection - 特定のコレクションのスキーマとメタデータを取得します。
• list_indexes - コレクションに定義されているインデックスを一覧表示します。
• get_index – 特定のインデックスの構成を取得します。
• get_data_object - コレクションから ID でデータ オブジェクトを取得します。
• search_data_objects - コレクションに対してベクトル検索、セマンティック検索、テキスト検索を実行します。
• query_data_objects - フィルタ式に一致するデータ オブジェクトを一覧表示します。
• batch_search_data_objects – 複数の検索を並行して実行し、Reciprocal Rank Fusion（RRF）または 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": {}
      }
    }
  }'