Method: projects.locations.collections.dataConnector.invokeConnectorMcp

MCP 커넥터를 호출합니다.

HTTP 요청

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

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
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 중 하나만 설정해야 합니다. 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)

추가 오류 컨텍스트가 포함된 선택적 구조화된 데이터입니다.