MCP Tools Reference: developerconnect.googleapis.com

도구: add-repo-pull-request-review-comment

pull 요청에 리뷰 댓글 (diff에 인라인)을 추가합니다.

다음 코드 샘플은 curl를 사용하여 add-repo-pull-request-review-comment 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": "add-repo-pull-request-review-comment",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

입력 스키마

AddGitRepositoryLinkPullRequestReviewComment의 요청 메시지입니다.

AddGitRepositoryLinkPullRequestReviewCommentRequest

JSON 표현 
{
  "name": string,
  "pullRequestId": string,
  "comment": {
    object (PullRequestReviewComment)
  },
  "commitId": string
}
필드
name

string

필수 입력란입니다. projects/*/locations/*/connections/*/gitRepositoryLinks/* 형식의 GitRepositoryLink 리소스 이름입니다.
pullRequestId

string

필수 입력란입니다. pull 요청의 ID입니다.
comment

object (PullRequestReviewComment)

필수 입력란입니다. 추가할 리뷰 댓글입니다.
commitId

string

(선택사항) 댓글을 달 커밋 SHA입니다. 지정되지 않은 경우 기본값은 pull 요청의 HEAD 커밋입니다.

PullRequestReviewComment

JSON 표현 
{
  "id": string,
  "body": string,
  "path": string,
  "firstLine": integer,
  "lastLine": integer,
  "side": enum (DiffSide),
  "author": string,
  "createTime": string,
  "updateTime": string,
  "commitId": string
}
필드
id

string

출력 전용입니다. 댓글의 ID입니다.
body

string

필수 입력란입니다. 댓글의 본문입니다.
path

string

필수 입력란입니다. 댓글을 달 파일 경로입니다.
firstLine

integer

(선택사항) 주석 범위의 첫 번째 줄입니다 (포함). 지정하지 않으면 주석이 last_line에만 적용됩니다.
lastLine

integer

필수 입력란입니다. 주석 범위의 마지막 줄입니다 (포함). first_line를 지정하지 않으면 주석이 이 줄에만 적용됩니다.
side

enum (DiffSide)

(선택사항) 댓글을 달 diff의 측면입니다. 기본값은 HEAD입니다.
author

string

출력 전용입니다. 작성자의 사용자 이름입니다.
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"입니다.
commitId

string

출력 전용입니다. 댓글이 실제로 적용된 커밋 SHA입니다.

타임스탬프

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(포함) 사이여야 합니다.

DiffSide

DiffSide는 댓글이 있는 변경사항의 측면을 나타냅니다.

열거형
DIFF_SIDE_UNSPECIFIED 기본값 이 값은 사용되지 않습니다.
BASE 변경 전의 diff 측면 (삭제되거나 수정된 줄)입니다.
HEAD 변경 후의 diff 측면 (추가되거나 수정된 줄)입니다.

출력 스키마

SCM pull 요청 검토 댓글을 나타내는 메시지입니다 (diff에 인라인).

PullRequestReviewComment

JSON 표현 
{
  "id": string,
  "body": string,
  "path": string,
  "firstLine": integer,
  "lastLine": integer,
  "side": enum (DiffSide),
  "author": string,
  "createTime": string,
  "updateTime": string,
  "commitId": string
}
필드
id

string

출력 전용입니다. 댓글의 ID입니다.
body

string

필수 입력란입니다. 댓글의 본문입니다.
path

string

필수 입력란입니다. 댓글을 달 파일 경로입니다.
firstLine

integer

(선택사항) 주석 범위의 첫 번째 줄입니다 (포함). 지정하지 않으면 주석이 last_line에만 적용됩니다.
lastLine

integer

필수 입력란입니다. 주석 범위의 마지막 줄입니다 (포함). first_line를 지정하지 않으면 주석이 이 줄에만 적용됩니다.
side

enum (DiffSide)

(선택사항) 댓글을 달 diff의 측면입니다. 기본값은 HEAD입니다.
author

string

출력 전용입니다. 작성자의 사용자 이름입니다.
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"입니다.
commitId

string

출력 전용입니다. 댓글이 실제로 적용된 커밋 SHA입니다.

타임스탬프

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(포함) 사이여야 합니다.

DiffSide

DiffSide는 댓글이 있는 변경사항의 측면을 나타냅니다.

열거형
DIFF_SIDE_UNSPECIFIED 기본값 이 값은 사용되지 않습니다.
BASE 변경 전의 diff 측면 (삭제되거나 수정된 줄)입니다.
HEAD 변경 후의 diff 측면 (추가되거나 수정된 줄)입니다.

도구 주석

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

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

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

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