Outil : list-connections
Répertorie les connexions d'un projet et d'un emplacement donnés.
L'exemple de code suivant montre comment utiliser curl pour appeler l'outil MCP list-connections.
| Requête 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 }' |
Schéma d'entrée
Message de demande de la liste des connexions
ListConnectionsRequest
| Représentation JSON |
|---|
{ "parent": string, "pageSize": integer, "pageToken": string, "filter": string, "orderBy": string } |
| Champs | |
|---|---|
parent |
Obligatoire. Valeur parente pour ListConnectionsRequest |
pageSize |
Facultatif. Taille de la page demandée. Le serveur peut renvoyer un nombre d'éléments inférieur à celui demandé. Si aucune valeur n'est spécifiée, le serveur sélectionne une valeur par défaut appropriée. |
pageToken |
Facultatif. Jeton identifiant une page de résultats que le serveur doit renvoyer. |
filter |
Facultatif. Filtrage des résultats. |
orderBy |
Facultatif. Indication sur la façon d'organiser les résultats. |
Schéma de sortie
Message de réponse pour la liste des connexions
ListConnectionsResponse
| Représentation JSON |
|---|
{
"connections": [
{
object ( |
| Champs | |
|---|---|
connections[] |
Liste des connexions. |
nextPageToken |
Jeton identifiant une page de résultats que le serveur doit renvoyer. |
unreachable[] |
Emplacements inaccessibles. |
Connexion
| Représentation JSON |
|---|
{ "name": string, "createTime": string, "updateTime": string, "deleteTime": string, "labels": { string: string, ... }, "installationState": { object ( |
| Champs | |
|---|---|
name |
Identifiant. Nom de ressource de la connexion, au format |
createTime |
Uniquement en sortie. Code temporel de création. Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : |
updateTime |
Uniquement en sortie. Horodatage de mise à jour. Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : |
deleteTime |
Uniquement en sortie. Supprimez le code temporel. Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : |
labels |
Facultatif. Étiquettes sous forme de paires clé/valeur Objet contenant une liste de paires |
installationState |
Uniquement en sortie. État d'installation de la connexion. |
disabled |
Facultatif. Si la valeur est "true", la fonctionnalité est désactivée pour cette connexion. Les méthodes d'API basées sur les dépôts et le traitement des webhooks pour les dépôts de cette connexion seront désactivés. |
reconciling |
Uniquement en sortie. Défini sur "true" lorsque la connexion est en cours de configuration ou de mise à jour en arrière-plan. |
annotations |
Facultatif. Permet aux clients de stocker de petites quantités de données arbitraires. Objet contenant une liste de paires |
etag |
Facultatif. Cette somme de contrôle est calculée par le serveur en fonction de la valeur des autres champs. Elle peut être envoyée lors des requêtes de mise à jour et de suppression pour s'assurer que le client dispose d'une valeur à jour avant de continuer. |
uid |
Uniquement en sortie. Identifiant unique attribué par le système pour la connexion. |
cryptoKeyConfig |
Facultatif. Configuration de la clé de chiffrement. Ce champ est utilisé par la fonctionnalité de clés de chiffrement gérées par le client (CMEK). |
gitProxyConfig |
Facultatif. Configuration de la fonctionnalité de proxy Git. L'activation du proxy Git permet aux clients d'effectuer des opérations Git sur les dépôts associés à la connexion. En savoir plus |
Champ d'union connection_config. Configuration de la connexion en fonction du type de fournisseur. connection_config ne peut être qu'un des éléments suivants : |
|
githubConfig |
Configuration des connexions à github.com. |
githubEnterpriseConfig |
Configuration des connexions à une instance de GitHub Enterprise. |
gitlabConfig |
Configuration des connexions à gitlab.com. |
gitlabEnterpriseConfig |
Configuration des connexions à une instance de GitLab Enterprise. |
bitbucketDataCenterConfig |
Configuration des connexions à une instance de Bitbucket Data Center. |
bitbucketCloudConfig |
Configuration des connexions à une instance de Bitbucket Cloud. |
secureSourceManagerInstanceConfig |
Configuration des connexions à une instance de Secure Source Manager. |
httpConfig |
Facultatif. Configuration des connexions à un fournisseur de services HTTP. |
GitHubConfig
| Représentation JSON |
|---|
{ "githubApp": enum ( |
| Champs | |
|---|---|
githubApp |
Obligatoire. Immuable. L'application GitHub qui a été installée pour l'utilisateur ou l'organisation GitHub. |
authorizerCredential |
Facultatif. Identifiant OAuth du compte qui a autorisé l'application GitHub. Nous vous recommandons d'utiliser un compte robot plutôt qu'un compte utilisateur humain. Le jeton OAuth doit être associé à l'application GitHub de cette configuration. |
appInstallationId |
Facultatif. ID d'installation de l'application GitHub. |
installationUri |
Uniquement en sortie. URI vers lequel naviguer pour gérer l'installation associée à ce GitHubConfig. |
OAuthCredential
| Représentation JSON |
|---|
{ "oauthTokenSecretVersion": string, "username": string } |
| Champs | |
|---|---|
oauthTokenSecretVersion |
Obligatoire. Ressource Secret Manager contenant le jeton OAuth qui autorise la connexion. Format : |
username |
Uniquement en sortie. Nom d'utilisateur associé à ce jeton. |
GitHubEnterpriseConfig
| Représentation JSON |
|---|
{
"hostUri": string,
"appId": string,
"appSlug": string,
"privateKeySecretVersion": string,
"webhookSecretSecretVersion": string,
"appInstallationId": string,
"installationUri": string,
"serviceDirectoryConfig": {
object ( |
| Champs | |
|---|---|
hostUri |
Obligatoire. URI de l'hôte GitHub Enterprise auquel cette connexion est destinée. |
appId |
Facultatif. ID de l'application GitHub créée à partir du fichier manifeste. |
appSlug |
Uniquement en sortie. Nom de l'application GitHub compatible avec les URL. |
privateKeySecretVersion |
Facultatif. Ressource SecretManager contenant la clé privée de l'application GitHub, au format |
webhookSecretSecretVersion |
Facultatif. Ressource SecretManager contenant le secret du webhook de l'application GitHub, au format |
appInstallationId |
Facultatif. ID de l'installation de l'application GitHub. |
installationUri |
Uniquement en sortie. URI vers lequel naviguer pour gérer l'installation associée à cette GitHubEnterpriseConfig. |
serviceDirectoryConfig |
Facultatif. Configuration permettant d'utiliser l'Annuaire des services pour se connecter en mode privé à un serveur GitHub Enterprise. Ce paramètre ne doit être défini que si le serveur GitHub Enterprise est hébergé sur site et n'est pas accessible via l'Internet public. Si ce champ est laissé vide, les appels au serveur GitHub Enterprise seront effectués via l'Internet public. |
serverVersion |
Uniquement en sortie. Version de GitHub Enterprise installée sur l'URI de l'hôte. |
sslCaCertificate |
Facultatif. Certificat SSL à utiliser pour les requêtes adressées à GitHub Enterprise. |
organization |
Facultatif. Immuable. Organisation GitHub Enterprise dans laquelle l'application GitHub est créée. |
ServiceDirectoryConfig
| Représentation JSON |
|---|
{ "service": string } |
| Champs | |
|---|---|
service |
Obligatoire. Nom du service de l'Annuaire des services. Format : projects/{project}/locations/{location}/namespaces/{namespace}/services/{service}. |
GitLabConfig
| Représentation JSON |
|---|
{ "webhookSecretSecretVersion": string, "readAuthorizerCredential": { object ( |
| Champs | |
|---|---|
webhookSecretSecretVersion |
Obligatoire. Immuable. Ressource SecretManager contenant le secret du webhook d'un projet GitLab, au format |
readAuthorizerCredential |
Obligatoire. Un jeton d'accès personnel GitLab avec un accès minimal au champ d'application |
authorizerCredential |
Obligatoire. Un jeton d'accès personnel GitLab avec un accès minimal au champ d'application |
UserCredential
| Représentation JSON |
|---|
{ "userTokenSecretVersion": string, "username": string } |
| Champs | |
|---|---|
userTokenSecretVersion |
Obligatoire. Ressource Secret Manager contenant le jeton utilisateur qui autorise la connexion Developer Connect. Format : |
username |
Uniquement en sortie. Nom d'utilisateur associé à ce jeton. |
GitLabEnterpriseConfig
| Représentation JSON |
|---|
{ "hostUri": string, "webhookSecretSecretVersion": string, "readAuthorizerCredential": { object ( |
| Champs | |
|---|---|
hostUri |
Obligatoire. URI de l'hôte GitLab Enterprise auquel cette connexion est destinée. |
webhookSecretSecretVersion |
Obligatoire. Immuable. Ressource Secret Manager contenant le secret du webhook d'un projet GitLab, au format |
readAuthorizerCredential |
Obligatoire. Un jeton d'accès personnel GitLab avec un accès minimal au champ d'application |
authorizerCredential |
Obligatoire. Un jeton d'accès personnel GitLab avec un accès minimal au champ d'application |
serviceDirectoryConfig |
Facultatif. Configuration permettant d'utiliser l'Annuaire des services pour se connecter en mode privé à une instance GitLab Enterprise. Cette option ne doit être définie que si le serveur GitLab Enterprise est hébergé sur site et n'est pas accessible via l'Internet public. Si ce champ n'est pas renseigné, les appels au serveur GitLab Enterprise seront effectués via l'Internet public. |
sslCaCertificate |
Facultatif. Certificat d'autorité de certification SSL à utiliser pour les requêtes adressées à l'instance GitLab Enterprise. |
serverVersion |
Uniquement en sortie. Version du serveur GitLab Enterprise s'exécutant sur |
BitbucketDataCenterConfig
| Représentation JSON |
|---|
{ "hostUri": string, "webhookSecretSecretVersion": string, "readAuthorizerCredential": { object ( |
| Champs | |
|---|---|
hostUri |
Obligatoire. URI de l'hôte Bitbucket Data Center auquel cette connexion est destinée. |
webhookSecretSecretVersion |
Obligatoire. Immuable. Ressource Secret Manager contenant le secret de webhook utilisé pour valider les événements de webhook, au format |
readAuthorizerCredential |
Obligatoire. Un jeton d'accès HTTP avec l'accès |
authorizerCredential |
Obligatoire. Un jeton d'accès HTTP avec l'accès minimal au champ d'application |
serviceDirectoryConfig |
Facultatif. Configuration permettant d'utiliser l'Annuaire des services pour se connecter en mode privé à une instance Bitbucket Data Center. Cette option ne doit être définie que si Bitbucket Data Center est hébergé sur site et n'est pas accessible via l'Internet public. Si ce champ n'est pas renseigné, les appels vers Bitbucket Data Center seront effectués via l'Internet public. |
sslCaCertificate |
Facultatif. Autorité de certification SSL à approuver lors de l'envoi de requêtes au centre de données Bitbucket. |
serverVersion |
Uniquement en sortie. Version du serveur Bitbucket Data Center exécuté sur |
BitbucketCloudConfig
| Représentation JSON |
|---|
{ "workspace": string, "webhookSecretSecretVersion": string, "readAuthorizerCredential": { object ( |
| Champs | |
|---|---|
workspace |
Obligatoire. ID de l'espace de travail Bitbucket Cloud à connecter à Google Cloud Platform. |
webhookSecretSecretVersion |
Obligatoire. Immuable. Ressource Secret Manager contenant le secret de webhook utilisé pour valider les événements de webhook, au format |
readAuthorizerCredential |
Obligatoire. Un jeton d'accès avec l'accès |
authorizerCredential |
Obligatoire. Un jeton d'accès avec un accès minimal aux champs d'application |
SecureSourceManagerInstanceConfig
| Représentation JSON |
|---|
{ "instance": string } |
| Champs | |
|---|---|
instance |
Obligatoire. Immuable. Ressource d'instance Secure Source Manager, au format |
GenericHTTPEndpointConfig
| Représentation JSON |
|---|
{ "hostUri": string, "serviceDirectoryConfig": { object ( |
| Champs | |
|---|---|
hostUri |
Obligatoire. Immuable. Point de terminaison HTTPS du fournisseur de services. |
serviceDirectoryConfig |
Facultatif. Configuration permettant d'utiliser l'Annuaire des services pour se connecter en mode privé à un fournisseur de services HTTP. Cette option ne doit être définie que si le fournisseur de services HTTP est hébergé sur site et n'est pas accessible via l'Internet public. Si ce champ n'est pas renseigné, les appels au fournisseur de services HTTP seront effectués via l'Internet public. |
sslCaCertificate |
Facultatif. Certificat SSL à utiliser pour les requêtes adressées au fournisseur de services HTTP. |
Champ d'union authentication. Mécanisme d'authentification à utiliser pour les requêtes adressées au fournisseur de services HTTP. authentication ne peut être qu'un des éléments suivants : |
|
basicAuthentication |
Facultatif. Authentification de base avec nom d'utilisateur et mot de passe. |
bearerTokenAuthentication |
Facultatif. Authentification par jeton de support avec un jeton. |
BasicAuthentication
| Représentation JSON |
|---|
{ "username": string, // Union field |
| Champs | |
|---|---|
username |
Obligatoire. Nom d'utilisateur à utiliser pour l'authentification. |
Champ d'union password. Mot de passe à utiliser pour l'authentification. password ne peut être qu'un des éléments suivants : |
|
passwordSecretVersion |
Version du secret Secret Manager du mot de passe à utiliser pour l'authentification. |
BearerTokenAuthentication
| Représentation JSON |
|---|
{ // Union field |
| Champs | |
|---|---|
Champ d'union token. Jeton à utiliser pour l'authentification. token ne peut être qu'un des éléments suivants : |
|
tokenSecretVersion |
Facultatif. Version du secret Secret Manager du jeton à utiliser pour l'authentification. |
Horodatage
| Représentation JSON |
|---|
{ "seconds": string, "nanos": integer } |
| Champs | |
|---|---|
seconds |
Représente les secondes de l'heure UTC à partir de l'epoch Unix 1970-01-01T00:00:00Z. Doit être compris entre -62135596800 et 253402300799 inclus (ce qui correspond à la période allant du 01/01/0001 à 00:00:00 UTC au 31/12/9999 à 23:59:59 UTC). |
nanos |
Fractions de secondes non négatives avec une précision de l'ordre de la nanoseconde. Ce champ correspond à la partie en nanosecondes de la durée, et non à une alternative aux secondes. Les valeurs de secondes négatives avec des fractions doivent toujours comporter des valeurs de nanosecondes non négatives comptabilisées dans le temps. La valeur doit être comprise entre 0 et 999 999 999 (inclus). |
LabelsEntry
| Représentation JSON |
|---|
{ "key": string, "value": string } |
| Champs | |
|---|---|
key |
|
value |
|
InstallationState
| Représentation JSON |
|---|
{
"stage": enum ( |
| Champs | |
|---|---|
stage |
Uniquement en sortie. Étape actuelle du processus d'installation. |
message |
Uniquement en sortie. Message indiquant à l'utilisateur ce qu'il doit faire pour poursuivre l'installation. Chaîne vide si l'installation est déjà terminée. |
actionUri |
Uniquement en sortie. Lien à suivre pour l'action suivante. Chaîne vide si l'installation est déjà terminée. |
AnnotationsEntry
| Représentation JSON |
|---|
{ "key": string, "value": string } |
| Champs | |
|---|---|
key |
|
value |
|
CryptoKeyConfig
| Représentation JSON |
|---|
{ "keyReference": string } |
| Champs | |
|---|---|
keyReference |
Obligatoire. Nom de la clé utilisée pour chiffrer/déchiffrer les données client. Pour une clé dans Cloud KMS, la clé doit être au format |
GitProxyConfig
| Représentation JSON |
|---|
{ "enabled": boolean, "httpProxyBaseUri": string } |
| Champs | |
|---|---|
enabled |
Facultatif. Si vous définissez cette option sur "true", le proxy Git peut être utilisé pour effectuer des opérations Git sur les dépôts associés à la connexion. |
httpProxyBaseUri |
Uniquement en sortie. URI de base du point de terminaison du proxy HTTP. Il est au format |
GitHubApp
Représente les différentes applications GitHub qui peuvent être installées pour un utilisateur ou une organisation GitHub, et utilisées avec Developer Connect.
| Enums | |
|---|---|
GIT_HUB_APP_UNSPECIFIED |
Application GitHub non spécifiée. |
DEVELOPER_CONNECT |
L'application GitHub Developer Connect. |
FIREBASE |
L'application Firebase GitHub. |
GEMINI_CODE_ASSIST |
L'application Gemini Code Assist. |
DATAFORM |
L'application GitHub Dataform. |
Étape
Étape du processus d'installation.
| Enums | |
|---|---|
STAGE_UNSPECIFIED |
Aucune étape spécifiée. |
PENDING_CREATE_APP |
Uniquement pour GitHub Enterprise. Une demande de création d'application a été envoyée. L'utilisateur doit confirmer la création dans son hôte GitHub Enterprise. |
PENDING_USER_OAUTH |
L'utilisateur doit autoriser l'application GitHub (ou Enterprise) via OAuth. |
PENDING_INSTALL_APP |
L'utilisateur doit suivre le lien pour installer l'application GitHub (ou Enterprise). |
COMPLETE |
Le processus d'installation est terminé. |
Annotations d'outils
Les annotations d'outil sont envoyées aux clients MCP pour décrire le risque de base d'un outil donné. La plupart des clients considèrent ces indications comme non fiables, mais elles peuvent être utilisées pour décider quand envoyer une invite de confirmation à un utilisateur.
En plus de la chaîne de titre, les indices booléens suivants sont définis comme suit :
readOnlyHint: si la valeur est "true", l'outil ne modifie pas son environnement. Valeur par défaut : "false".destructiveHint: si la valeur est "true", l'outil peut effectuer des actions destructrices. Si la valeur est "false", l'outil ne peut effectuer que des actions d'ajout. Valeur par défaut : "true".idempotentHint: si la valeur est "true", l'appel répété de l'outil avec les mêmes arguments n'aura aucun effet supplémentaire sur son environnement. Valeur par défaut : "false".openWorldHint: si la valeur est "true", l'outil peut interagir avec un "monde ouvert" d'entités externes. Si la valeur est "false", l'outil ne peut interagir qu'avec des entités internes. Par exemple, un outil de recherche sur le Web serait en monde ouvert, tandis qu'un outil de mémoire ne le serait pas.
Indice "Destructive" : ❌ | Indice "Idempotent" : ✅ | Indice "Read Only" : ✅ | Indice "Open World" : ❌