MCP Tools Reference: developerconnect.googleapis.com

Outil : create-repo-link

Crée un GitRepositoryLink dans un projet et un emplacement donnés.

L'exemple de code suivant montre comment utiliser curl pour appeler l'outil MCP create-repo-link.

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

Schéma d'entrée

Message pour créer un GitRepositoryLink

CreateGitRepositoryLinkRequest

Représentation JSON
{ "parent": string, "gitRepositoryLink": { object (GitRepositoryLink) }, "gitRepositoryLinkId": string, "requestId": string, "validateOnly": boolean }

Champs
parent	string Obligatoire. Valeur pour le parent.
gitRepositoryLink	object (GitRepositoryLink) Obligatoire. La ressource en cours de création
gitRepositoryLinkId	string Obligatoire. ID à utiliser pour le dépôt, qui constituera le composant final du nom de ressource du dépôt. Cet ID doit être unique dans la connexion. Autorise les caractères alphanumériques et les caractères -._~%!$&'()*+,;=@.
requestId	string Facultatif. ID de requête facultatif permettant d'identifier les requêtes. Spécifiez un ID de requête unique pour indiquer au serveur d'ignorer la requête si vous devez la relancer alors qu'elle a déjà été traitée. Le serveur garantira cette logique pendant au moins 60 minutes après la première requête. Imaginons que vous effectuez une requête initiale et que celle-ci expire. Si vous effectuez de nouveau la requête avec le même ID, le serveur peut vérifier si une opération initiale avec cet ID de requête a déjà été reçue et, si c'est le cas, ignorer la deuxième requête. Cela permet d'éviter que les clients ne créent accidentellement des engagements en double. L'ID de requête doit être un UUID valide, sachant qu'un UUID égal à zéro (00000000-0000-0000-0000-000000000000) n'est pas accepté.
validateOnly	boolean Facultatif. Si ce champ est défini, validez la requête, mais ne la publiez pas réellement.

GitRepositoryLink

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

Champs
name	string Identifiant. Nom de ressource du dépôt, au format projects/*/locations/*/connections/*/gitRepositoryLinks/*.
cloneUri	string Obligatoire. URI de clonage Git.
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" }.
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.
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" }.
uid	string Uniquement en sortie. Identifiant unique attribué par le système pour GitRepositoryLink.
webhookId	string Uniquement en sortie. ID externe du webhook créé pour le dépôt.
gitProxyUri	string Uniquement en sortie. URI permettant d'accéder au dépôt associé via le proxy Git. Ce champ n'est renseigné que si le proxy Git est activé pour la connexion.

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

AnnotationsEntry

Représentation JSON
{ "key": string, "value": string }

Champs
key	string
value	string

Schéma de sortie

Cette ressource représente une opération de longue durée résultant d'un appel d'API réseau.

Opération

Représentation JSON
{ "name": string, "metadata": { "@type": string, field1: ..., ... }, "done": boolean, // Union field result can be only one of the following: "error": { object (Status) }, "response": { "@type": string, field1: ..., ... } // End of list of possible types for union field result. }

Champs
name	string Nom attribué par le serveur. Unique au sein du service qui le renvoie initialement. Si vous utilisez le mappage HTTP par défaut, le champ name doit être un nom de ressource se terminant par operations/{unique_id}.
metadata	object Métadonnées spécifiques au service associées à l'opération. Ce champ contient généralement des informations de progression et des métadonnées courantes telles que la date de création. Certains services peuvent ne pas fournir ce genre de métadonnées. Toute méthode renvoyant une opération de longue durée doit indiquer le type de métadonnées, le cas échéant. Objet contenant des champs d'un type arbitraire. Un champ supplémentaire "@type" contient un URI identifiant le type. Exemple : { "id": 1234, "@type": "types.example.com/standard/id" }.
done	boolean Si la valeur est false, cela signifie que l'opération est toujours en cours. Si elle est définie sur true, l'opération est terminée, et un message error ou response est disponible.
Champ d'union result. Résultat de l'opération, qui peut être une erreur (message error) ou une réponse valide (message response). Si done == false, ni error, ni response ne sont définis. Si done == true, une seule des options error ou response peut être définie. Certains services peuvent ne pas fournir le résultat. result ne peut être qu'un des éléments suivants :
error	object (Status) Résultat d'erreur de l'opération en cas d'échec ou d'annulation.
response	object Réponse normale indiquant la réussite de l'opération. Si la méthode d'origine ne renvoie aucune donnée en cas de réussite (telle que Delete), la réponse est google.protobuf.Empty. Si la méthode d'origine est une méthode Get/Create/Update standard, la réponse doit correspondre à la ressource. Pour les autres méthodes, la réponse doit avoir le type XxxResponse, où Xxx est le nom de la méthode d'origine. Par exemple, si le nom de la méthode d'origine est TakeSnapshot(), le type de réponse déduit est TakeSnapshotResponse. Objet contenant des champs d'un type arbitraire. Un champ supplémentaire "@type" contient un URI identifiant le type. Exemple : { "id": 1234, "@type": "types.example.com/standard/id" }.

Tous

Représentation JSON
{ "typeUrl": string, "value": string }

Champs
typeUrl	string Identifie le type du message Protobuf sérialisé avec une référence d'URI composée d'un préfixe se terminant par une barre oblique et du nom de type complet. Exemple : type.googleapis.com/google.protobuf.StringValue Cette chaîne doit contenir au moins un caractère /, et le contenu après le dernier / doit être le nom complet du type sous forme canonique, sans point de début. N'écrivez pas de schéma sur ces références d'URI afin que les clients n'essaient pas de les contacter. Le préfixe est arbitraire et les implémentations Protobuf sont censées simplement supprimer tout ce qui précède et inclut le dernier / pour identifier le type. type.googleapis.com/ est un préfixe par défaut courant requis par certaines anciennes implémentations. Ce préfixe n'indique pas l'origine du type, et les URI qui le contiennent ne sont pas censés répondre aux requêtes. Toutes les chaînes d'URL de type doivent être des références d'URI légales avec la restriction supplémentaire (pour le format texte) que le contenu de la référence ne doit être composé que de caractères alphanumériques, de caractères d'échappement encodés en pourcentage et de caractères de l'ensemble suivant (sans inclure les accents graves externes) : /-.~_!$&()*+,;=. Bien que nous autorisions les encodages en pourcentage, les implémentations ne doivent pas les déséchapper pour éviter toute confusion avec les analyseurs existants. Par exemple, type.googleapis.com%2FFoo doit être rejeté. Dans la conception d'origine de Any, la possibilité de lancer un service de résolution de types à ces URL de type a été envisagée, mais Protobuf n'en a jamais implémenté et considère que contacter ces URL est problématique et constitue un problème de sécurité potentiel. N'essayez pas de contacter les URL de type.
value	string (bytes format) Contient une sérialisation Protobuf du type décrit par type_url. Chaîne encodée en base64.

État

Représentation JSON
{ "code": integer, "message": string, "details": [ { "@type": string, field1: ..., ... } ] }

Champs
code	integer Code d'état, qui doit être une valeur d'énumération de google.rpc.Code.
message	string Message d'erreur destiné au développeur, qui doit être en anglais. Tout message d'erreur destiné aux utilisateurs doit être localisé et envoyé dans le champ google.rpc.Status.details, ou localisé par le client.
details[]	object Liste de messages comportant les détails de l'erreur. Il existe un ensemble commun de types de message utilisable par les API. Objet contenant des champs d'un type arbitraire. Un champ supplémentaire "@type" contient un URI identifiant le type. Exemple : { "id": 1234, "@type": "types.example.com/standard/id" }.

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.

Destructive Hint: ❌ | Idempotent Hint: ❌ | Read Only Hint: ❌ | Open World Hint: ❌