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 表現 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "result": value,
  "error": {
    object (McpError)
  }
  // End of mutually exclusive fields.
}
フィールド
厳密に result または error のいずれか 1 つのみを設定する必要があります。以下は、相互に排他的なフィールドのリストです。レスポンスに設定されるフィールドは、最大 1 つです。
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)

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