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}'). 발견 검색 서비스 요청을 실행하는 도구 레지스트리 도구를 호출할 때 검색 엔진 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 중 정확히 하나만 설정해야 합니다. 다음은 상호 배타적인 필드의 목록입니다. 응답에는 다음 필드 중 최대 하나가 설정됩니다.
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)

추가 오류 컨텍스트가 있는 구조화된 데이터(선택사항)입니다.