MCP Tools Reference: developerconnect.googleapis.com

כלי: list-connections

הצגת רשימה של החיבורים בפרויקט ובמיקום נתונים.

בדוגמת הקוד הבאה מוסבר איך להשתמש ב-curl כדי להפעיל את כלי ה-MCP‏ list-connections.

בקשת 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
}'

סכימת הקלט

הודעה לבקשת רשימת החיבורים

ListConnectionsRequest

ייצוג ב-JSON 
{
  "parent": string,
  "pageSize": integer,
  "pageToken": string,
  "filter": string,
  "orderBy": string
}
שדות
parent

string

חובה. ערך ההורה של ListConnectionsRequest
pageSize

integer

זה שינוי אופציונלי. גודל הדף המבוקש. יכול להיות שהשרת יחזיר פחות פריטים מהמספר שביקשתם. אם לא צוין, השרת יבחר ברירת מחדל מתאימה.
pageToken

string

זה שינוי אופציונלי. אסימון שמזהה את דף התוצאות שהשרת צריך להחזיר.
filter

string

זה שינוי אופציונלי. המערכת מסננת את התוצאות.
orderBy

string

זה שינוי אופציונלי. רמז לגבי סדר התוצאות.

סכימת הפלט

הודעה לתשובה על בקשות לקישור לפרופיל העסק

ListConnectionsResponse

ייצוג ב-JSON 
{
  "connections": [
    {
      object (Connection)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
שדות
connections[]

object (Connection)

רשימת החיבורים.
nextPageToken

string

אסימון שמזהה את דף התוצאות שהשרת צריך להחזיר.
unreachable[]

string

מיקומים שלא ניתן להגיע אליהם.

חיבור

ייצוג ב-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.
}
שדות
name

string

מזהה. שם המשאב של החיבור, בפורמט projects/{project}/locations/{location}/connections/{connection_id}.
createTime

string (Timestamp format)

פלט בלבד. חותמת זמן היצירה.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. לדוגמה: "2014-10-02T15:01:23Z",‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

פלט בלבד. עדכון חותמת הזמן.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. לדוגמה: "2014-10-02T15:01:23Z",‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
deleteTime

string (Timestamp format)

פלט בלבד. מחיקת חותמת הזמן.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. לדוגמה: "2014-10-02T15:01:23Z",‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
labels

map (key: string, value: string)

זה שינוי אופציונלי. תוויות כצמדי מפתח/ערך

אובייקט שמכיל רשימה של זוגות "key": value. לדוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
installationState

object (InstallationState)

פלט בלבד. סטטוס ההתקנה של החיבור.
disabled

boolean

זה שינוי אופציונלי. אם הערך של disabled מוגדר כ-true, הפונקציונליות מושבתת בחיבור הזה. שיטות API שמבוססות על מאגרים ועיבוד של תגובות לפעולה מאתר אחר (webhook) למאגרים בחיבור הזה יושבתו.
reconciling

boolean

פלט בלבד. צריך להגדיר את הערך כ-true כשהחיבור מוגדר או מתעדכן ברקע.
annotations

map (key: string, value: string)

זה שינוי אופציונלי. מאפשר ללקוחות לאחסן כמויות קטנות של נתונים שרירותיים.

אובייקט שמכיל רשימה של זוגות "key": value. לדוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
etag

string

זה שינוי אופציונלי. סיכום הביקורת הזה מחושב על ידי השרת על סמך הערך של שדות אחרים, ויכול להיות שיישלח בבקשות עדכון ומחיקה כדי לוודא שללקוח יש ערך עדכני לפני שממשיכים.
uid

string

פלט בלבד. מזהה ייחודי שהמערכת מקצה לחיבור.
cryptoKeyConfig

object (CryptoKeyConfig)

זה שינוי אופציונלי. ההגדרות של מפתח ההצפנה. השדה הזה משמש את התכונה "מפתחות הצפנה בניהול הלקוח" (CMEK).
gitProxyConfig

object (GitProxyConfig)

זה שינוי אופציונלי. הגדרת התכונה "שרת proxy של Git". הפעלת שרת ה-proxy של Git מאפשרת ללקוחות לבצע פעולות Git במאגרים שמקושרים בחיבור. מידע נוסף
שדה של איחוד connection_config. הגדרת החיבור בהתאם לסוג הספק. הערך connection_config יכול להיות רק אחד מהבאים:
githubConfig

object (GitHubConfig)

הגדרת החיבורים ל-github.com.
githubEnterpriseConfig

object (GitHubEnterpriseConfig)

הגדרת החיבורים למכונה של GitHub Enterprise.
gitlabConfig

object (GitLabConfig)

הגדרת החיבורים ל-gitlab.com.
gitlabEnterpriseConfig

object (GitLabEnterpriseConfig)

הגדרת החיבורים למכונה של GitLab Enterprise.
bitbucketDataCenterConfig

object (BitbucketDataCenterConfig)

הגדרת החיבורים למכונה של Bitbucket Data Center.
bitbucketCloudConfig

object (BitbucketCloudConfig)

הגדרת החיבורים למכונה של Bitbucket Clouds.
secureSourceManagerInstanceConfig

object (SecureSourceManagerInstanceConfig)

הגדרת החיבורים למכונה של Secure Source Manager.
httpConfig

object (GenericHTTPEndpointConfig)

זה שינוי אופציונלי. הגדרת החיבורים לספק שירות HTTP.

GitHubConfig

ייצוג ב-JSON 
{
  "githubApp": enum (GitHubApp),
  "authorizerCredential": {
    object (OAuthCredential)
  },
  "appInstallationId": string,
  "installationUri": string
}
שדות
githubApp

enum (GitHubApp)

חובה. לא ניתן לשינוי. אפליקציית GitHub שהותקנה למשתמש או לארגון ב-GitHub.
authorizerCredential

object (OAuthCredential)

זה שינוי אופציונלי. פרטי הכניסה ל-OAuth של החשבון שנתן הרשאה לאפליקציית GitHub. מומלץ להשתמש בחשבון רובוט במקום בחשבון משתמש אנושי. אסימון ה-OAuth חייב להיות מקושר לאפליקציית GitHub של ההגדרה הזו.
appInstallationId

string (int64 format)

זה שינוי אופציונלי. מזהה ההתקנה של אפליקציית GitHub.
installationUri

string

פלט בלבד. ה-URI שאליו צריך לנווט כדי לנהל את ההתקנה שמשויכת ל-GitHubConfig הזה.

OAuthCredential

ייצוג ב-JSON 
{
  "oauthTokenSecretVersion": string,
  "username": string
}
שדות
oauthTokenSecretVersion

string

חובה. משאב SecretManager שמכיל את אסימון ה-OAuth שמאשר את החיבור. פורמט: projects/*/secrets/*/versions/* או projects/*/locations/*/secrets/*/versions/* (אם יש תמיכה בסודות אזוריים במיקום הזה).
username

string

פלט בלבד. שם המשתמש שמשויך לטוקן הזה.

GitHubEnterpriseConfig

ייצוג ב-JSON 
{
  "hostUri": string,
  "appId": string,
  "appSlug": string,
  "privateKeySecretVersion": string,
  "webhookSecretSecretVersion": string,
  "appInstallationId": string,
  "installationUri": string,
  "serviceDirectoryConfig": {
    object (ServiceDirectoryConfig)
  },
  "serverVersion": string,
  "sslCaCertificate": string,
  "organization": string
}
שדות
hostUri

string

חובה. ה-URI של מארח GitHub Enterprise שהחיבור הזה מיועד לו.
appId

string (int64 format)

זה שינוי אופציונלי. מזהה אפליקציית GitHub שנוצרה מהמניפסט.
appSlug

string

פלט בלבד. השם של אפליקציית GitHub שמתאים לכתובת URL.
privateKeySecretVersion

string

זה שינוי אופציונלי. משאב SecretManager שמכיל את המפתח הפרטי של אפליקציית GitHub, בפורמט projects/*/secrets/*/versions/* או projects/*/locations/*/secrets/*/versions/* (אם יש תמיכה בסודות אזוריים במיקום הזה).
webhookSecretSecretVersion

string

זה שינוי אופציונלי. משאב SecretManager שמכיל את הסוד של ה-webhook של אפליקציית GitHub, בפורמט projects/*/secrets/*/versions/* או projects/*/locations/*/secrets/*/versions/* (אם יש תמיכה בסודות אזוריים במיקום הזה).
appInstallationId

string (int64 format)

זה שינוי אופציונלי. מזהה ההתקנה של אפליקציית GitHub.
installationUri

string

פלט בלבד. ה-URI שאליו צריך לנווט כדי לנהל את ההתקנה שמשויכת ל-GitHubEnterpriseConfig הזה.
serviceDirectoryConfig

object (ServiceDirectoryConfig)

זה שינוי אופציונלי. הגדרה לשימוש ב-Service Directory כדי להתחבר באופן פרטי לשרת GitHub Enterprise. צריך להגדיר את זה רק אם שרת GitHub Enterprise מתארח באופן מקומי ואי אפשר להגיע אליו דרך האינטרנט הציבורי. אם השדה הזה נשאר ריק, הקריאות לשרת GitHub Enterprise יתבצעו דרך האינטרנט הציבורי.
serverVersion

string

פלט בלבד. גרסת GitHub Enterprise שמותקנת ב-host_uri.
sslCaCertificate

string

זה שינוי אופציונלי. אישור SSL לשימוש בבקשות ל-GitHub Enterprise.
organization

string

זה שינוי אופציונלי. לא ניתן לשינוי. הארגון ב-GitHub Enterprise שבו נוצרה אפליקציית GitHub.

ServiceDirectoryConfig

ייצוג ב-JSON 
{
  "service": string
}
שדות
service

string

חובה. השם של השירות ב-Service Directory. פורמט: projects/{project}/locations/{location}/namespaces/{namespace}/services/{service}.

GitLabConfig

ייצוג ב-JSON 
{
  "webhookSecretSecretVersion": string,
  "readAuthorizerCredential": {
    object (UserCredential)
  },
  "authorizerCredential": {
    object (UserCredential)
  }
}
שדות
webhookSecretSecretVersion

string

חובה. לא ניתן לשינוי. משאב SecretManager שמכיל את הסוד של ה-webhook של פרויקט GitLab, בפורמט projects/*/secrets/*/versions/* או projects/*/locations/*/secrets/*/versions/* (אם יש תמיכה בסודות אזוריים במיקום הזה). הוא משמש לאימות של רשתות ה-webhook.
readAuthorizerCredential

object (UserCredential)

חובה. טוקן גישה אישי של GitLab עם גישה מינימלית להיקף read_api ותפקיד מינימלי של reporter. הפרויקטים ב-GitLab שגלויים לטוקן הגישה האישי הזה יקבעו לאילו פרויקטים יש ל-Developer Connect גישה.
authorizerCredential

object (UserCredential)

חובה. טוקן גישה אישי של GitLab עם גישה מינימלית להיקף api ותפקיד מינימלי של maintainer. הפרויקטים ב-GitLab שגלויים לטוקן הגישה האישי הזה יקבעו לאילו פרויקטים יש ל-Developer Connect גישה.

UserCredential

ייצוג ב-JSON 
{
  "userTokenSecretVersion": string,
  "username": string
}
שדות
userTokenSecretVersion

string

חובה. משאב SecretManager שמכיל את אסימון המשתמש שמאשר את החיבור של Developer Connect. פורמט: projects/*/secrets/*/versions/* או projects/*/locations/*/secrets/*/versions/* (אם יש תמיכה בסודות אזוריים במיקום הזה).
username

string

פלט בלבד. שם המשתמש שמשויך לטוקן הזה.

GitLabEnterpriseConfig

ייצוג ב-JSON 
{
  "hostUri": string,
  "webhookSecretSecretVersion": string,
  "readAuthorizerCredential": {
    object (UserCredential)
  },
  "authorizerCredential": {
    object (UserCredential)
  },
  "serviceDirectoryConfig": {
    object (ServiceDirectoryConfig)
  },
  "sslCaCertificate": string,
  "serverVersion": string
}
שדות
hostUri

string

חובה. ה-URI של מארח GitLab Enterprise שהחיבור הזה מיועד לו.
webhookSecretSecretVersion

string

חובה. לא ניתן לשינוי. משאב SecretManager שמכיל את הסוד של ה-webhook של פרויקט GitLab, בפורמט projects/*/secrets/*/versions/* או projects/*/locations/*/secrets/*/versions/* (אם יש תמיכה בסודות אזוריים במיקום הזה). הוא משמש לאימות של רשתות ה-webhook.
readAuthorizerCredential

object (UserCredential)

חובה. טוקן גישה אישי של GitLab עם גישה מינימלית להיקף read_api ותפקיד מינימלי של reporter. הפרויקטים ב-GitLab שגלויים לטוקן הגישה האישי הזה יקבעו לאילו פרויקטים יש ל-Developer Connect גישה.
authorizerCredential

object (UserCredential)

חובה. טוקן גישה אישי של GitLab עם גישה מינימלית להיקף api ותפקיד מינימלי של maintainer. הפרויקטים ב-GitLab שגלויים לטוקן הגישה האישי הזה יקבעו לאילו פרויקטים יש ל-Developer Connect גישה.
serviceDirectoryConfig

object (ServiceDirectoryConfig)

זה שינוי אופציונלי. הגדרת השימוש ב-Service Directory כדי להתחבר באופן פרטי למכונה של GitLab Enterprise. צריך להגדיר את זה רק אם שרת GitLab Enterprise מתארח באופן מקומי ואי אפשר להגיע אליו דרך האינטרנט הציבורי. אם השדה הזה ריק, הקריאות לשרת GitLab Enterprise יתבצעו דרך האינטרנט הציבורי.
sslCaCertificate

string

זה שינוי אופציונלי. אישור של רשות אישורי SSL לשימוש בבקשות למכונה של GitLab Enterprise.
serverVersion

string

פלט בלבד. גרסת השרת של GitLab Enterprise שפועלת ב-host_uri.

BitbucketDataCenterConfig

ייצוג ב-JSON 
{
  "hostUri": string,
  "webhookSecretSecretVersion": string,
  "readAuthorizerCredential": {
    object (UserCredential)
  },
  "authorizerCredential": {
    object (UserCredential)
  },
  "serviceDirectoryConfig": {
    object (ServiceDirectoryConfig)
  },
  "sslCaCertificate": string,
  "serverVersion": string
}
שדות
hostUri

string

חובה. ה-URI של מארח מרכז הנתונים של Bitbucket שהחיבור הזה מיועד לו.
webhookSecretSecretVersion

string

חובה. לא ניתן לשינוי. משאב SecretManager שמכיל את הסוד של ה-webhook שמשמש לאימות אירועי webhook, בפורמט projects/*/secrets/*/versions/* או projects/*/locations/*/secrets/*/versions/* (אם יש תמיכה בסודות אזוריים במיקום הזה). הוא משמש לאימות של רשתות ה-webhook.
readAuthorizerCredential

object (UserCredential)

חובה. טוקן גישה מסוג HTTP עם גישה מינימלית ל-Repository read. מומלץ להשתמש בחשבון מערכת כדי ליצור את פרטי הכניסה.
authorizerCredential

object (UserCredential)

חובה. אסימון גישה מסוג HTTP עם גישה מינימלית להיקף Repository admin. ההרשאה הזו נדרשת כדי ליצור תגובות לפעולות לפיתוח API. מומלץ להשתמש בחשבון מערכת כדי ליצור את פרטי הכניסה האלה.
serviceDirectoryConfig

object (ServiceDirectoryConfig)

זה שינוי אופציונלי. הגדרת השימוש ב-Service Directory כדי להתחבר באופן פרטי למכונה של Bitbucket Data Center. צריך להגדיר את זה רק אם מרכז הנתונים של Bitbucket מתארח באופן מקומי ואי אפשר להגיע אליו דרך האינטרנט הציבורי. אם השדה הזה יישאר ריק, הקריאות ל-Bitbucket Data Center יתבצעו דרך האינטרנט הציבורי.
sslCaCertificate

string

זה שינוי אופציונלי. רשות אישורי ה-SSL שצריך לתת בה אמון כששולחים בקשות ל-Bitbucket מרכז נתונים.
serverVersion

string

פלט בלבד. גרסת השרת של Bitbucket Data Center שפועלת ב-host_uri.

BitbucketCloudConfig

ייצוג ב-JSON 
{
  "workspace": string,
  "webhookSecretSecretVersion": string,
  "readAuthorizerCredential": {
    object (UserCredential)
  },
  "authorizerCredential": {
    object (UserCredential)
  }
}
שדות
workspace

string

חובה. מזהה סביבת העבודה ב-Bitbucket Cloud שרוצים לקשר ל-Google Cloud Platform.
webhookSecretSecretVersion

string

חובה. לא ניתן לשינוי. משאב SecretManager שמכיל את הסוד של ה-webhook שמשמש לאימות אירועי webhook, בפורמט projects/*/secrets/*/versions/* או projects/*/locations/*/secrets/*/versions/* (אם יש תמיכה בסודות אזוריים במיקום הזה). הוא משמש לאימות וליצירה של רשתות webhook.
readAuthorizerCredential

object (UserCredential)

חובה. טוקן גישה עם הרשאת הגישה המינימלית ל-repository. זה יכול להיות טוקן גישה לסביבת עבודה, לפרויקט או למאגר. מומלץ להשתמש בחשבון מערכת כדי ליצור את פרטי הכניסה.
authorizerCredential

object (UserCredential)

חובה. טוקן גישה עם היקף הגישה המינימלי של repository,‏ pullrequest ו-webhook. זה יכול להיות טוקן גישה לסביבת עבודה, לפרויקט או למאגר. ההרשאה הזו נדרשת כדי ליצור תגובות לפעולות לפיתוח API. מומלץ להשתמש בחשבון מערכת כדי ליצור את פרטי הכניסה האלה.

SecureSourceManagerInstanceConfig

ייצוג ב-JSON 
{
  "instance": string
}
שדות
instance

string

חובה. לא ניתן לשינוי. משאב של מכונה ב-Secure Source Manager, בפורמט projects/*/locations/*/instances/*

GenericHTTPEndpointConfig

ייצוג ב-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.
}
שדות
hostUri

string

חובה. לא ניתן לשינוי. נקודת הקצה (endpoint) ב-HTTPS של ספק השירות.
serviceDirectoryConfig

object (ServiceDirectoryConfig)

זה שינוי אופציונלי. הגדרה לשימוש ב-Service Directory כדי להתחבר באופן פרטי לספק שירות HTTP. צריך להגדיר את זה רק אם ספק שירות ה-HTTP מתארח באופן מקומי ואי אפשר להגיע אליו דרך האינטרנט הציבורי. אם השדה הזה נשאר ריק, הקריאות לספק שירות ה-HTTP יתבצעו דרך האינטרנט הציבורי.
sslCaCertificate

string

זה שינוי אופציונלי. אישור ה-SSL שבו צריך להשתמש לבקשות לספק שירות ה-HTTP.
שדה של איחוד authentication. מנגנון האימות שבו צריך להשתמש לבקשות לספק שירות ה-HTTP. הערך authentication יכול להיות רק אחד מהבאים:
basicAuthentication

object (BasicAuthentication)

זה שינוי אופציונלי. אימות בסיסי באמצעות שם משתמש וסיסמה.
bearerTokenAuthentication

object (BearerTokenAuthentication)

זה שינוי אופציונלי. אימות טוקן למוכ"ז באמצעות טוקן.

BasicAuthentication

ייצוג ב-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.
}
שדות
username

string

חובה. שם המשתמש לאימות.
שדה של איחוד password. הסיסמה לאימות. הערך password יכול להיות רק אחד מהבאים:
passwordSecretVersion

string

גרסת הסוד של SecretManager של הסיסמה לאימות.

BearerTokenAuthentication

ייצוג ב-JSON 
{

  // Union field token can be only one of the following:
  "tokenSecretVersion": string
  // End of list of possible types for union field token.
}
שדות
שדה של איחוד token. האסימון לאימות. הערך token יכול להיות רק אחד מהבאים:
tokenSecretVersion

string

זה שינוי אופציונלי. גרסת הסוד של SecretManager של הטוקן שמשמש לאימות.

חותמת הזמן

ייצוג ב-JSON 
{
  "seconds": string,
  "nanos": integer
}
שדות
seconds

string (int64 format)

מייצג שניות של זמן UTC מאז ראשית זמן יוניקס (Unix epoch) ‏1970-01-01T00:00:00Z. הערך חייב להיות בין ‎-62135596800 ל-253402300799, כולל (טווח שמתאים ל-‎0001-01-01T00:00:00Z עד ‎9999-12-31T23:59:59Z).
nanos

integer

שברים לא שליליים של שנייה ברזולוציה של ננו-שנייה. השדה הזה הוא החלק של הננו-שניות במשך הזמן, ולא חלופה לשניות. ערכי שניות שליליים עם שברים עדיין צריכים לכלול ערכי ננו-שניות לא שליליים שנספרים קדימה בזמן. הערך חייב להיות בין 0 ל-999,999,999, כולל.

LabelsEntry

ייצוג ב-JSON 
{
  "key": string,
  "value": string
}
שדות
key

string
value

string

InstallationState

ייצוג ב-JSON 
{
  "stage": enum (Stage),
  "message": string,
  "actionUri": string
}
שדות
stage

enum (Stage)

פלט בלבד. השלב הנוכחי בתהליך ההתקנה.
message

string

פלט בלבד. הודעה שמסבירה מה המשתמש צריך לעשות כדי להמשיך בהתקנה. מחרוזת ריקה אם ההתקנה כבר הושלמה.
actionUri

string

פלט בלבד. קישור לפעולה הבאה. מחרוזת ריקה אם ההתקנה כבר הושלמה.

AnnotationsEntry

ייצוג ב-JSON 
{
  "key": string,
  "value": string
}
שדות
key

string
value

string

CryptoKeyConfig

ייצוג ב-JSON 
{
  "keyReference": string
}
שדות
keyReference

string

חובה. שם המפתח שמשמש להצפנה או לפענוח של נתוני הלקוחות. למפתח ב-Cloud KMS, המפתח צריך להיות בפורמט projects/*/locations/*/keyRings/*/cryptoKeys/*.

GitProxyConfig

ייצוג ב-JSON 
{
  "enabled": boolean,
  "httpProxyBaseUri": string
}
שדות
enabled

boolean

זה שינוי אופציונלי. אם מגדירים את הערך כ-true, אפשר להשתמש בשרת ה-proxy של Git כדי לבצע פעולות Git במאגרים שמקושרים בחיבור.
httpProxyBaseUri

string

פלט בלבד. ה-URI הבסיסי של נקודת הקצה (endpoint) של שרת ה-Proxy ל-HTTP. הפורמט הוא https://{generatedID}-c-h-{shortRegion}.developerconnect.dev. השדה מאוכלס רק אם הערך של enabled הוא true. שירותים אחרים של Google שמשולבים עם Developer Connect משתמשים בנקודת הקצה הזו.

GitHubApp

מייצג את האפליקציות השונות של GitHub שאפשר להתקין למשתמש או לארגון ב-GitHub ולהשתמש בהן עם Developer Connect.

טיפוסים בני מנייה (enum)
GIT_HUB_APP_UNSPECIFIED לא צוינה אפליקציית GitHub.
DEVELOPER_CONNECT אפליקציית Developer Connect GitHub.
FIREBASE אפליקציית Firebase GitHub.
GEMINI_CODE_ASSIST אפליקציית Gemini Code Assist.
DATAFORM אפליקציית Dataform GitHub.

שלב

שלב בתהליך ההתקנה.

טיפוסים בני מנייה (enum)
STAGE_UNSPECIFIED לא צוין שלב.
PENDING_CREATE_APP רק ל-GitHub Enterprise. נשלחה בקשה ליצירת אפליקציה. המשתמש צריך לאשר את היצירה במארח הארגוני של GitHub.
PENDING_USER_OAUTH המשתמש צריך לאשר את האפליקציה של GitHub (או Enterprise) באמצעות OAuth.
PENDING_INSTALL_APP המשתמש צריך ללחוץ על הקישור כדי להתקין את אפליקציית GitHub (או Enterprise).
COMPLETE תהליך ההתקנה הושלם.

הערות לגבי הכלים

הערות הכלים נשלחות ללקוחות MCP כדי לתאר את הסיכון הבסיסי של כלי מסוים. רוב הלקוחות מתייחסים לרמזים האלה כלא מהימנים, אבל אפשר להשתמש בהם כדי להחליט מתי לשלוח למשתמש בקשה לאישור.

בנוסף למחרוזת הכותרת, הרמזים הבוליאניים הבאים מוגדרים כך:

  • ‫readOnlyHint: אם הערך הוא True, הכלי לא משנה את הסביבה שלו. ברירת המחדל: false.
  • ‫destructiveHint: אם הערך הוא True, הכלי יכול לבצע פעולות הרסניות. אם הערך הוא False, הכלי יכול לבצע רק פעולות הוספה. ברירת המחדל: true.
  • ‫idempotentHint: אם הערך הוא True, קריאה חוזרת לכלי עם אותם ארגומנטים לא תשפיע על הסביבה שלו. ברירת המחדל: false.
  • ‫openWorldHint: אם הערך הוא True, הכלי יכול לקיים אינטראקציה עם "עולם פתוח" של ישויות חיצוניות. אם הערך הוא false, הכלי יכול לקיים אינטראקציה רק עם ישויות פנימיות. לדוגמה, כלי חיפוש באינטרנט הוא כלי בעולם פתוח, אבל כלי זיכרון הוא לא כלי בעולם פתוח.

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