MCP Tools Reference: developerconnect.googleapis.com

Alat: create-repo-link

Membuat GitRepositoryLink baru di project dan lokasi tertentu.

Contoh kode berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP create-repo-link.

Permintaan 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 }'

Skema Input

Pesan untuk membuat GitRepositoryLink

CreateGitRepositoryLinkRequest

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

Kolom
parent	string Wajib. Nilai untuk induk.
gitRepositoryLink	object (GitRepositoryLink) Wajib. Resource yang sedang dibuat
gitRepositoryLinkId	string Wajib. ID yang akan digunakan untuk repositori, yang akan menjadi komponen akhir dari nama resource repositori. ID ini harus unik dalam koneksi. Mengizinkan karakter alfanumerik dan salah satu dari -._~%!$&'()*+,;=@.
requestId	string Opsional. ID permintaan opsional untuk mengidentifikasi permintaan. Tentukan ID permintaan unik sehingga jika Anda harus mencoba lagi permintaan, server akan tahu untuk mengabaikan permintaan jika sudah selesai. Server akan menjamin hal tersebut setidaknya selama 60 menit sejak permintaan pertama. Misalnya, pertimbangkan situasi saat Anda membuat permintaan awal dan waktu permintaan habis. Jika Anda membuat permintaan lagi dengan ID permintaan yang sama, server dapat memeriksa apakah operasi asli dengan ID permintaan yang sama telah diterima, dan jika iya, akan mengabaikan permintaan kedua. Tindakan ini mencegah klien membuat komitmen duplikat secara tidak sengaja. ID permintaan harus berupa UUID yang valid, kecuali UUID nol tidak didukung (00000000-0000-0000-0000-000000000000).
validateOnly	boolean Opsional. Jika ditetapkan, validasi permintaan, tetapi jangan benar-benar mempostingnya.

GitRepositoryLink

Representasi 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 }

Kolom
name	string ID. Nama resource repositori, dalam format projects/*/locations/*/connections/*/gitRepositoryLinks/*.
cloneUri	string Wajib. URI Clone Git.
createTime	string (Timestamp format) Hanya output. Stempel waktu pembuatan. Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
updateTime	string (Timestamp format) Hanya output. Memperbarui stempel waktu. Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
deleteTime	string (Timestamp format) Hanya output. Hapus stempel waktu. Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
labels	map (key: string, value: string) Opsional. Label sebagai key-value pair Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
etag	string Opsional. Checksum ini dihitung oleh server berdasarkan nilai kolom lain, dan dapat dikirim pada permintaan update dan penghapusan untuk memastikan klien memiliki nilai terbaru sebelum melanjutkan.
reconciling	boolean Hanya output. Tetapkan ke true saat koneksi sedang disiapkan atau diperbarui di latar belakang.
annotations	map (key: string, value: string) Opsional. Memungkinkan klien menyimpan data arbitrer dalam jumlah kecil. Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
uid	string Hanya output. ID unik yang ditetapkan sistem untuk GitRepositoryLink.
webhookId	string Hanya output. ID eksternal webhook yang dibuat untuk repositori.
gitProxyUri	string Hanya output. URI untuk mengakses repositori tertaut melalui proxy Git. Kolom ini hanya diisi jika proxy Git diaktifkan untuk koneksi.

Stempel waktu

Representasi JSON
{ "seconds": string, "nanos": integer }

Kolom
seconds	string (int64 format) Mewakili detik waktu UTC sejak epoch Unix 1970-01-01T00:00:00Z. Harus antara -62135596800 dan 253402300799 inklusif (yang sesuai dengan 0001-01-01T00:00:00Z hingga 9999-12-31T23:59:59Z).
nanos	integer Pecahan detik non-negatif pada resolusi nanodetik. Kolom ini adalah bagian nanodetik dari durasi, bukan alternatif untuk detik. Nilai detik negatif dengan pecahan harus tetap memiliki nilai nano non-negatif yang dihitung maju dalam waktu. Harus antara 0 dan 999.999.999 inklusif.

LabelsEntry

Representasi JSON
{ "key": string, "value": string }

Kolom
key	string
value	string

AnnotationsEntry

Representasi JSON
{ "key": string, "value": string }

Kolom
key	string
value	string

Skema Output

Resource ini mewakili operasi yang berjalan lama yang merupakan hasil dari panggilan API jaringan.

Operasi

Representasi 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. }

Kolom
name	string Nama server yang ditetapkan, yang hanya bersifat unik dalam layanan yang sama yang awalnya menampilkannya. Jika Anda menggunakan pemetaan HTTP default, name harus berupa nama resource yang diakhiri dengan operations/{unique_id}.
metadata	object Metadata khusus layanan yang terkait dengan operasi. Biasanya berisi informasi kemajuan dan metadata umum, seperti membuat waktu. Beberapa layanan mungkin tidak menyediakan metadata semacam itu. Setiap metode yang menampilkan operasi yang berjalan lama harus mendokumentasikan tipe metadata, jika ada. Objek yang berisi kolom tipe arbitrer. Kolom tambahan "@type" berisi URI yang mengidentifikasi jenis. Contoh: { "id": 1234, "@type": "types.example.com/standard/id" }.
done	boolean Jika nilainya adalah false, artinya operasi masih berlangsung. Jika true, artinya operasi sudah selesai, dan error atau response tersedia.
Kolom union result. Hasil operasi, yang dapat berupa error atau response yang valid. Jika done == false, error atau response tidak ditetapkan. Jika done == true, hanya salah satu dari error atau response yang dapat ditetapkan. Beberapa layanan mungkin tidak memberikan hasil. result hanya dapat berupa salah satu dari berikut:
error	object (Status) Hasil error operasi jika terjadi kegagalan atau pembatalan.
response	object Respons normal dan berhasil dari operasi. Jika metode asli tidak menampilkan data saat berhasil, seperti Delete, responsnya adalah google.protobuf.Empty. Jika metode asli adalah Get/Create/Update standar, responsnya harus berupa resource. Untuk metode lain, respons harus memiliki jenis XxxResponse, dengan Xxx yang merupakan nama metode asli. Misalnya, jika nama metode asli adalah TakeSnapshot(), jenis respons yang disimpulkan adalah TakeSnapshotResponse. Objek yang berisi kolom tipe arbitrer. Kolom tambahan "@type" berisi URI yang mengidentifikasi jenis. Contoh: { "id": 1234, "@type": "types.example.com/standard/id" }.

Semua

Representasi JSON
{ "typeUrl": string, "value": string }

Kolom
typeUrl	string Mengidentifikasi jenis pesan Protobuf yang diserialisasi dengan referensi URI yang terdiri dari awalan yang diakhiri dengan garis miring dan nama jenis yang sepenuhnya memenuhi syarat. Contoh: type.googleapis.com/google.protobuf.StringValue String ini harus berisi setidaknya satu karakter /, dan konten setelah / terakhir harus berupa nama jenis yang sepenuhnya memenuhi syarat dalam bentuk kanonis, tanpa titik di awal. Jangan menulis skema pada referensi URI ini agar klien tidak mencoba menghubunginya. Prefiks bersifat arbitrer dan implementasi Protobuf diharapkan hanya menghapus semua hal hingga dan termasuk / terakhir untuk mengidentifikasi jenisnya. type.googleapis.com/ adalah awalan default umum yang diperlukan oleh beberapa implementasi lama. Awalan ini tidak menunjukkan asal jenis, dan URI yang memuatnya tidak diharapkan untuk merespons permintaan apa pun. Semua string URL jenis harus berupa referensi URI yang sah dengan batasan tambahan (untuk format teks) bahwa konten referensi hanya boleh terdiri dari karakter alfanumerik, escape yang dienkode persen, dan karakter dalam kumpulan berikut (tidak termasuk tanda petik terbalik luar): /-.~_!$&()*+,;=. Meskipun kami mengizinkan encoding persen, implementasi tidak boleh meng-unescape-nya untuk mencegah kebingungan dengan parser yang ada. Misalnya, type.googleapis.com%2FFoo harus ditolak. Dalam desain asli Any, kemungkinan meluncurkan layanan resolusi jenis di URL jenis ini telah dipertimbangkan, tetapi Protobuf tidak pernah menerapkannya dan menganggap menghubungi URL ini sebagai masalah dan potensi masalah keamanan. Jangan mencoba menghubungi URL jenis.
value	string (bytes format) Menyimpan serialisasi Protobuf dari jenis yang dijelaskan oleh type_url. String berenkode base64.

Status

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

Kolom
code	integer Kode status, harus berupa nilai enum dari google.rpc.Code.
message	string Pesan error yang ditampilkan ke developer dan seharusnya dalam bahasa Inggris. Setiap pesan error yang ditampilkan kepada pengguna harus dilokalkan dan dikirim di kolom google.rpc.Status.details, atau dilokalkan oleh klien.
details[]	object Daftar pesan yang membawa detail error. Ada seperangkat jenis pesan umum untuk digunakan API. Objek yang berisi kolom tipe arbitrer. Kolom tambahan "@type" berisi URI yang mengidentifikasi jenis. Contoh: { "id": 1234, "@type": "types.example.com/standard/id" }.

Anotasi Alat

Anotasi alat dikirim ke klien MCP untuk menjelaskan risiko dasar alat tertentu. Sebagian besar klien memperlakukan petunjuk ini sebagai tidak tepercaya, tetapi petunjuk tersebut dapat digunakan untuk memutuskan kapan perintah konfirmasi dapat dikirim kepada pengguna.

Bersama dengan string judul, petunjuk boolean berikut ditentukan sebagai berikut:

• readOnlyHint: Jika benar, alat tidak akan mengubah lingkungannya. Default: false.
• destructiveHint: Jika benar, alat dapat melakukan tindakan destruktif. Jika salah (false), alat hanya dapat melakukan tindakan aditif. Default: true.
• idempotentHint: Jika benar, memanggil alat berulang kali dengan argumen yang sama tidak akan memberikan efek tambahan pada lingkungannya. Default: false.
• openWorldHint: Jika benar, alat dapat berinteraksi dengan 'open world' entitas eksternal. Jika salah, alat hanya dapat berinteraksi dengan entity internal. Misalnya, alat penelusuran web akan bersifat open world, sedangkan alat memori tidak akan bersifat open world.

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