MCP Tools Reference: developerconnect.googleapis.com

Ferramenta: add-repo-pull-request-review-comment

Adicionar um comentário de revisão (inline no diff) a uma solicitação de envio.

O exemplo de código abaixo mostra como usar curl para chamar a ferramenta MCP add-repo-pull-request-review-comment.

Solicitação 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
}'

Esquema de entrada

Mensagem de solicitação para AddGitRepositoryLinkPullRequestReviewComment.

AddGitRepositoryLinkPullRequestReviewCommentRequest

Representação JSON 
{
  "name": string,
  "pullRequestId": string,
  "comment": {
    object (PullRequestReviewComment)
  },
  "commitId": string
}
Campos
name

string

Obrigatório. O nome do recurso do GitRepositoryLink no formato projects/*/locations/*/connections/*/gitRepositoryLinks/*.
pullRequestId

string

Obrigatório. O ID da solicitação de pull.
comment

object (PullRequestReviewComment)

Obrigatório. O comentário de revisão a ser adicionado.
commitId

string

Opcional. O SHA de commit para comentar. Se não for especificado, o padrão será o commit HEAD da solicitação de pull.

PullRequestReviewComment

Representação JSON 
{
  "id": string,
  "body": string,
  "path": string,
  "firstLine": integer,
  "lastLine": integer,
  "side": enum (DiffSide),
  "author": string,
  "createTime": string,
  "updateTime": string,
  "commitId": string
}
Campos
id

string

Apenas saída. O ID do comentário.
body

string

Obrigatório. O corpo do comentário.
path

string

Obrigatório. O caminho do arquivo para comentar.
firstLine

integer

Opcional. A primeira linha do intervalo de comentários (inclusive). Se não for especificado, o comentário será aplicado apenas ao last_line.
lastLine

integer

Obrigatório. A última linha do intervalo de comentários (inclusive). Se first_line não for especificado, o comentário será aplicado apenas a essa linha.
side

enum (DiffSide)

Opcional. O lado da diferença a ser comentado. O padrão é HEAD.
author

string

Apenas saída. O nome de usuário do autor.
createTime

string (Timestamp format)

Apenas saída. Quando o comentário foi criado.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Apenas saída. Quando o comentário foi atualizado.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
commitId

string

Apenas saída. O SHA do commit ao qual o comentário foi aplicado.

Carimbo de data/hora

Representação JSON 
{
  "seconds": string,
  "nanos": integer
}
Campos
seconds

string (int64 format)

Representa os segundos do horário UTC desde a época Unix 1970-01-01T00:00:00Z. Precisa estar entre -62135596800 e 253402300799, inclusive (o que corresponde a 0001-01-01T00:00:00Z a 9999-12-31T23:59:59Z).
nanos

integer

Frações não negativas de um segundo com resolução de nanossegundos. Esse campo é a parte de nanossegundos da duração, não uma alternativa aos segundos. Os valores de segundos negativos com frações ainda precisam ter valores em nanossegundos não negativos que representam períodos posteriores. O valor precisa ser de 0 a 999.999.999.

DiffSide

DiffSide representa em qual lado da diferença o comentário está.

Tipos enumerados
DIFF_SIDE_UNSPECIFIED Valor padrão. Esse valor não é usado.
BASE O lado da diferença antes das mudanças (linhas excluídas ou modificadas).
HEAD O lado da diferença após as mudanças (linhas adicionadas ou modificadas).

Esquema de saída

Mensagem que representa um comentário de revisão de solicitação de pull do SCM (inline no diff).

PullRequestReviewComment

Representação JSON 
{
  "id": string,
  "body": string,
  "path": string,
  "firstLine": integer,
  "lastLine": integer,
  "side": enum (DiffSide),
  "author": string,
  "createTime": string,
  "updateTime": string,
  "commitId": string
}
Campos
id

string

Apenas saída. O ID do comentário.
body

string

Obrigatório. O corpo do comentário.
path

string

Obrigatório. O caminho do arquivo para comentar.
firstLine

integer

Opcional. A primeira linha do intervalo de comentários (inclusive). Se não for especificado, o comentário será aplicado apenas ao last_line.
lastLine

integer

Obrigatório. A última linha do intervalo de comentários (inclusive). Se first_line não for especificado, o comentário será aplicado apenas a essa linha.
side

enum (DiffSide)

Opcional. O lado da diferença a ser comentado. O padrão é HEAD.
author

string

Apenas saída. O nome de usuário do autor.
createTime

string (Timestamp format)

Apenas saída. Quando o comentário foi criado.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Apenas saída. Quando o comentário foi atualizado.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
commitId

string

Apenas saída. O SHA do commit ao qual o comentário foi aplicado.

Carimbo de data/hora

Representação JSON 
{
  "seconds": string,
  "nanos": integer
}
Campos
seconds

string (int64 format)

Representa os segundos do horário UTC desde a época Unix 1970-01-01T00:00:00Z. Precisa estar entre -62135596800 e 253402300799, inclusive (o que corresponde a 0001-01-01T00:00:00Z a 9999-12-31T23:59:59Z).
nanos

integer

Frações não negativas de um segundo com resolução de nanossegundos. Esse campo é a parte de nanossegundos da duração, não uma alternativa aos segundos. Os valores de segundos negativos com frações ainda precisam ter valores em nanossegundos não negativos que representam períodos posteriores. O valor precisa ser de 0 a 999.999.999.

DiffSide

DiffSide representa em qual lado da diferença o comentário está.

Tipos enumerados
DIFF_SIDE_UNSPECIFIED Valor padrão. Esse valor não é usado.
BASE O lado da diferença antes das mudanças (linhas excluídas ou modificadas).
HEAD O lado da diferença após as mudanças (linhas adicionadas ou modificadas).

Anotações de ferramentas

As anotações de ferramentas são enviadas aos clientes do MCP para descrever o risco básico de uma determinada ferramenta. A maioria dos clientes trata essas dicas como não confiáveis, mas elas podem ser usadas para decidir quando um pedido de confirmação pode ser enviado a um usuário.

Além da string de título, as seguintes dicas booleanas são definidas:

  • readOnlyHint: se for verdadeiro, a ferramenta não modifica o ambiente. Padrão: false.
  • destructiveHint: se for verdadeiro, a ferramenta poderá realizar ações destrutivas. Se for falso, a ferramenta só poderá realizar ações aditivas. Padrão: verdadeiro.
  • idempotentHint: se for verdadeiro, chamar a ferramenta repetidamente com os mesmos argumentos não terá efeito adicional no ambiente. Padrão: false.
  • openWorldHint: se for verdadeiro, a ferramenta poderá interagir com um "mundo aberto" de entidades externas. Se for falso, a ferramenta só poderá interagir com entidades internas. Por exemplo, uma ferramenta de pesquisa na Web seria de mundo aberto, enquanto uma ferramenta de memória não seria.

Dica destrutiva: ❌ | Dica idempotente: ❌ | Dica somente leitura: ❌ | Dica de mundo aberto: ❌