MCP Tools Reference: developerconnect.googleapis.com

ツール: list-connections

指定されたプロジェクトとロケーションの接続を一覧表示します。

次のコードサンプルは、curl を使用して list-connections MCP ツールを呼び出す方法を示しています。

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

省略可。結果の並べ替え方法に関するヒント。

出力スキーマ

Connection の一覧表示に対するレスポンスのメッセージ

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

ID。接続のリソース名（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 ペアとしてのラベル

"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

出力専用。システムによって Connection に割り当てられる固有識別子。
cryptoKeyConfig

object (CryptoKeyConfig)

省略可。暗号鍵の構成。このフィールドは、顧客管理の暗号鍵（CMEK）機能で使用されます。
gitProxyConfig

object (GitProxyConfig)

省略可。Git プロキシ機能の構成。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 Cloud のインスタンスへの接続の構成。
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)

省略可。GitHub アプリを承認したアカウントの OAuth 認証情報。人間のユーザー アカウントではなく、ロボット アカウントを使用することをおすすめします。OAuth トークンは、この構成の GitHub アプリに関連付けられている必要があります。
appInstallationId

string (int64 format)

省略可。GitHub アプリのインストール ID。
installationUri

string

出力専用。この GitHubConfig に関連付けられたインストールを管理するために移動する URI。

OAuthCredential

JSON 表現 
{
  "oauthTokenSecretVersion": string,
  "username": string
}
フィールド
oauthTokenSecretVersion

string

必須。接続を認可する OAuth トークンを含む SecretManager リソース。形式: 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

必須。この接続の対象となる GitHub Enterprise ホストの URI。
appId

string (int64 format)

省略可。マニフェストから作成された GitHub アプリの ID。
appSlug

string

出力専用。GitHub アプリの URL フレンドリーな名前。
privateKeySecretVersion

string

省略可。GitHub アプリの秘密鍵を含む SecretManager リソース。projects/*/secrets/*/versions/* または projects/*/locations/*/secrets/*/versions/*（そのロケーションでリージョン シークレットがサポートされている場合）の形式で指定します。
webhookSecretSecretVersion

string

省略可。GitHub アプリの Webhook シークレットを含む SecretManager リソース。projects/*/secrets/*/versions/* または projects/*/locations/*/secrets/*/versions/* の形式（そのロケーションでリージョン シークレットがサポートされている場合）。
appInstallationId

string (int64 format)

省略可。GitHub アプリのインストール ID。
installationUri

string

出力専用。この GitHubEnterpriseConfig に関連付けられているインストールを管理するために移動する URI。
serviceDirectoryConfig

object (ServiceDirectoryConfig)

省略可。Service Directory を使用して GitHub Enterprise サーバーにプライベート接続するための構成。これは、GitHub Enterprise サーバーがオンプレミスでホストされ、公共のインターネットからアクセスできない場合にのみ設定する必要があります。このフィールドを空のままにすると、GitHub Enterprise サーバーへの呼び出しは公共のインターネット経由で行われます。
serverVersion

string

出力専用。host_uri にインストールされている GitHub Enterprise のバージョン。
sslCaCertificate

string

省略可。GitHub Enterprise へのリクエストに使用する SSL 証明書。
organization

string

省略可。変更不可。GitHub アプリが作成される GitHub Enterprise 組織。

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

必須。変更不可。GitLab プロジェクトの Webhook シークレットを含む SecretManager リソース。projects/*/secrets/*/versions/* または projects/*/locations/*/secrets/*/versions/* の形式（そのロケーションでリージョン シークレットがサポートされている場合）。これは Webhook の検証に使用されます。
readAuthorizerCredential

object (UserCredential)

必須。最小限の read_api スコープ アクセスと reporter の最小ロールを持つ GitLab 個人アクセス トークン。この個人用アクセス トークンに表示される GitLab プロジェクトによって、Developer Connect がアクセスできるプロジェクトが制御されます。
authorizerCredential

object (UserCredential)

必須。最小限の api スコープ アクセスと maintainer の最小ロールを持つ GitLab 個人アクセス トークン。この個人用アクセス トークンに表示される GitLab プロジェクトによって、Developer Connect がアクセスできるプロジェクトが制御されます。

UserCredential

JSON 表現 
{
  "userTokenSecretVersion": string,
  "username": string
}
フィールド
userTokenSecretVersion

string

必須。Developer Connect 接続を認可するユーザー トークンを含む SecretManager リソース。形式: 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

必須。この接続の対象となる GitLab Enterprise ホストの URI。
webhookSecretSecretVersion

string

必須。変更不可。GitLab プロジェクトの Webhook シークレットを含む SecretManager リソース。projects/*/secrets/*/versions/* または projects/*/locations/*/secrets/*/versions/* の形式（そのロケーションでリージョン シークレットがサポートされている場合）。これは Webhook の検証に使用されます。
readAuthorizerCredential

object (UserCredential)

必須。最小限の read_api スコープ アクセスと reporter の最小ロールを持つ GitLab 個人アクセス トークン。この個人用アクセス トークンに表示される GitLab プロジェクトによって、Developer Connect がアクセスできるプロジェクトが制御されます。
authorizerCredential

object (UserCredential)

必須。最小限の api スコープ アクセスと maintainer の最小ロールを持つ GitLab 個人アクセス トークン。この個人用アクセス トークンに表示される GitLab プロジェクトによって、Developer Connect がアクセスできるプロジェクトが制御されます。
serviceDirectoryConfig

object (ServiceDirectoryConfig)

省略可。Service Directory を使用して GitLab Enterprise インスタンスにプライベート接続するための構成。これは、GitLab Enterprise サーバーがオンプレミスでホストされ、公共のインターネットからアクセスできない場合にのみ設定する必要があります。このフィールドを空のままにすると、GitLab Enterprise サーバーへの呼び出しは公共のインターネット経由で行われます。
sslCaCertificate

string

省略可。GitLab Enterprise インスタンスへのリクエストに使用する SSL 認証局証明書。
serverVersion

string

出力専用。host_uri で実行されている GitLab Enterprise サーバーのバージョン。

BitbucketDataCenterConfig

JSON 表現 
{
  "hostUri": string,
  "webhookSecretSecretVersion": string,
  "readAuthorizerCredential": {
    object (UserCredential)
  },
  "authorizerCredential": {
    object (UserCredential)
  },
  "serviceDirectoryConfig": {
    object (ServiceDirectoryConfig)
  },
  "sslCaCertificate": string,
  "serverVersion": string
}
フィールド
hostUri

string

必須。この接続の対象となる Bitbucket データセンター ホストの URI。
webhookSecretSecretVersion

string

必須。変更不可。Webhook イベントの検証に使用される Webhook シークレットを含む SecretManager リソース。projects/*/secrets/*/versions/* または projects/*/locations/*/secrets/*/versions/* の形式（そのロケーションでリージョン シークレットがサポートされている場合）。これは Webhook の検証に使用されます。
readAuthorizerCredential

object (UserCredential)

必須。最小限の Repository read アクセス権を持つ HTTP アクセス トークン。認証情報の生成には、システム アカウントを使用することをおすすめします。
authorizerCredential

object (UserCredential)

必須。最小限の Repository admin スコープ アクセス権を持つ http アクセス トークン。これは、Webhook を作成するために必要です。これらの認証情報を生成するには、システム アカウントを使用することをおすすめします。
serviceDirectoryConfig

object (ServiceDirectoryConfig)

省略可。Service Directory を使用して Bitbucket Data Center インスタンスにプライベート接続するための構成。これは、Bitbucket データセンターがオンプレミスでホストされ、公共のインターネットからアクセスできない場合にのみ設定する必要があります。このフィールドを空のままにすると、Bitbucket データセンターへの呼び出しは公共のインターネット経由で行われます。
sslCaCertificate

string

省略可。Bitbucket データセンターへのリクエストを行う際に信頼する SSL 認証局。
serverVersion

string

出力専用。host_uri で実行されている Bitbucket データセンター サーバーのバージョン。

BitbucketCloudConfig

JSON 表現 
{
  "workspace": string,
  "webhookSecretSecretVersion": string,
  "readAuthorizerCredential": {
    object (UserCredential)
  },
  "authorizerCredential": {
    object (UserCredential)
  }
}
フィールド
workspace

string

必須。Google Cloud Platform に接続する Bitbucket Cloud ワークスペース ID。
webhookSecretSecretVersion

string

必須。変更不可。Webhook イベントの検証に使用される Webhook シークレットを含む SecretManager リソース。projects/*/secrets/*/versions/* または projects/*/locations/*/secrets/*/versions/* の形式（そのロケーションでリージョン シークレットがサポートされている場合）。これは、Webhook の検証と作成に使用されます。
readAuthorizerCredential

object (UserCredential)

必須。最小限の repository アクセス権を持つアクセス トークン。ワークスペース、プロジェクト、リポジトリのいずれかのアクセス トークンを使用できます。認証情報の生成には、システム アカウントを使用することをおすすめします。
authorizerCredential

object (UserCredential)

必須。最小限の repository、pullrequest、webhook スコープ アクセス権を持つアクセス トークン。ワークスペース、プロジェクト、リポジトリのいずれかのアクセス トークンを使用できます。これは、Webhook を作成するために必要です。これらの認証情報を生成するには、システム アカウントを使用することをおすすめします。

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

必須。変更不可。サービス提供者の HTTPS エンドポイント。
serviceDirectoryConfig

object (ServiceDirectoryConfig)

省略可。Service Directory を使用して HTTP サービス提供者にプライベート接続するための構成。これは、HTTP サービス提供者がオンプレミスでホストされ、パブリック インターネットからアクセスできない場合にのみ設定する必要があります。このフィールドを空のままにすると、HTTP サービス提供者への呼び出しは公共のインターネット経由で行われます。
sslCaCertificate

string

省略可。HTTP サービス提供者へのリクエストに使用する SSL 証明書。
共用体フィールド 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)

UNIX エポック 1970-01-01T00:00:00Z からの UTC 時刻の秒数を表します。-62135596800～253402300799 の範囲（両端を含む）にする必要があります（これは 0001-01-01T00:00:00Z～9999-12-31T23:59:59Z に対応します）。
nanos

integer

ナノ秒分解能による、秒の負ではない小数以下部分。このフィールドは、秒の代替ではなく、期間のナノ秒部分です。小数以下を含む負の秒の値は、時間を前方にカウントする負ではない nanos 値を持つ必要があります。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 に設定すると、接続でリンクされたリポジトリで Git オペレーションを実行するために Git プロキシを使用できるようになります。
httpProxyBaseUri

string

出力専用。HTTP プロキシ エンドポイントのベース URI。https://{generatedID}-c-h-{shortRegion}.developerconnect.dev 形式。enabled が true に設定されている場合にのみ入力されます。このエンドポイントは、Developer Connect と統合されている他の Google サービスで使用されます。

GitHubApp

GitHub ユーザーまたは組織にインストールして Developer Connect で使用できるさまざまな GitHub アプリケーションを表します。

列挙型
GIT_HUB_APP_UNSPECIFIED GitHub アプリが指定されていません。
DEVELOPER_CONNECT Developer Connect GitHub アプリケーション。
FIREBASE Firebase GitHub アプリケーション。
GEMINI_CODE_ASSIST Gemini Code Assist アプリケーション。
DATAFORM Dataform GitHub アプリケーション。

ステージ

インストール プロセスのステージ。

列挙型
STAGE_UNSPECIFIED ステージが指定されていません。
PENDING_CREATE_APP GitHub Enterprise の場合のみ。アプリの作成がリクエストされました。ユーザーは、GitHub Enterprise ホストで作成を確認する必要があります。
PENDING_USER_OAUTH ユーザーは OAuth を介して GitHub（または Enterprise）アプリを承認する必要があります。
PENDING_INSTALL_APP ユーザーはリンクをたどって GitHub（または Enterprise）アプリをインストールする必要があります。
COMPLETE インストール プロセスが完了しました。

ツールのアノテーション

ツールのアノテーションは、特定のツールの基本的なリスクを説明するために MCP クライアントに送信されます。ほとんどのクライアントは、これらのヒントを信頼できないものとして扱いますが、確認プロンプトをユーザーに送信するタイミングを決定するために使用できます。

タイトル文字列とともに、次のブール値のヒントが定義されています。

  • readOnlyHint: true の場合、ツールは環境を変更しません。デフォルトは false です。
  • destructiveHint: true の場合、ツールは破壊的なアクションを実行できます。false の場合、ツールは追加アクションのみを実行できます。デフォルト値は true です。
  • idempotentHint: true の場合、同じ引数でツールを繰り返し呼び出しても、環境に副次的影響は発生しません。デフォルトは false です。
  • openWorldHint: true の場合、ツールは外部エンティティの「オープンワールド」とやり取りできます。false の場合、ツールは内部エンティティとのみやり取りできます。たとえば、ウェブ検索ツールはオープン ワールドですが、メモリツールはオープン ワールドではありません。

破壊的ヒント: ❌ | べき等ヒント: ✅ | 読み取り専用ヒント: ✅ | オープン ワールド ヒント: ❌