Method: projects.locations.collections.dataConnector.invokeConnectorMcp

MCP コネクタを呼び出します。

HTTP リクエスト

POST https://discoveryengine.googleapis.com/v1alpha/{name=projects/*/locations/*/collections/*/dataConnector}:invokeConnectorMcp

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
name

string

必須。DataConnector リソース。

MCP 呼び出しに使用されるデータ コネクタ。

リクエストの本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現 
{
  "method": string,
  "params": {
    object
  },
  "engine": string,
  "toolSpecVersion": string
}
フィールド
method

string

必須。呼び出すメソッド（「tools/list」、「tools/call」、「resources/read」、「prompts/get」など）。
params

object (Struct format)

省略可。メソッドの任意の構造化パラメータ。

google.protobuf.Struct を使用すると、ペイロード スキーマの柔軟性が維持され、JSON-RPC のフリーフォーム params フィールドと一致します。
engine

string

省略可。エンジン リソース名（例: projects/{project}/locations/{location}/collections/{collection}/engines/{engine}）。Discovery Search Service リクエストを発行するツール レジストリ ツールを呼び出すときに、検索エンジン ID として使用されます。
toolSpecVersion

string

省略可。コネクタのツール サーフェスを解決するツール仕様のバージョン。これは、コネクタの BAP ツール仕様ファイル名（「v2」、「v5.2」など）に対応します。設定されていない場合、サーバーはコネクタのデフォルト（最新）のツール仕様を使用します。すべてのメソッド（「tools/list」や「tools/call」など）に適用されます。

レスポンスの本文

MCP コネクタの呼び出しの結果を返すレスポンス メッセージ。成功した結果のペイロードまたはエラーの詳細が含まれます。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現 
{

  // Union field payload can be only one of the following:
  "result": value,
  "error": {
    object (McpError)
  }
  // End of list of possible types for union field payload.
}
フィールド
共用体フィールド payload。result または error のいずれか 1 つを設定する必要があります。payload は次のいずれかになります。
result

value (Value format)

成功した結果 - 任意の構造化データ。
error

object (McpError)

呼び出しが失敗したときのエラーの詳細。

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/discoveryengine.assist.readwrite
  • https://www.googleapis.com/auth/discoveryengine.readwrite
  • https://www.googleapis.com/auth/discoveryengine.serving.readwrite

詳細については、Authentication Overview をご覧ください。

IAM 権限

name リソースに対する次の IAM 権限が必要です。

  • discoveryengine.dataConnectors.executeAction

詳細については、IAM のドキュメントをご覧ください。

McpError

McpError は、MCP 呼び出しが失敗したときのエラーの詳細を表します。この構造は、JSON-RPC 2.0 エラー オブジェクトの形状に従います。

JSON 表現 
{
  "code": integer,
  "message": string,
  "data": value
}
フィールド
code

integer

数値のエラーコード。
message

string

エラーの短い説明（人が読める形式）。
data

value (Value format)

追加のエラー コンテキストを含む構造化データ（省略可）。