Tool: list-connections
Listet Verbindungen in einem bestimmten Projekt und an einem bestimmten Standort auf.
Das folgende Codebeispiel zeigt, wie Sie mit curl das MCP-Tool list-connections aufrufen.
| Curl-Anfrage |
|---|
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 }' |
Eingabeschema
Nachricht zum Anfordern einer Liste von Verbindungen
ListConnectionsRequest
| JSON-Darstellung |
|---|
{ "parent": string, "pageSize": integer, "pageToken": string, "filter": string, "orderBy": string } |
| Felder | |
|---|---|
parent |
Pflichtangabe. Übergeordneter Wert für ListConnectionsRequest |
pageSize |
Optional. Angeforderte Seitengröße. Der Server gibt möglicherweise weniger Elemente als angefordert zurück. Wenn kein Wert angegeben wurde, wählt der Server einen geeigneten Standardwert aus. |
pageToken |
Optional. Ein Token, das eine Ergebnisseite identifiziert, die der Server liefern soll |
filter |
Optional. Filtert die Ergebnisse. |
orderBy |
Optional. Hinweis zur Sortierung der Ergebnisse. |
Ausgabeschema
Nachricht für die Antwort auf die Auflistung von Verbindungen
ListConnectionsResponse
| JSON-Darstellung |
|---|
{
"connections": [
{
object ( |
| Felder | |
|---|---|
connections[] |
Die Liste der Verbindungen |
nextPageToken |
Ein Token, das eine Ergebnisseite identifiziert, die der Server liefern soll. |
unreachable[] |
Standorte, die nicht erreicht werden konnten. |
Verbindung
| JSON-Darstellung |
|---|
{ "name": string, "createTime": string, "updateTime": string, "deleteTime": string, "labels": { string: string, ... }, "installationState": { object ( |
| Felder | |
|---|---|
name |
ID. Der Ressourcenname der Verbindung im Format |
createTime |
Nur Ausgabe. Zeitstempel der Erstellung. Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: |
updateTime |
Nur Ausgabe. Zeitstempel der Aktualisierung. Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: |
deleteTime |
Nur Ausgabe. Zeitstempel löschen. Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: |
labels |
Optional. Labels als Schlüssel/Wert-Paare. Ein Objekt, das eine Liste von |
installationState |
Nur Ausgabe. Installationsstatus der Verbindung. |
disabled |
Optional. Wenn „disabled“ auf „true“ gesetzt ist, ist die Funktion für diese Verbindung deaktiviert. Repository-basierte API-Methoden und die Webhook-Verarbeitung für Repositories in dieser Verbindung werden deaktiviert. |
reconciling |
Nur Ausgabe. Wird auf „true“ gesetzt, wenn die Verbindung im Hintergrund eingerichtet oder aktualisiert wird. |
annotations |
Optional. Ermöglicht Clients, kleine Mengen beliebiger Daten zu speichern. Ein Objekt, das eine Liste von |
etag |
Optional. Diese Prüfsumme wird vom Server anhand des Werts anderer Felder berechnet und kann bei Aktualisierungs- und Löschanfragen gesendet werden, um sicherzustellen, dass der Client vor dem Fortfahren einen aktuellen Wert hat. |
uid |
Nur Ausgabe. Eine vom System zugewiesene eindeutige Kennung für die Verbindung. |
cryptoKeyConfig |
Optional. Die Konfiguration des kryptografischen Schlüssels. Dieses Feld wird von der Funktion „Kundenverwaltete Verschlüsselungsschlüssel“ (CMEK) verwendet. |
gitProxyConfig |
Optional. Konfiguration für die Git-Proxy-Funktion. Wenn Sie den Git-Proxy aktivieren, können Clients Git-Vorgänge für die in der Verbindung verknüpften Repositories ausführen. Weitere Informationen |
Union-Feld connection_config. Konfiguration für die Verbindung, je nach Typ des Anbieters. Für connection_config ist nur einer der folgenden Werte zulässig: |
|
githubConfig |
Konfiguration für Verbindungen zu github.com. |
githubEnterpriseConfig |
Konfiguration für Verbindungen zu einer GitHub Enterprise-Instanz. |
gitlabConfig |
Konfiguration für Verbindungen zu gitlab.com. |
gitlabEnterpriseConfig |
Konfiguration für Verbindungen zu einer GitLab Enterprise-Instanz. |
bitbucketDataCenterConfig |
Konfiguration für Verbindungen zu einer Instanz von Bitbucket Data Center. |
bitbucketCloudConfig |
Konfiguration für Verbindungen zu einer Instanz von Bitbucket Cloud. |
secureSourceManagerInstanceConfig |
Konfiguration für Verbindungen zu einer Instanz von Secure Source Manager. |
httpConfig |
Optional. Konfiguration für Verbindungen zu einem HTTP-Dienstanbieter. |
GitHubConfig
| JSON-Darstellung |
|---|
{ "githubApp": enum ( |
| Felder | |
|---|---|
githubApp |
Erforderlich. Nicht veränderbar. Die GitHub-Anwendung, die für den GitHub-Nutzer oder die GitHub-Organisation installiert wurde. |
authorizerCredential |
Optional. OAuth-Anmeldedaten des Kontos, das die GitHub-Anwendung autorisiert hat. Es wird empfohlen, ein Roboterkonto anstelle eines menschlichen Nutzerkontos zu verwenden. Das OAuth-Token muss mit der GitHub-Anwendung dieser Konfiguration verknüpft sein. |
appInstallationId |
Optional. Installations-ID der GitHub-Anwendung. |
installationUri |
Nur Ausgabe. Der URI, zu dem Sie navigieren müssen, um die mit dieser GitHubConfig verknüpfte Installation zu verwalten. |
OAuthCredential
| JSON-Darstellung |
|---|
{ "oauthTokenSecretVersion": string, "username": string } |
| Felder | |
|---|---|
oauthTokenSecretVersion |
Pflichtangabe. Eine SecretManager-Ressource, die das OAuth-Token enthält, das die Verbindung autorisiert. Format: |
username |
Nur Ausgabe. Der mit diesem Token verknüpfte Nutzername. |
GitHubEnterpriseConfig
| JSON-Darstellung |
|---|
{
"hostUri": string,
"appId": string,
"appSlug": string,
"privateKeySecretVersion": string,
"webhookSecretSecretVersion": string,
"appInstallationId": string,
"installationUri": string,
"serviceDirectoryConfig": {
object ( |
| Felder | |
|---|---|
hostUri |
Pflichtangabe. Der URI des GitHub Enterprise-Hosts, für den diese Verbindung bestimmt ist. |
appId |
Optional. ID der GitHub-Anwendung, die aus dem Manifest erstellt wurde. |
appSlug |
Nur Ausgabe. Der URL-freundliche Name der GitHub-Anwendung. |
privateKeySecretVersion |
Optional. SecretManager-Ressource, die den privaten Schlüssel der GitHub-Anwendung enthält, formatiert als |
webhookSecretSecretVersion |
Optional. SecretManager-Ressource, die das Webhook-Secret der GitHub-Anwendung enthält, formatiert als |
appInstallationId |
Optional. ID der Installation der GitHub-Anwendung. |
installationUri |
Nur Ausgabe. Der URI, zu dem Sie navigieren müssen, um die mit dieser GitHubEnterpriseConfig verknüpfte Installation zu verwalten. |
serviceDirectoryConfig |
Optional. Konfiguration für die Verwendung von Service Directory, um eine private Verbindung zu einem GitHub Enterprise-Server herzustellen. Dies sollte nur festgelegt werden, wenn der GitHub Enterprise-Server lokal gehostet wird und nicht über das öffentliche Internet erreichbar ist. Wenn dieses Feld leer bleibt, werden Aufrufe an den GitHub Enterprise-Server über das öffentliche Internet ausgeführt. |
serverVersion |
Nur Ausgabe. GitHub Enterprise-Version, die unter der host_uri installiert ist. |
sslCaCertificate |
Optional. SSL-Zertifikat, das für Anfragen an GitHub Enterprise verwendet werden soll. |
organization |
Optional. Nicht veränderbar. GitHub Enterprise-Organisation, in der die GitHub-Anwendung erstellt wird. |
ServiceDirectoryConfig
| JSON-Darstellung |
|---|
{ "service": string } |
| Felder | |
|---|---|
service |
Pflichtangabe. Der Name des Service Directory-Dienstes. Format: projects/{project}/locations/{location}/namespaces/{namespace}/services/{service}. |
GitLabConfig
| JSON-Darstellung |
|---|
{ "webhookSecretSecretVersion": string, "readAuthorizerCredential": { object ( |
| Felder | |
|---|---|
webhookSecretSecretVersion |
Erforderlich. Nicht veränderbar. SecretManager-Ressource, die das Webhook-Secret eines GitLab-Projekts enthält, formatiert als |
readAuthorizerCredential |
Pflichtangabe. Ein persönliches GitLab-Zugriffstoken mit dem Mindestzugriffsbereich |
authorizerCredential |
Pflichtangabe. Ein persönliches GitLab-Zugriffstoken mit dem Mindestzugriffsbereich |
UserCredential
| JSON-Darstellung |
|---|
{ "userTokenSecretVersion": string, "username": string } |
| Felder | |
|---|---|
userTokenSecretVersion |
Pflichtangabe. Eine SecretManager-Ressource, die das Nutzertoken enthält, das die Developer Connect-Verbindung autorisiert. Format: |
username |
Nur Ausgabe. Der mit diesem Token verknüpfte Nutzername. |
GitLabEnterpriseConfig
| JSON-Darstellung |
|---|
{ "hostUri": string, "webhookSecretSecretVersion": string, "readAuthorizerCredential": { object ( |
| Felder | |
|---|---|
hostUri |
Pflichtangabe. Der URI des GitLab Enterprise-Hosts, für den diese Verbindung bestimmt ist. |
webhookSecretSecretVersion |
Pflichtangabe. Nicht veränderbar. SecretManager-Ressource, die das Webhook-Secret eines GitLab-Projekts enthält, formatiert als |
readAuthorizerCredential |
Pflichtangabe. Ein persönliches GitLab-Zugriffstoken mit dem Mindestzugriffsbereich |
authorizerCredential |
Pflichtangabe. Ein persönliches GitLab-Zugriffstoken mit dem Mindestzugriffsbereich |
serviceDirectoryConfig |
Optional. Konfiguration für die Verwendung von Service Directory, um eine private Verbindung zu einer GitLab Enterprise-Instanz herzustellen. Dies sollte nur festgelegt werden, wenn der GitLab Enterprise-Server lokal gehostet wird und nicht über das öffentliche Internet erreichbar ist. Wenn dieses Feld leer bleibt, werden Aufrufe an den GitLab Enterprise-Server über das öffentliche Internet gesendet. |
sslCaCertificate |
Optional. SSL-Zertifikat der Zertifizierungsstelle, das für Anfragen an die GitLab Enterprise-Instanz verwendet werden soll. |
serverVersion |
Nur Ausgabe. Version des GitLab Enterprise-Servers, der auf der |
BitbucketDataCenterConfig
| JSON-Darstellung |
|---|
{ "hostUri": string, "webhookSecretSecretVersion": string, "readAuthorizerCredential": { object ( |
| Felder | |
|---|---|
hostUri |
Pflichtangabe. Der URI des Bitbucket Rechenzentrum-Hosts, für den diese Verbindung bestimmt ist. |
webhookSecretSecretVersion |
Pflichtangabe. Nicht veränderbar. SecretManager-Ressource, die das Webhook-Secret enthält, das zum Überprüfen von Webhook-Ereignissen verwendet wird. Formatiert als |
readAuthorizerCredential |
Pflichtangabe. Ein HTTP-Zugriffstoken mit dem Mindestzugriff |
authorizerCredential |
Pflichtangabe. Ein HTTP-Zugriffstoken mit dem Mindestzugriffsbereich |
serviceDirectoryConfig |
Optional. Konfiguration für die Verwendung von Service Directory, um eine private Verbindung zu einer Bitbucket Data Center-Instanz herzustellen. Dies sollte nur festgelegt werden, wenn das Bitbucket-Rechenzentrum lokal gehostet wird und nicht über das öffentliche Internet erreichbar ist. Wenn dieses Feld leer bleibt, werden Aufrufe an das Bitbucket Data Center über das öffentliche Internet ausgeführt. |
sslCaCertificate |
Optional. SSL-Zertifizierungsstelle, der bei Anfragen an Bitbucket Data Center vertraut werden soll. |
serverVersion |
Nur Ausgabe. Version des Bitbucket Data Center-Servers, der auf der |
BitbucketCloudConfig
| JSON-Darstellung |
|---|
{ "workspace": string, "webhookSecretSecretVersion": string, "readAuthorizerCredential": { object ( |
| Felder | |
|---|---|
workspace |
Pflichtangabe. Die Bitbucket Cloud-Workspace-ID, die mit der Google Cloud Platform verbunden werden soll. |
webhookSecretSecretVersion |
Pflichtangabe. Nicht veränderbar. SecretManager-Ressource, die das Webhook-Secret enthält, das zum Überprüfen von Webhook-Ereignissen verwendet wird. Formatiert als |
readAuthorizerCredential |
Pflichtangabe. Ein Zugriffstoken mit dem Mindestzugriff |
authorizerCredential |
Pflichtangabe. Ein Zugriffstoken mit dem Mindestzugriffsbereich |
SecureSourceManagerInstanceConfig
| JSON-Darstellung |
|---|
{ "instance": string } |
| Felder | |
|---|---|
instance |
Erforderlich. Nicht veränderbar. Secure Source Manager-Instanzressource, formatiert als |
GenericHTTPEndpointConfig
| JSON-Darstellung |
|---|
{ "hostUri": string, "serviceDirectoryConfig": { object ( |
| Felder | |
|---|---|
hostUri |
Erforderlich. Nicht veränderbar. Der HTTPS-Endpunkt des Dienstanbieters. |
serviceDirectoryConfig |
Optional. Konfiguration für die Verwendung von Service Directory, um eine private Verbindung zu einem HTTP-Dienstanbieter herzustellen. Dies sollte nur festgelegt werden, wenn der HTTP-Dienstanbieter lokal gehostet wird und nicht über das öffentliche Internet erreichbar ist. Wenn dieses Feld leer bleibt, werden Aufrufe an den HTTP-Dienstanbieter über das öffentliche Internet gesendet. |
sslCaCertificate |
Optional. Das SSL-Zertifikat, das für Anfragen an den HTTP-Dienstanbieter verwendet werden soll. |
Union-Feld authentication. Der Authentifizierungsmechanismus, der für Anfragen an den HTTP-Dienstanbieter verwendet werden soll. Für authentication ist nur einer der folgenden Werte zulässig: |
|
basicAuthentication |
Optional. Basisauthentifizierung mit Nutzername und Passwort. |
bearerTokenAuthentication |
Optional. Inhabertoken-Authentifizierung mit einem Token. |
BasicAuthentication
| JSON-Darstellung |
|---|
{ "username": string, // Union field |
| Felder | |
|---|---|
username |
Pflichtangabe. Der Nutzername, mit dem die Authentifizierung erfolgen soll. |
Union-Feld password. Das Passwort für die Authentifizierung. Für password ist nur einer der folgenden Werte zulässig: |
|
passwordSecretVersion |
Die Secret Manager-Secret-Version des Passworts, mit dem die Authentifizierung erfolgen soll. |
BearerTokenAuthentication
| JSON-Darstellung |
|---|
{ // Union field |
| Felder | |
|---|---|
Union-Feld token. Das Token, mit dem die Authentifizierung erfolgen soll. Für token ist nur einer der folgenden Werte zulässig: |
|
tokenSecretVersion |
Optional. Die SecretManager-Secret-Version des Tokens, mit der die Authentifizierung erfolgen soll. |
Zeitstempel
| JSON-Darstellung |
|---|
{ "seconds": string, "nanos": integer } |
| Felder | |
|---|---|
seconds |
Stellt Sekunden der UTC-Zeit seit Unix-Epoche 1970-01-01T00:00:00Z dar. Muss zwischen -62135596800 und 253402300799 (einschließlich) liegen (entspricht 0001-01-01T00:00:00Z bis 9999-12-31T23:59:59Z). |
nanos |
Nicht negative Sekundenbruchteile Nanosekunden-Auflösung. Dieses Feld ist der Nanosekunden-Teil der Dauer, keine Alternative zu Sekunden. Negative Sekundenwerte mit Bruchteilen müssen weiterhin nicht negative Nano-Werte haben, die zeitlich vorwärts gezählt werden. Muss zwischen 0 und 999.999.999 (einschließlich) liegen. |
LabelsEntry
| JSON-Darstellung |
|---|
{ "key": string, "value": string } |
| Felder | |
|---|---|
key |
|
value |
|
InstallationState
| JSON-Darstellung |
|---|
{
"stage": enum ( |
| Felder | |
|---|---|
stage |
Nur Ausgabe. Aktueller Schritt des Installationsprozesses. |
message |
Nur Ausgabe. Nachricht, was der Nutzer als Nächstes tun soll, um die Installation fortzusetzen. Leerer String, wenn die Installation bereits abgeschlossen ist. |
actionUri |
Nur Ausgabe. Link für die nächste Aktion. Leerer String, wenn die Installation bereits abgeschlossen ist. |
AnnotationsEntry
| JSON-Darstellung |
|---|
{ "key": string, "value": string } |
| Felder | |
|---|---|
key |
|
value |
|
CryptoKeyConfig
| JSON-Darstellung |
|---|
{ "keyReference": string } |
| Felder | |
|---|---|
keyReference |
Pflichtangabe. Der Name des Schlüssels, der zum Verschlüsseln/Entschlüsseln von Kundendaten verwendet wird. Der Schlüssel in Cloud KMS muss das Format |
GitProxyConfig
| JSON-Darstellung |
|---|
{ "enabled": boolean, "httpProxyBaseUri": string } |
| Felder | |
|---|---|
enabled |
Optional. Wenn Sie diese Option auf „true“ setzen, kann der Git-Proxy für Git-Vorgänge in den mit der Verbindung verknüpften Repositories verwendet werden. |
httpProxyBaseUri |
Nur Ausgabe. Der Basis-URI für den HTTP-Proxy-Endpunkt. Hat das Format |
GitHubApp
Stellt die verschiedenen GitHub-Anwendungen dar, die für einen GitHub-Nutzer oder eine GitHub-Organisation installiert und mit Developer Connect verwendet werden können.
| Enums | |
|---|---|
GIT_HUB_APP_UNSPECIFIED |
GitHub-Anwendung nicht angegeben. |
DEVELOPER_CONNECT |
Die Developer Connect GitHub-Anwendung. |
FIREBASE |
Die Firebase GitHub-Anwendung. |
GEMINI_CODE_ASSIST |
Die Gemini Code Assist-Anwendung. |
DATAFORM |
Die Dataform-GitHub-Anwendung. |
Phase
Phase des Installationsvorgangs.
| Enums | |
|---|---|
STAGE_UNSPECIFIED |
Keine Phase angegeben. |
PENDING_CREATE_APP |
Nur für GitHub Enterprise. Die Erstellung einer App wurde angefordert. Der Nutzer muss die Erstellung in seinem GitHub Enterprise-Host bestätigen. |
PENDING_USER_OAUTH |
Der Nutzer muss die GitHub-Anwendung (oder Enterprise-Anwendung) über OAuth autorisieren. |
PENDING_INSTALL_APP |
Der Nutzer muss dem Link folgen, um die GitHub-Anwendung (oder Enterprise-Anwendung) zu installieren. |
COMPLETE |
Die Installation ist abgeschlossen. |
Tool-Annotationen
Tool-Anmerkungen werden an MCP-Clients gesendet, um das grundlegende Risiko eines bestimmten Tools zu beschreiben. Die meisten Clients behandeln diese Hinweise als nicht vertrauenswürdig, sie können aber verwendet werden, um zu entscheiden, wann eine Bestätigungsaufforderung an einen Nutzer gesendet werden soll.
Zusätzlich zum Titelstring werden die folgenden booleschen Hinweise definiert:
readOnlyHint: Wenn „true“, ändert das Tool seine Umgebung nicht. Standardeinstellung: false.destructiveHint: Wenn „true“, kann das Tool destruktive Aktionen ausführen. Wenn „false“, kann das Tool nur additive Aktionen ausführen. Standardeinstellung: true.idempotentHint: Wenn „true“, hat das wiederholte Aufrufen des Tools mit denselben Argumenten keine zusätzlichen Auswirkungen auf die Umgebung. Standardeinstellung: false.openWorldHint: Wenn „true“, kann das Tool mit einer „offenen Welt“ externer Entitäten interagieren. Wenn „false“, kann das Tool nur mit internen Entitäten interagieren. Ein Tool für die Websuche wäre beispielsweise ein Open-World-Tool, ein Tool für gemerkte Informationen dagegen nicht.
Destruktiver Hinweis: ❌ | Idempotenter Hinweis: ✅ | Lesezugriff-Hinweis: ✅ | Open-World-Hinweis: ❌