MCP Tools Reference: developerconnect.googleapis.com

Ferramenta: list-connections

Lista as conexões em um determinado projeto e local.

O exemplo de código abaixo mostra como usar curl para chamar a ferramenta MCP list-connections.

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-connections",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Esquema de entrada

Mensagem para solicitar a lista de conexões

ListConnectionsRequest

Representação JSON
{
  "parent": string,
  "pageSize": integer,
  "pageToken": string,
  "filter": string,
  "orderBy": string
}
Campos
parent

string

Obrigatório. Valor pai para ListConnectionsRequest

pageSize

integer

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

string

Opcional. Um token que identifica a página de resultados que o servidor vai retornar.

filter

string

Opcional. Como filtrar resultados.

orderBy

string

Opcional. Dica de como organizar os resultados.

Esquema de saída

Mensagem de resposta para listar conexões

ListConnectionsResponse

Representação JSON
{
  "connections": [
    {
      object (Connection)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Campos
connections[]

object (Connection)

A lista de conexões.

nextPageToken

string

Um token que identifica a página de resultados que o servidor retornará.

unreachable[]

string

Locais que não puderam ser alcançados.

Conexão

Representação JSON
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "deleteTime": string,
  "labels": {
    string: string,
    ...
  },
  "installationState": {
    object (InstallationState)
  },
  "disabled": boolean,
  "reconciling": boolean,
  "annotations": {
    string: string,
    ...
  },
  "etag": string,
  "uid": string,
  "cryptoKeyConfig": {
    object (CryptoKeyConfig)
  },
  "gitProxyConfig": {
    object (GitProxyConfig)
  },

  // Union field connection_config can be only one of the following:
  "githubConfig": {
    object (GitHubConfig)
  },
  "githubEnterpriseConfig": {
    object (GitHubEnterpriseConfig)
  },
  "gitlabConfig": {
    object (GitLabConfig)
  },
  "gitlabEnterpriseConfig": {
    object (GitLabEnterpriseConfig)
  },
  "bitbucketDataCenterConfig": {
    object (BitbucketDataCenterConfig)
  },
  "bitbucketCloudConfig": {
    object (BitbucketCloudConfig)
  },
  "secureSourceManagerInstanceConfig": {
    object (SecureSourceManagerInstanceConfig)
  },
  "httpConfig": {
    object (GenericHTTPEndpointConfig)
  }
  // End of list of possible types for union field connection_config.
}
Campos
name

string

Identificador. O nome do recurso da conexão, no formato projects/{project}/locations/{location}/connections/{connection_id}.

createTime

string (Timestamp format)

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: "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. 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: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

deleteTime

string (Timestamp format)

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: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

labels

map (key: string, value: string)

Opcional. Rótulos como pares de chave-valor.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

installationState

object (InstallationState)

Apenas saída. Estado de instalação da conexão.

disabled

boolean

Opcional. Se disabled for definido como verdadeiro, a funcionalidade será desativada para essa conexão. Os métodos de API baseados em repositório e o processamento de webhooks para repositórios nessa conexão serão desativados.

reconciling

boolean

Apenas saída. Defina como verdadeiro quando a conexão estiver sendo configurada ou atualizada em segundo plano.

annotations

map (key: string, value: string)

Opcional. Permite que os clientes armazenem pequenas quantidades de dados arbitrários.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

etag

string

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.

uid

string

Apenas saída. Um identificador exclusivo atribuído pelo sistema para a conexão.

cryptoKeyConfig

object (CryptoKeyConfig)

Opcional. A configuração da chave criptográfica. Esse campo é usado pelo recurso de chaves de criptografia gerenciadas pelo cliente (CMEK).

gitProxyConfig

object (GitProxyConfig)

Opcional. Configuração do recurso de proxy do Git. Ao ativar o proxy do Git, os clientes podem realizar operações do Git nos repositórios vinculados à conexão. Saiba mais.

Campo de união connection_config. Configuração da conexão, dependendo do tipo de provedor. connection_config pode ser apenas de um dos tipos a seguir:
githubConfig

object (GitHubConfig)

Configuração para conexões com github.com.

githubEnterpriseConfig

object (GitHubEnterpriseConfig)

Configuração para conexões com uma instância do GitHub Enterprise.

gitlabConfig

object (GitLabConfig)

Configuração para conexões com o gitlab.com.

gitlabEnterpriseConfig

object (GitLabEnterpriseConfig)

Configuração para conexões com uma instância do GitLab Enterprise.

bitbucketDataCenterConfig

object (BitbucketDataCenterConfig)

Configuração para conexões com uma instância do Bitbucket Data Center.

bitbucketCloudConfig

object (BitbucketCloudConfig)

Configuração para conexões com uma instância do Bitbucket Cloud.

secureSourceManagerInstanceConfig

object (SecureSourceManagerInstanceConfig)

Configuração para conexões com uma instância do Secure Source Manager.

httpConfig

object (GenericHTTPEndpointConfig)

Opcional. Configuração para conexões com um provedor de serviços HTTP.

GitHubConfig

Representação JSON
{
  "githubApp": enum (GitHubApp),
  "authorizerCredential": {
    object (OAuthCredential)
  },
  "appInstallationId": string,
  "installationUri": string
}
Campos
githubApp

enum (GitHubApp)

Obrigatório. Imutável. O aplicativo do GitHub que foi instalado no usuário ou na organização do GitHub.

authorizerCredential

object (OAuthCredential)

Opcional. Credencial OAuth da conta que autorizou o app do GitHub. Recomendamos usar uma conta robô em vez de uma conta de usuário humano. O token OAuth precisa estar vinculado ao app GitHub dessa configuração.

appInstallationId

string (int64 format)

Opcional. ID de instalação do app GitHub.

installationUri

string

Apenas saída. O URI para navegar e gerenciar a instalação associada a este GitHubConfig.

OAuthCredential

Representação JSON
{
  "oauthTokenSecretVersion": string,
  "username": string
}
Campos
oauthTokenSecretVersion

string

Obrigatório. Um recurso do SecretManager que contém o token OAuth que autoriza a conexão. Formato: projects/*/secrets/*/versions/* ou projects/*/locations/*/secrets/*/versions/* (se secrets regionais forem aceitos nesse local).

username

string

Apenas saída. O nome de usuário associado a esse token.

GitHubEnterpriseConfig

Representação JSON
{
  "hostUri": string,
  "appId": string,
  "appSlug": string,
  "privateKeySecretVersion": string,
  "webhookSecretSecretVersion": string,
  "appInstallationId": string,
  "installationUri": string,
  "serviceDirectoryConfig": {
    object (ServiceDirectoryConfig)
  },
  "serverVersion": string,
  "sslCaCertificate": string,
  "organization": string
}
Campos
hostUri

string

Obrigatório. O URI do host do GitHub Enterprise para o qual esta conexão é destinada.

appId

string (int64 format)

Opcional. ID do app do GitHub criado com base no manifesto.

appSlug

string

Apenas saída. O nome do app do GitHub compatível com URL.

privateKeySecretVersion

string

Opcional. Recurso do SecretManager que contém a chave privada do app do GitHub, formatado como projects/*/secrets/*/versions/* ou projects/*/locations/*/secrets/*/versions/* (se houver suporte para secrets regionais nesse local).

webhookSecretSecretVersion

string

Opcional. Recurso do SecretManager que contém o secret do webhook do app do GitHub, formatado como projects/*/secrets/*/versions/* ou projects/*/locations/*/secrets/*/versions/* (se secrets regionais forem aceitos nesse local).

appInstallationId

string (int64 format)

Opcional. ID da instalação do app do GitHub.

installationUri

string

Apenas saída. O URI para navegar e gerenciar a instalação associada a este GitHubEnterpriseConfig.

serviceDirectoryConfig

object (ServiceDirectoryConfig)

Opcional. Configuração para usar o Diretório de Serviços para se conectar de forma particular a um servidor do GitHub Enterprise. Isso só deve ser definido se o servidor do GitHub Enterprise estiver hospedado no local e não puder ser acessado pela Internet pública. Se esse campo for deixado em branco, as chamadas para o servidor do GitHub Enterprise serão feitas pela Internet pública.

serverVersion

string

Apenas saída. Versão do GitHub Enterprise instalada no host_uri.

sslCaCertificate

string

Opcional. Certificado SSL a ser usado para solicitações ao GitHub Enterprise.

organization

string

Opcional. Imutável. Organização do GitHub Enterprise em que o app do GitHub é criado.

ServiceDirectoryConfig

Representação JSON
{
  "service": string
}
Campos
service

string

Obrigatório. O nome do serviço do Diretório de Serviços. Formato: projects/{project}/locations/{location}/namespaces/{namespace}/services/{service}.

GitLabConfig

Representação JSON
{
  "webhookSecretSecretVersion": string,
  "readAuthorizerCredential": {
    object (UserCredential)
  },
  "authorizerCredential": {
    object (UserCredential)
  }
}
Campos
webhookSecretSecretVersion

string

Obrigatório. Imutável. Recurso do SecretManager que contém o secret do webhook de um projeto do GitLab, formatado como projects/*/secrets/*/versions/* ou projects/*/locations/*/secrets/*/versions/* (se secrets regionais forem compatíveis com esse local). Isso é usado para validar webhooks.

readAuthorizerCredential

object (UserCredential)

Obrigatório. Um token de acesso pessoal do GitLab com o acesso mínimo ao escopo read_api e um papel mínimo de reporter. Os projetos do GitLab visíveis para esse token de acesso pessoal vão controlar quais projetos o Developer Connect pode acessar.

authorizerCredential

object (UserCredential)

Obrigatório. Um token de acesso pessoal do GitLab com o acesso mínimo ao escopo api e um papel mínimo de maintainer. Os projetos do GitLab visíveis para esse token de acesso pessoal vão controlar quais projetos o Developer Connect pode acessar.

UserCredential

Representação JSON
{
  "userTokenSecretVersion": string,
  "username": string
}
Campos
userTokenSecretVersion

string

Obrigatório. Um recurso do SecretManager que contém o token de usuário que autoriza a conexão do Developer Connect. Formato: projects/*/secrets/*/versions/* ou projects/*/locations/*/secrets/*/versions/* (se secrets regionais forem aceitos nesse local).

username

string

Apenas saída. O nome de usuário associado a esse token.

GitLabEnterpriseConfig

Representação JSON
{
  "hostUri": string,
  "webhookSecretSecretVersion": string,
  "readAuthorizerCredential": {
    object (UserCredential)
  },
  "authorizerCredential": {
    object (UserCredential)
  },
  "serviceDirectoryConfig": {
    object (ServiceDirectoryConfig)
  },
  "sslCaCertificate": string,
  "serverVersion": string
}
Campos
hostUri

string

Obrigatório. O URI do host do GitLab Enterprise ao qual esta conexão se destina.

webhookSecretSecretVersion

string

Obrigatório. Imutável. Recurso do SecretManager que contém o secret do webhook de um projeto do GitLab, formatado como projects/*/secrets/*/versions/* ou projects/*/locations/*/secrets/*/versions/* (se secrets regionais forem compatíveis com esse local). Isso é usado para validar webhooks.

readAuthorizerCredential

object (UserCredential)

Obrigatório. Um token de acesso pessoal do GitLab com o acesso mínimo ao escopo read_api e um papel mínimo de reporter. Os projetos do GitLab visíveis para esse token de acesso pessoal vão controlar quais projetos o Developer Connect pode acessar.

authorizerCredential

object (UserCredential)

Obrigatório. Um token de acesso pessoal do GitLab com o acesso mínimo ao escopo api e um papel mínimo de maintainer. Os projetos do GitLab visíveis para esse token de acesso pessoal vão controlar quais projetos o Developer Connect pode acessar.

serviceDirectoryConfig

object (ServiceDirectoryConfig)

Opcional. Configuração para usar o Diretório de Serviços para se conectar de forma particular a uma instância do GitLab Enterprise. Isso só deve ser definido se o servidor do GitLab Enterprise estiver hospedado no local e não puder ser acessado pela Internet pública. Se esse campo for deixado em branco, as chamadas para o servidor do GitLab Enterprise serão feitas pela Internet pública.

sslCaCertificate

string

Opcional. Certificado da autoridade de certificação SSL a ser usado para solicitações à instância do GitLab Enterprise.

serverVersion

string

Apenas saída. Versão do servidor do GitLab Enterprise em execução no host_uri.

BitbucketDataCenterConfig

Representação JSON
{
  "hostUri": string,
  "webhookSecretSecretVersion": string,
  "readAuthorizerCredential": {
    object (UserCredential)
  },
  "authorizerCredential": {
    object (UserCredential)
  },
  "serviceDirectoryConfig": {
    object (ServiceDirectoryConfig)
  },
  "sslCaCertificate": string,
  "serverVersion": string
}
Campos
hostUri

string

Obrigatório. O URI do host do Bitbucket Data Center ao qual esta conexão se destina.

webhookSecretSecretVersion

string

Obrigatório. Imutável. Recurso do SecretManager que contém o secret do webhook usado para verificar eventos de webhook, formatado como projects/*/secrets/*/versions/* ou projects/*/locations/*/secrets/*/versions/* (se secrets regionais forem compatíveis com esse local). Isso é usado para validar webhooks.

readAuthorizerCredential

object (UserCredential)

Obrigatório. Um token de acesso HTTP com o acesso mínimo de Repository read. Recomendamos usar uma conta do sistema para gerar as credenciais.

authorizerCredential

object (UserCredential)

Obrigatório. Um token de acesso HTTP com o acesso mínimo ao escopo Repository admin. Isso é necessário para criar webhooks. Recomendamos usar uma conta do sistema para gerar essas credenciais.

serviceDirectoryConfig

object (ServiceDirectoryConfig)

Opcional. Configuração para usar o Diretório de Serviços para se conectar de forma particular a uma instância do Bitbucket Data Center. Isso só deve ser definido se o Bitbucket Data Center estiver hospedado no local e não puder ser acessado pela Internet pública. Se esse campo ficar em branco, as chamadas para o Bitbucket Data Center serão feitas pela Internet pública.

sslCaCertificate

string

Opcional. Autoridade de certificação SSL em que confiar ao fazer solicitações ao Bitbucket Data Center.

serverVersion

string

Apenas saída. Versão do servidor do Bitbucket Data Center em execução no host_uri.

BitbucketCloudConfig

Representação JSON
{
  "workspace": string,
  "webhookSecretSecretVersion": string,
  "readAuthorizerCredential": {
    object (UserCredential)
  },
  "authorizerCredential": {
    object (UserCredential)
  }
}
Campos
workspace

string

Obrigatório. O ID do espaço de trabalho do Bitbucket Cloud que será conectado ao Google Cloud Platform.

webhookSecretSecretVersion

string

Obrigatório. Imutável. Recurso do SecretManager que contém o secret do webhook usado para verificar eventos de webhook, formatado como projects/*/secrets/*/versions/* ou projects/*/locations/*/secrets/*/versions/* (se secrets regionais forem compatíveis com esse local). Isso é usado para validar e criar webhooks.

readAuthorizerCredential

object (UserCredential)

Obrigatório. Um token de acesso com o acesso mínimo de repository. Pode ser um token de acesso de espaço de trabalho, projeto ou repositório. Recomendamos usar uma conta do sistema para gerar as credenciais.

authorizerCredential

object (UserCredential)

Obrigatório. Um token de acesso com o acesso mínimo ao escopo repository, pullrequest e webhook. Pode ser um token de acesso de espaço de trabalho, projeto ou repositório. Isso é necessário para criar webhooks. Recomendamos usar uma conta do sistema para gerar essas credenciais.

SecureSourceManagerInstanceConfig

Representação JSON
{
  "instance": string
}
Campos
instance

string

Obrigatório. Imutável. Recurso de instância do Secure Source Manager, formatado como projects/*/locations/*/instances/*

GenericHTTPEndpointConfig

Representação JSON
{
  "hostUri": string,
  "serviceDirectoryConfig": {
    object (ServiceDirectoryConfig)
  },
  "sslCaCertificate": string,

  // Union field authentication can be only one of the following:
  "basicAuthentication": {
    object (BasicAuthentication)
  },
  "bearerTokenAuthentication": {
    object (BearerTokenAuthentication)
  }
  // End of list of possible types for union field authentication.
}
Campos
hostUri

string

Obrigatório. Imutável. O endpoint https do provedor de serviços.

serviceDirectoryConfig

object (ServiceDirectoryConfig)

Opcional. Configuração para usar o Diretório de Serviços para se conectar de forma particular a um provedor de serviços HTTP. Isso só deve ser definido se o provedor de serviços HTTP estiver hospedado no local e não puder ser acessado pela Internet pública. Se esse campo for deixado em branco, as chamadas para o provedor de serviços HTTP serão feitas pela Internet pública.

sslCaCertificate

string

Opcional. O certificado SSL a ser usado para solicitações ao provedor de serviços HTTP.

Campo de união authentication. O mecanismo de autenticação a ser usado para solicitações ao provedor de serviços HTTP. authentication pode ser apenas de um dos tipos a seguir:
basicAuthentication

object (BasicAuthentication)

Opcional. Autenticação básica com nome de usuário e senha.

bearerTokenAuthentication

object (BearerTokenAuthentication)

Opcional. Autenticação de token do portador com um token.

BasicAuthentication

Representação JSON
{
  "username": string,

  // Union field password can be only one of the following:
  "passwordSecretVersion": string
  // End of list of possible types for union field password.
}
Campos
username

string

Obrigatório. O nome de usuário para autenticação.

Campo de união password. A senha para autenticação. password pode ser apenas de um dos tipos a seguir:
passwordSecretVersion

string

A versão do secret do SecretManager da senha para autenticação.

BearerTokenAuthentication

Representação JSON
{

  // Union field token can be only one of the following:
  "tokenSecretVersion": string
  // End of list of possible types for union field token.
}
Campos
Campo de união token. O token para autenticação. token pode ser apenas de um dos tipos a seguir:
tokenSecretVersion

string

Opcional. A versão do secret do SecretManager do token para autenticação.

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.

LabelsEntry

Representação JSON
{
  "key": string,
  "value": string
}
Campos
key

string

value

string

InstallationState

Representação JSON
{
  "stage": enum (Stage),
  "message": string,
  "actionUri": string
}
Campos
stage

enum (Stage)

Apenas saída. Etapa atual do processo de instalação.

message

string

Apenas saída. Mensagem sobre o que o usuário deve fazer em seguida para continuar a instalação. String vazia se a instalação já estiver concluída.

actionUri

string

Apenas saída. Link para a próxima ação. String vazia se a instalação já estiver concluída.

AnnotationsEntry

Representação JSON
{
  "key": string,
  "value": string
}
Campos
key

string

value

string

CryptoKeyConfig

Representação JSON
{
  "keyReference": string
}
Campos
keyReference

string

Obrigatório. O nome da chave usada para criptografar/descriptografar os dados do cliente. Para a chave no Cloud KMS, ela precisa estar no formato projects/*/locations/*/keyRings/*/cryptoKeys/*.

GitProxyConfig

Representação JSON
{
  "enabled": boolean,
  "httpProxyBaseUri": string
}
Campos
enabled

boolean

Opcional. Definir como verdadeiro permite que o proxy do Git seja usado para realizar operações do Git nos repositórios vinculados na conexão.

httpProxyBaseUri

string

Apenas saída. O URI base do endpoint do proxy HTTP. Tem o formato https://{generatedID}-c-h-{shortRegion}.developerconnect.dev. Preenchido apenas quando enabled é definido como verdadeiro. Esse endpoint é usado por outros serviços do Google que se integram ao Developer Connect.

GitHubApp

Representa os vários aplicativos do GitHub que podem ser instalados em um usuário ou organização do GitHub e usados com o Developer Connect.

Tipos enumerados
GIT_HUB_APP_UNSPECIFIED O app GitHub não foi especificado.
DEVELOPER_CONNECT O aplicativo do GitHub do Developer Connect.
FIREBASE O aplicativo do Firebase no GitHub.
GEMINI_CODE_ASSIST O aplicativo Gemini Code Assist.
DATAFORM O aplicativo Dataform do GitHub.

Fase

Fase do processo de instalação.

Tipos enumerados
STAGE_UNSPECIFIED Nenhum estágio especificado.
PENDING_CREATE_APP Somente para o GitHub Enterprise. A criação de um app foi solicitada. O usuário precisa confirmar a criação no host do GitHub Enterprise.
PENDING_USER_OAUTH O usuário precisa autorizar o app do GitHub (ou Enterprise) via OAuth.
PENDING_INSTALL_APP O usuário precisa seguir o link para instalar o app do GitHub (ou Enterprise).
COMPLETE O processo de instalação foi concluído.

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: ❌