MCP Tools Reference: developerconnect.googleapis.com

Alat: open-repo-pull-request

Buka permintaan pull di repositori SCM jarak jauh.

Contoh kode berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP open-repo-pull-request.

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

Skema Input

Pesan untuk membuka Permintaan Pull SCM.

OpenGitRepositoryLinkPullRequestRequest

Representasi JSON 
{
  "name": string,
  "pullRequest": {
    object (PullRequest)
  }
}
Kolom
name

string

Wajib. Nama resource GitRepositoryLink dalam format projects/*/locations/*/connections/*/gitRepositoryLinks/*.
pullRequest

object (PullRequest)

Wajib. Detail Permintaan Pull yang akan dibuka. Kolom input yang digunakan: title, body, head_ref, base_ref.

PullRequest

Representasi JSON 
{
  "id": string,
  "title": string,
  "body": string,
  "headRef": string,
  "baseRef": string,
  "author": string,
  "createTime": string,
  "updateTime": string,
  "mergeTime": string,
  "closeTime": string,
  "declineTime": string,
  "state": enum (State),
  "mergeability": enum (Mergeability),
  "htmlUrl": string
}
Kolom
id

string

Wajib. ID PR.
title

string

Wajib. Judul PR.
body

string

Opsional. Deskripsi isi PR.
headRef

string

Wajib. SHA commit sumber dari cabang head.
baseRef

string

Wajib. SHA commit target dari cabang dasar.
author

string

Hanya output. Nama pengguna penulis.
createTime

string (Timestamp format)

Hanya output. Waktu pembuatan PR.

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. Kapan PR diperbarui.

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".
mergeTime

string (Timestamp format)

Hanya output. Saat PR digabungkan.

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".
closeTime

string (Timestamp format)

Hanya output. Waktu PR ditutup.

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".
declineTime

string (Timestamp format)

Hanya output. Saat PR ditolak. Hanya ditetapkan untuk penyedia SCM yang mendukung penolakan permintaan pull. Tidak pernah ditetapkan untuk GitHub, GitHub Enterprise, GitLab, atau GitLab Enterprise, yang permintaan pull-nya ditutup tanpa digabungkan adalah CLOSED.

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".
state

enum (State)

Hanya output. Status PR saat ini.
mergeability

enum (Mergeability)

Hanya output. Status penggabungan permintaan pull.
htmlUrl

string

Hanya output. URL HTML permintaan pull di penyedia SCM.

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.

Negara bagian/Provinsi

Status PR.

Enum
STATE_UNSPECIFIED Nilai default.
OPEN PR terbuka.
CLOSED PR ditutup.
MERGED PR digabungkan.
DECLINED PR ditolak. Hanya digunakan oleh penyedia SCM yang mendukung penolakan permintaan pull. Tidak pernah digunakan untuk GitHub, GitHub Enterprise, GitLab, atau GitLab Enterprise, yang permintaan pull-nya ditutup tanpa digabungkan adalah CLOSED.

Kemudahan penggabungan

Status penggabungan permintaan pull.

Enum
MERGEABILITY_UNSPECIFIED Status penggabungan tidak ditentukan.
MERGEABLE Permintaan pull dapat digabungkan dengan rapi tanpa konflik Git.
CONFLICTING Permintaan pull memiliki konflik penggabungan dan tidak dapat digabungkan dengan baik.
COMPUTING Status penggabungan saat ini sedang dihitung secara asinkron oleh penyedia SCM upstream.

Skema Output

Pesan yang merepresentasikan Permintaan Pull SCM.

PullRequest

Representasi JSON 
{
  "id": string,
  "title": string,
  "body": string,
  "headRef": string,
  "baseRef": string,
  "author": string,
  "createTime": string,
  "updateTime": string,
  "mergeTime": string,
  "closeTime": string,
  "declineTime": string,
  "state": enum (State),
  "mergeability": enum (Mergeability),
  "htmlUrl": string
}
Kolom
id

string

Wajib. ID PR.
title

string

Wajib. Judul PR.
body

string

Opsional. Deskripsi isi PR.
headRef

string

Wajib. SHA commit sumber dari cabang head.
baseRef

string

Wajib. SHA commit target dari cabang dasar.
author

string

Hanya output. Nama pengguna penulis.
createTime

string (Timestamp format)

Hanya output. Waktu pembuatan PR.

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. Kapan PR diperbarui.

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".
mergeTime

string (Timestamp format)

Hanya output. Saat PR digabungkan.

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".
closeTime

string (Timestamp format)

Hanya output. Waktu PR ditutup.

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".
declineTime

string (Timestamp format)

Hanya output. Saat PR ditolak. Hanya ditetapkan untuk penyedia SCM yang mendukung penolakan permintaan pull. Tidak pernah ditetapkan untuk GitHub, GitHub Enterprise, GitLab, atau GitLab Enterprise, yang permintaan pull-nya ditutup tanpa digabungkan adalah CLOSED.

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".
state

enum (State)

Hanya output. Status PR saat ini.
mergeability

enum (Mergeability)

Hanya output. Status penggabungan permintaan pull.
htmlUrl

string

Hanya output. URL HTML permintaan pull di penyedia SCM.

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.

Negara bagian/Provinsi

Status PR.

Enum
STATE_UNSPECIFIED Nilai default.
OPEN PR terbuka.
CLOSED PR ditutup.
MERGED PR digabungkan.
DECLINED PR ditolak. Hanya digunakan oleh penyedia SCM yang mendukung penolakan permintaan pull. Tidak pernah digunakan untuk GitHub, GitHub Enterprise, GitLab, atau GitLab Enterprise, yang permintaan pull-nya ditutup tanpa digabungkan adalah CLOSED.

Kemudahan penggabungan

Status penggabungan permintaan pull.

Enum
MERGEABILITY_UNSPECIFIED Status penggabungan tidak ditentukan.
MERGEABLE Permintaan pull dapat digabungkan dengan rapi tanpa konflik Git.
CONFLICTING Permintaan pull memiliki konflik penggabungan dan tidak dapat digabungkan dengan baik.
COMPUTING Status penggabungan saat ini sedang dihitung secara asinkron oleh penyedia SCM upstream.

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