MCP Tools Reference: developerconnect.googleapis.com

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

string

Obligatoire. Valeur parente pour ListConnectionsRequest

pageSize

integer

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

string

Facultatif. Jeton identifiant une page de résultats que le serveur doit renvoyer.

filter

string

Facultatif. Filtrage des résultats.

orderBy

string

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 (Connection)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Champs
connections[]

object (Connection)

Liste des connexions.

nextPageToken

string

Jeton identifiant une page de résultats que le serveur doit renvoyer.

unreachable[]

string

Emplacements inaccessibles.

Connexion

Représentation 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.
}
Champs
name

string

Identifiant. Nom de ressource de la connexion, au format projects/{project}/locations/{location}/connections/{connection_id}.

createTime

string (Timestamp format)

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

updateTime

string (Timestamp format)

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

deleteTime

string (Timestamp format)

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 : "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)

Facultatif. Étiquettes sous forme de paires clé/valeur

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.

installationState

object (InstallationState)

Uniquement en sortie. État d'installation de la connexion.

disabled

boolean

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

boolean

Uniquement en sortie. Défini sur "true" lorsque la connexion est en cours de configuration ou de mise à jour en arrière-plan.

annotations

map (key: string, value: string)

Facultatif. Permet aux clients de stocker de petites quantités de données arbitraires.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.

etag

string

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

string

Uniquement en sortie. Identifiant unique attribué par le système pour la connexion.

cryptoKeyConfig

object (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

object (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

object (GitHubConfig)

Configuration des connexions à github.com.

githubEnterpriseConfig

object (GitHubEnterpriseConfig)

Configuration des connexions à une instance de GitHub Enterprise.

gitlabConfig

object (GitLabConfig)

Configuration des connexions à gitlab.com.

gitlabEnterpriseConfig

object (GitLabEnterpriseConfig)

Configuration des connexions à une instance de GitLab Enterprise.

bitbucketDataCenterConfig

object (BitbucketDataCenterConfig)

Configuration des connexions à une instance de Bitbucket Data Center.

bitbucketCloudConfig

object (BitbucketCloudConfig)

Configuration des connexions à une instance de Bitbucket Cloud.

secureSourceManagerInstanceConfig

object (SecureSourceManagerInstanceConfig)

Configuration des connexions à une instance de Secure Source Manager.

httpConfig

object (GenericHTTPEndpointConfig)

Facultatif. Configuration des connexions à un fournisseur de services HTTP.

GitHubConfig

Représentation JSON
{
  "githubApp": enum (GitHubApp),
  "authorizerCredential": {
    object (OAuthCredential)
  },
  "appInstallationId": string,
  "installationUri": string
}
Champs
githubApp

enum (GitHubApp)

Obligatoire. Immuable. L'application GitHub qui a été installée pour l'utilisateur ou l'organisation GitHub.

authorizerCredential

object (OAuthCredential)

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

string (int64 format)

Facultatif. ID d'installation de l'application GitHub.

installationUri

string

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

string

Obligatoire. Ressource Secret Manager contenant le jeton OAuth qui autorise la connexion. Format : projects/*/secrets/*/versions/* ou projects/*/locations/*/secrets/*/versions/* (si les secrets régionaux sont acceptés dans cet emplacement).

username

string

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 (ServiceDirectoryConfig)
  },
  "serverVersion": string,
  "sslCaCertificate": string,
  "organization": string
}
Champs
hostUri

string

Obligatoire. URI de l'hôte GitHub Enterprise auquel cette connexion est destinée.

appId

string (int64 format)

Facultatif. ID de l'application GitHub créée à partir du fichier manifeste.

appSlug

string

Uniquement en sortie. Nom de l'application GitHub compatible avec les URL.

privateKeySecretVersion

string

Facultatif. Ressource SecretManager contenant la clé privée de l'application GitHub, au format projects/*/secrets/*/versions/* ou projects/*/locations/*/secrets/*/versions/* (si les secrets régionaux sont acceptés dans cet emplacement).

webhookSecretSecretVersion

string

Facultatif. Ressource SecretManager contenant le secret du webhook de l'application GitHub, au format projects/*/secrets/*/versions/* ou projects/*/locations/*/secrets/*/versions/* (si les secrets régionaux sont acceptés dans cet emplacement).

appInstallationId

string (int64 format)

Facultatif. ID de l'installation de l'application GitHub.

installationUri

string

Uniquement en sortie. URI vers lequel naviguer pour gérer l'installation associée à cette GitHubEnterpriseConfig.

serviceDirectoryConfig

object (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

string

Uniquement en sortie. Version de GitHub Enterprise installée sur l'URI de l'hôte.

sslCaCertificate

string

Facultatif. Certificat SSL à utiliser pour les requêtes adressées à GitHub Enterprise.

organization

string

Facultatif. Immuable. Organisation GitHub Enterprise dans laquelle l'application GitHub est créée.

ServiceDirectoryConfig

Représentation JSON
{
  "service": string
}
Champs
service

string

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 (UserCredential)
  },
  "authorizerCredential": {
    object (UserCredential)
  }
}
Champs
webhookSecretSecretVersion

string

Obligatoire. Immuable. Ressource SecretManager contenant le secret du webhook d'un projet GitLab, au format projects/*/secrets/*/versions/* ou projects/*/locations/*/secrets/*/versions/* (si les secrets régionaux sont acceptés dans cet emplacement). Il permet de valider les webhooks.

readAuthorizerCredential

object (UserCredential)

Obligatoire. Un jeton d'accès personnel GitLab avec un accès minimal au champ d'application read_api et un rôle minimal de reporter. Les projets GitLab visibles par ce jeton d'accès personnel contrôlent les projets auxquels Developer Connect a accès.

authorizerCredential

object (UserCredential)

Obligatoire. Un jeton d'accès personnel GitLab avec un accès minimal au champ d'application api et un rôle minimal de maintainer. Les projets GitLab visibles par ce jeton d'accès personnel contrôlent les projets auxquels Developer Connect a accès.

UserCredential

Représentation JSON
{
  "userTokenSecretVersion": string,
  "username": string
}
Champs
userTokenSecretVersion

string

Obligatoire. Ressource Secret Manager contenant le jeton utilisateur qui autorise la connexion Developer Connect. Format : projects/*/secrets/*/versions/* ou projects/*/locations/*/secrets/*/versions/* (si les secrets régionaux sont acceptés dans cet emplacement).

username

string

Uniquement en sortie. Nom d'utilisateur associé à ce jeton.

GitLabEnterpriseConfig

Représentation JSON
{
  "hostUri": string,
  "webhookSecretSecretVersion": string,
  "readAuthorizerCredential": {
    object (UserCredential)
  },
  "authorizerCredential": {
    object (UserCredential)
  },
  "serviceDirectoryConfig": {
    object (ServiceDirectoryConfig)
  },
  "sslCaCertificate": string,
  "serverVersion": string
}
Champs
hostUri

string

Obligatoire. URI de l'hôte GitLab Enterprise auquel cette connexion est destinée.

webhookSecretSecretVersion

string

Obligatoire. Immuable. Ressource Secret Manager contenant le secret du webhook d'un projet GitLab, au format projects/*/secrets/*/versions/* ou projects/*/locations/*/secrets/*/versions/* (si les secrets régionaux sont acceptés dans cet emplacement). Il permet de valider les webhooks.

readAuthorizerCredential

object (UserCredential)

Obligatoire. Un jeton d'accès personnel GitLab avec un accès minimal au champ d'application read_api et un rôle minimal de reporter. Les projets GitLab visibles par ce jeton d'accès personnel contrôlent les projets auxquels Developer Connect a accès.

authorizerCredential

object (UserCredential)

Obligatoire. Un jeton d'accès personnel GitLab avec un accès minimal au champ d'application api et un rôle minimal de maintainer. Les projets GitLab visibles par ce jeton d'accès personnel contrôlent les projets auxquels Developer Connect a accès.

serviceDirectoryConfig

object (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

string

Facultatif. Certificat d'autorité de certification SSL à utiliser pour les requêtes adressées à l'instance GitLab Enterprise.

serverVersion

string

Uniquement en sortie. Version du serveur GitLab Enterprise s'exécutant sur host_uri.

BitbucketDataCenterConfig

Représentation JSON
{
  "hostUri": string,
  "webhookSecretSecretVersion": string,
  "readAuthorizerCredential": {
    object (UserCredential)
  },
  "authorizerCredential": {
    object (UserCredential)
  },
  "serviceDirectoryConfig": {
    object (ServiceDirectoryConfig)
  },
  "sslCaCertificate": string,
  "serverVersion": string
}
Champs
hostUri

string

Obligatoire. URI de l'hôte Bitbucket Data Center auquel cette connexion est destinée.

webhookSecretSecretVersion

string

Obligatoire. Immuable. Ressource Secret Manager contenant le secret de webhook utilisé pour valider les événements de webhook, au format projects/*/secrets/*/versions/* ou projects/*/locations/*/secrets/*/versions/* (si les secrets régionaux sont acceptés dans cet emplacement). Il permet de valider les webhooks.

readAuthorizerCredential

object (UserCredential)

Obligatoire. Un jeton d'accès HTTP avec l'accès Repository read minimal. Il est recommandé d'utiliser un compte système pour générer les identifiants.

authorizerCredential

object (UserCredential)

Obligatoire. Un jeton d'accès HTTP avec l'accès minimal au champ d'application Repository admin. Cette autorisation est nécessaire pour créer des webhooks. Nous vous recommandons d'utiliser un compte système pour générer ces identifiants.

serviceDirectoryConfig

object (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

string

Facultatif. Autorité de certification SSL à approuver lors de l'envoi de requêtes au centre de données Bitbucket.

serverVersion

string

Uniquement en sortie. Version du serveur Bitbucket Data Center exécuté sur host_uri.

BitbucketCloudConfig

Représentation JSON
{
  "workspace": string,
  "webhookSecretSecretVersion": string,
  "readAuthorizerCredential": {
    object (UserCredential)
  },
  "authorizerCredential": {
    object (UserCredential)
  }
}
Champs
workspace

string

Obligatoire. ID de l'espace de travail Bitbucket Cloud à connecter à Google Cloud Platform.

webhookSecretSecretVersion

string

Obligatoire. Immuable. Ressource Secret Manager contenant le secret de webhook utilisé pour valider les événements de webhook, au format projects/*/secrets/*/versions/* ou projects/*/locations/*/secrets/*/versions/* (si les secrets régionaux sont acceptés dans cet emplacement). Cette valeur permet de valider et de créer des webhooks.

readAuthorizerCredential

object (UserCredential)

Obligatoire. Un jeton d'accès avec l'accès repository minimal. Il peut s'agir d'un jeton d'accès à un espace de travail, à un projet ou à un dépôt. Il est recommandé d'utiliser un compte système pour générer les identifiants.

authorizerCredential

object (UserCredential)

Obligatoire. Un jeton d'accès avec un accès minimal aux champs d'application repository, pullrequest et webhook. Il peut s'agir d'un jeton d'accès à un espace de travail, à un projet ou à un dépôt. Cette autorisation est nécessaire pour créer des webhooks. Nous vous recommandons d'utiliser un compte système pour générer ces identifiants.

SecureSourceManagerInstanceConfig

Représentation JSON
{
  "instance": string
}
Champs
instance

string

Obligatoire. Immuable. Ressource d'instance Secure Source Manager, au format projects/*/locations/*/instances/*

GenericHTTPEndpointConfig

Représentation 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.
}
Champs
hostUri

string

Obligatoire. Immuable. Point de terminaison HTTPS du fournisseur de services.

serviceDirectoryConfig

object (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

string

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

object (BasicAuthentication)

Facultatif. Authentification de base avec nom d'utilisateur et mot de passe.

bearerTokenAuthentication

object (BearerTokenAuthentication)

Facultatif. Authentification par jeton de support avec un jeton.

BasicAuthentication

Représentation 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.
}
Champs
username

string

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

string

Version du secret Secret Manager du mot de passe à utiliser pour l'authentification.

BearerTokenAuthentication

Représentation JSON
{

  // Union field token can be only one of the following:
  "tokenSecretVersion": string
  // End of list of possible types for union field token.
}
Champs
Champ d'union token. Jeton à utiliser pour l'authentification. token ne peut être qu'un des éléments suivants :
tokenSecretVersion

string

Facultatif. Version du secret Secret Manager du jeton à utiliser pour l'authentification.

Horodatage

Représentation JSON
{
  "seconds": string,
  "nanos": integer
}
Champs
seconds

string (int64 format)

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

integer

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

string

value

string

InstallationState

Représentation JSON
{
  "stage": enum (Stage),
  "message": string,
  "actionUri": string
}
Champs
stage

enum (Stage)

Uniquement en sortie. Étape actuelle du processus d'installation.

message

string

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

string

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

string

value

string

CryptoKeyConfig

Représentation JSON
{
  "keyReference": string
}
Champs
keyReference

string

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 projects/*/locations/*/keyRings/*/cryptoKeys/*.

GitProxyConfig

Représentation JSON
{
  "enabled": boolean,
  "httpProxyBaseUri": string
}
Champs
enabled

boolean

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

string

Uniquement en sortie. URI de base du point de terminaison du proxy HTTP. Il est au format https://{generatedID}-c-h-{shortRegion}.developerconnect.dev. Il n'est renseigné que lorsque le paramètre "enabled" est défini sur "true". Ce point de terminaison est utilisé par d'autres services Google qui s'intègrent à Developer Connect.

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