Ferramenta: list-repo-links
Listar links de repositório do Git em uma conexão.
O exemplo de código abaixo mostra como usar curl para chamar a ferramenta MCP list-repo-links.
| 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": "list-repo-links", "arguments": { // Provide these details according to the MCP tool specification. } }, "jsonrpc": "2.0", "id": 1 }' |
Esquema de entrada
Mensagem para solicitar uma lista de GitRepositoryLinks
ListGitRepositoryLinksRequest
| Representação JSON |
|---|
{ "parent": string, "pageSize": integer, "pageToken": string, "filter": string, "orderBy": string } |
| Campos | |
|---|---|
parent |
Obrigatório. Valor principal para ListGitRepositoryLinksRequest. |
pageSize |
Opcional. Tamanho da página solicitada. O servidor pode retornar menos resultados do que o solicitado. Se não for especificado, o servidor escolherá um padrão apropriado. |
pageToken |
Opcional. Um token que identifica a página de resultados que o servidor vai retornar. |
filter |
Opcional. Como filtrar resultados. |
orderBy |
Opcional. Dica de como organizar os resultados. |
Esquema de saída
Mensagem de resposta para listar GitRepositoryLinks
ListGitRepositoryLinksResponse
| Representação JSON |
|---|
{
"gitRepositoryLinks": [
{
object ( |
| Campos | |
|---|---|
gitRepositoryLinks[] |
A lista de GitRepositoryLinks. |
nextPageToken |
Um token que identifica a página de resultados que o servidor retornará. |
unreachable[] |
Locais que não puderam ser alcançados. |
GitRepositoryLink
| Representação 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 } |
| Campos | |
|---|---|
name |
Identificador. Nome do recurso do repositório, no formato |
cloneUri |
Obrigatório. URI do clone do Git. |
createTime |
Apenas saída. Criar carimbo de data/hora. 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: |
updateTime |
Apenas saída. Atualizar carimbo de data/hora. 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: |
deleteTime |
Apenas saída. Excluir marcação de tempo. 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: |
labels |
Opcional. Rótulos como pares de chave-valor. Um objeto com uma lista de pares |
etag |
Opcional. Essa checksum é calculada pelo servidor com base no valor de outros campos e pode ser enviada em solicitações de atualização e exclusão para garantir que o cliente tenha um valor atualizado antes de prosseguir. |
reconciling |
Apenas saída. Defina como verdadeiro quando a conexão estiver sendo configurada ou atualizada em segundo plano. |
annotations |
Opcional. Permite que os clientes armazenem pequenas quantidades de dados arbitrários. Um objeto com uma lista de pares |
uid |
Apenas saída. Um identificador exclusivo atribuído pelo sistema para o GitRepositoryLink. |
webhookId |
Apenas saída. ID externo do webhook criado para o repositório. |
gitProxyUri |
Apenas saída. URI para acessar o repositório vinculado pelo proxy do Git. Esse campo só é preenchido se o proxy do Git estiver ativado para a conexão. |
Carimbo de data/hora
| Representação JSON |
|---|
{ "seconds": string, "nanos": integer } |
| Campos | |
|---|---|
seconds |
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 |
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. |
LabelsEntry
| Representação JSON |
|---|
{ "key": string, "value": string } |
| Campos | |
|---|---|
key |
|
value |
|
AnnotationsEntry
| Representação JSON |
|---|
{ "key": string, "value": string } |
| Campos | |
|---|---|
key |
|
value |
|
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 jogos de mundo aberto: ❌