MCP Tools Reference: ces.googleapis.com

도구: start_import_app

CES 앱 가져오기를 시작합니다.

다음 코드 샘플은 curl을 사용하여 start_import_app MCP 도구를 호출하는 방법을 보여줍니다.

curl 요청 
curl --location 'https://ces.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "start_import_app",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

입력 스키마

McpService.StartImportApp에 대한 요청 메시지입니다.

StartImportAppRequest

JSON 표현 
{
  "projectId": string,
  "locationId": string,
  "appId": string,
  "content": string
}
필드
projectId

string

가져올 앱의 프로젝트 ID입니다.
locationId

string

가져올 앱의 위치 ID입니다.
appId

string

가져올 앱의 앱 ID입니다.
content

string (bytes format)

압축된 앱 가져오기의 zip 파일 바이트입니다. 이는 yaml 형식의 앱 구성 파일이 포함된 폴더입니다.

base64 인코딩 문자열입니다.

출력 스키마

CES 앱을 가져오는 작업입니다.

ImportAppOperation

JSON 표현 
{
  "name": string,
  "done": boolean,
  "status": {
    object (Status)
  }
}
필드
name

string

가져오기 앱 작업의 리소스 이름입니다.
done

boolean

작업이 완료되었는지 여부입니다.
status

object (Status)

[done] 이 true이면 가져오기의 상태를 포함합니다.

상태

JSON 표현 
{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
필드
code

integer

상태 코드로, google.rpc.Code의 열거형 값이어야 합니다.
message

string

개발자에게 정보를 제공하는 오류 메시지로, 영어로 작성되어야 합니다. 사용자에게 표시되는 모든 오류 메시지는 현지화되어 google.rpc.Status.details 필드에 전송되거나, 클라이언트 측에서 현지화되어야 합니다.
details[]

object

오류 세부정보를 설명하는 메시지 목록입니다. API에서 사용할 일반적인 메시지 유형 집합이 있습니다.

임의 유형의 필드를 포함하는 객체입니다. 추가 필드 "@type"은 유형을 식별하는 URI를 포함합니다. 예: { "id": 1234, "@type": "types.example.com/standard/id" }.

모두

JSON 표현 
{
  "typeUrl": string,
  "value": string
}
필드
typeUrl

string

슬래시로 끝나는 접두어와 정규화된 유형 이름으로 구성된 URI 참조를 사용하여 직렬화된 Protobuf 메시지의 유형을 식별합니다.

예: type.googleapis.com/google.protobuf.StringValue

이 문자열에는 / 문자가 하나 이상 포함되어야 하며 마지막 / 뒤의 콘텐츠는 선행 점 없이 정규 형식의 유형의 정규화된 이름이어야 합니다. 클라이언트가 이러한 URI 참조에 연결을 시도하지 않도록 스키마를 작성하지 마세요.

접두어는 임의적이며 Protobuf 구현은 유형을 식별하기 위해 마지막 /까지 포함한 모든 항목을 삭제해야 합니다. type.googleapis.com/은 일부 기존 구현에 필요한 일반적인 기본 접두어입니다. 이 접두어는 유형의 출처를 나타내지 않으며 이 접두어가 포함된 URI는 요청에 응답하지 않습니다.

모든 유형 URL 문자열은 유효한 URI 참조여야 하며 참조 콘텐츠는 영숫자 문자, 퍼센트 인코딩된 이스케이프, 다음 집합의 문자 (외부 백틱 제외)로만 구성되어야 한다는 추가 제한사항 (텍스트 형식의 경우)이 있습니다. /-.~_!$&()*+,;= 퍼센트 인코딩을 허용하더라도 기존 파서와의 혼동을 방지하기 위해 구현에서 퍼센트 인코딩을 이스케이프 해제해서는 안 됩니다. 예를 들어 type.googleapis.com%2FFoo는 거부되어야 합니다.

Any의 원래 설계에서는 이러한 유형 URL에서 유형 확인 서비스를 시작할 가능성이 고려되었지만 Protobuf는 이를 구현하지 않았으며 이러한 URL에 연결하는 것을 문제로 간주하고 잠재적인 보안 문제로 간주합니다. 유형 URL에 연결하지 마세요.
value

string (bytes format)

type_url로 설명된 유형의 Protobuf 직렬화를 보유합니다.

base64 인코딩 문자열입니다.

도구 주석

도구 주석은 지정된 도구의 기본 위험을 설명하기 위해 MCP 클라이언트로 전송됩니다. 대부분의 클라이언트는 이러한 힌트를 신뢰할 수 없는 것으로 취급하지만 확인 메시지가 사용자에게 전송될 시점을 결정하는 데 사용할 수 있습니다.

제목 문자열과 함께 다음 불리언 힌트가 다음과 같이 정의됩니다.

  • readOnlyHint: true인 경우 도구가 환경을 수정하지 않습니다. 기본값: false.
  • destructiveHint: true인 경우 도구가 파괴적인 작업을 실행할 수 있습니다. false인 경우 도구는 추가 작업만 실행할 수 있습니다. 기본값: true.
  • idempotentHint: true인 경우 동일한 인수로 도구를 반복적으로 호출해도 환경에 추가적인 영향을 미치지 않습니다. 기본값: false.
  • openWorldHint: true인 경우 도구가 외부 엔티티의 '오픈 월드'와 상호작용할 수 있습니다. false인 경우 도구는 내부 엔티티와만 상호작용할 수 있습니다. 예를 들어 웹 검색 도구는 오픈 월드이지만 메모리 도구는 오픈 월드가 아닙니다.

파괴적 힌트: ✅ | 멱등성 힌트: ❌ | 읽기 전용 힌트: ❌ | 오픈 월드 힌트: ❌