MCP Tools Reference: developerconnect.googleapis.com

도구: create-repo-link

특정 프로젝트와 위치에 새 GitRepositoryLink를 만듭니다.

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

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

입력 스키마

GitRepositoryLink를 만들기 위한 메시지

CreateGitRepositoryLinkRequest

JSON 표현
{ "parent": string, "gitRepositoryLink": { object (GitRepositoryLink) }, "gitRepositoryLinkId": string, "requestId": string, "validateOnly": boolean }

필드
parent	string 필수 입력란입니다. 상위 요소 값입니다.
gitRepositoryLink	object (GitRepositoryLink) 필수 입력란입니다. 생성 중인 리소스
gitRepositoryLinkId	string 필수 입력란입니다. 저장소에 사용할 ID이며, 저장소의 리소스 이름에서 마지막 구성요소가 됩니다. 이 ID는 연결에서 고유해야 합니다. 영숫자 문자와 -._~%!$&'()*+,;=@ 중 하나를 허용합니다.
requestId	string (선택사항) 요청을 식별하는 선택적 요청 ID입니다. 요청을 다시 시도해야 하는 경우 서버가 이미 완료되었을 때 요청을 무시하도록 고유한 요청 ID를 지정합니다. 서버는 첫 번째 요청 후 최소 60분 동안 이를 보장합니다. 예를 들어 최초 요청을 수행하고 요청이 타임아웃되는 경우를 생각해 보세요. 동일한 요청 ID로 다시 요청을 수행하면 서버는 동일한 요청 ID를 가진 원래 작업이 수신되었는지 확인할 수 있으며 그럴 경우 두 번째 요청을 무시합니다. 이렇게 해서 클라이언트가 실수로 중복된 약정을 생성하지 않도록 방지합니다. 요청 ID는 유효한 UUID여야 하며, 0 UUID는 지원되지 않습니다(00000000-0000-0000-0000-000000000000).
validateOnly	boolean (선택사항) 설정된 경우 요청 유효성을 검사하되 실제로 게시하지 않습니다.

GitRepositoryLink

JSON 표현
{ "name": string, "cloneUri": string, "createTime": string, "updateTime": string, "deleteTime": string, "labels": { string: string, ... }, "etag": string, "reconciling": boolean, "annotations": { string: string, ... }, "uid": string, "webhookId": string, "gitProxyUri": string }

필드
name	string 식별자. projects/*/locations/*/connections/*/gitRepositoryLinks/* 형식의 저장소 리소스 이름입니다.
cloneUri	string 필수 입력란입니다. Git 클론 URI입니다.
createTime	string (Timestamp format) 출력 전용입니다. 생성 타임스탬프입니다. 생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
updateTime	string (Timestamp format) 출력 전용입니다. 업데이트 타임스탬프입니다. 생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
deleteTime	string (Timestamp format) 출력 전용입니다. 타임스탬프를 삭제합니다. 생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
labels	map (key: string, value: string) 선택사항. 키-값 쌍인 라벨입니다. "key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }
etag	string (선택사항) 이 체크섬은 다른 필드의 값을 기준으로 서버에서 계산되며, 처리 전 클라이언트에 최신 값이 적용되도록 업데이트 및 삭제 요청이 있을 때 전송될 수 있습니다.
reconciling	boolean 출력 전용입니다. 백그라운드에서 연결이 설정되거나 업데이트될 때 true로 설정됩니다.
annotations	map (key: string, value: string) (선택사항) 클라이언트가 소량의 임의 데이터를 저장할 수 있습니다. "key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }
uid	string 출력 전용입니다. GitRepositoryLink에 대해 시스템에서 할당된 고유 식별자입니다.
webhookId	string 출력 전용입니다. 저장소에 생성된 웹훅의 외부 ID입니다.
gitProxyUri	string 출력 전용입니다. Git 프록시를 통해 연결된 저장소에 액세스하는 URI입니다. 이 필드는 연결에 Git 프록시가 사용 설정된 경우에만 채워집니다.

타임스탬프

JSON 표현
{ "seconds": string, "nanos": integer }

필드
seconds	string (int64 format) 유닉스 시간 1970-01-01T00:00:00Z 이후 경과된 UTC 시간을 초 단위로 나타냅니다. -62135596800~253402300799(양 끝값 포함) 사이여야 합니다(0001-01-01T00:00:00Z~9999-12-31T23:59:59Z에 해당).
nanos	integer 나노초 단위의 음수가 아닌 초수입니다. 이 필드는 기간의 나노초 부분이며 초를 대체하지 않습니다. 음수의 초수 값에는 시간에 반영되는 음수가 아닌 나노초 값이 있어야 합니다. 0~999,999,999(포함) 사이여야 합니다.

LabelsEntry

JSON 표현
{ "key": string, "value": string }

필드
key	string
value	string

AnnotationsEntry

JSON 표현
{ "key": string, "value": string }

필드
key	string
value	string

출력 스키마

이 리소스는 네트워크 API 호출의 결과인 장기 실행 작업을 나타냅니다.

작업

JSON 표현
{ "name": string, "metadata": { "@type": string, field1: ..., ... }, "done": boolean, // Union field result can be only one of the following: "error": { object (Status) }, "response": { "@type": string, field1: ..., ... } // End of list of possible types for union field result. }

필드
name	string 서버에 할당된 이름으로, 해당 이름을 최초로 반환한 서비스 내에서만 고유합니다. 기본 HTTP 매핑을 사용하는 경우 name은 operations/{unique_id}로 끝나는 리소스 이름이어야 합니다.
metadata	object 작업과 관련된 서비스별 메타데이터입니다. 일반적으로 진행률 정보 및 생성 시간과 같은 일반 메타데이터가 포함됩니다. 일부 서비스는 이러한 메타데이터를 제공하지 않을 수 있습니다. 장기 실행 작업을 반환하는 메소드는 메타데이터 유형이 있는 경우 이를 문서화해야 합니다. 임의 유형의 필드를 포함하는 객체입니다. 추가 필드 "@type"은 유형을 식별하는 URI를 포함합니다. 예를 들면 { "id": 1234, "@type": "types.example.com/standard/id" }입니다.
done	boolean 값이 false이면 작업이 아직 진행 중이라는 의미입니다. true이면 작업이 완료된 것이며, error 또는 response를 사용할 수 있습니다.
통합 필드 result는 작업 결과로, error 또는 유효한 response일 수 있습니다. done == false이면 error와 response가 모두 설정되지 않습니다. done == true이면 error 또는 response 중 정확히 하나를 설정할 수 있습니다. 일부 서비스는 결과를 제공하지 않을 수 있습니다. result는 다음 중 하나여야 합니다.
error	object (Status) 실패하거나 취소된 작업의 오류 결과입니다.
response	object 정상적인 성공한 작업 응답입니다. Delete와 같이 원래 메서드가 성공 시 데이터를 반환하지 않는 경우 응답은 google.protobuf.Empty입니다. 원래 메서드가 표준 Get/Create/Update이면 응답은 리소스여야 합니다. 다른 메서드의 경우 응답은 XxxResponse 유형이어야 하며, 여기에서 Xxx는 원래 메서드의 이름입니다. 예를 들어 원래 메서드 이름이 TakeSnapshot()이면 추론된 응답 유형은 TakeSnapshotResponse입니다. 임의 유형의 필드를 포함하는 객체입니다. 추가 필드 "@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 인코딩 문자열입니다.

상태

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" }

도구 주석

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

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

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

Destructive Hint: ❌ | Idempotent Hint: ❌ | Read Only Hint: ❌ | Open World Hint: ❌