GWC Bridge を Gemini に手動で接続する

GWC Bridge を Gemini に接続すると、ご自身の PC 上で許可したファイルやコマンドを Gemini で扱えるようになります。

画面のラベルについて： 引用符内のラベルは、Google の現在の公式英語ドキュメントに従っています。Google の機能ロールアウトに伴い、実際の画面表示は異なる場合があります。GWC Bridge を使うと、GWC for VS Code または GWC Studio が動作しているご自身の PC 上で、Gemini が許可されたファイルやコマンドを扱えるようになります。カスタム MCP サーバーを追加しても、Google が GWC Bridge を審査または推奨したことにはなりません。

1. 利用できる経路

Gemini： プロジェクトのマネージド組織ポリシーでカスタム MCP コネクターが許可された後、管理者が Custom MCP Server データストアを追加できます。データストアを作成する管理者には Google の Discovery Engine Editor ロールが必要です。また、VPC Service Controls やマネージド強制適用が有効な場合は、追加のイグレス（外向き通信）およびデータソースのポリシー変更が必要になることがあります。^[1]^[2]

Gemini CLI： GWC Bridge は現在この経路をサポートしていません。静的な Gemini CLI OAuth クライアントを設定しないでください。

個人向け Gemini のカスタムアプリ： 現在、Google はカスタムアプリの対象ユーザーを、18 歳以上、米国在住、個人の Google Account でサインイン済み、“Keep Activity”（アクティビティの保存）がオン、かつこの機能の利用言語が英語のユーザーに限定しています。設定は Gemini ウェブアプリから開始します。^[4] この個人向けフローでは、GWC Bridge はまだ有効になっていません。 サーバーが動的クライアント登録（Dynamic Client Registration）に対応していない場合、“Advanced features”（高度な機能）で認証情報を入力する手順が Google のヘルプに記載されていますが、現在のヘルプページには GWC が許可リストに登録すべきコールバック URI が公開されていません。GWC が URI を推測したり、ワイルドカードのリダイレクトを受け入れたりすることはありません。

2. 始める前に

GWC アカウントと有効な Connect Pass を用意し、Gemini に使用させたい PC で GWC for VS Code または GWC Studio を起動して、接続しておいてください。
OAuth ウィンドウが開いたら、同じ GWC アカウントにサインインしてください。MCP URL を追加しても、PC 側のコンポーネントはインストール・起動されません。
その PC で公開するファイル、フォルダー、コマンドの権限を確認し、最初は必要最小限のアクセスにとどめてください。
GWC Bridge は、アカウント、付与（グラント）、フォルダー、リソース、承認、コマンドに関する独自のポリシーを引き続き適用します。GWC が拒否するアクセス権を Gemini が自らに付与することはできません。

3. サーバーアドレスと OAuth

次の MCP サーバーアドレスを使用してください。

https://mcp.gwc-corp.com/mcp

GWC の OAuth エンドポイントは次のとおりです。

Authorization URL: https://api.gwc-corp.com/oauth/authorize
Token URL:         https://api.gwc-corp.com/oauth/token
Issuer:            https://api.gwc-corp.com

サポート対象の Gemini 経路は Authorization Code と PKCE S256 を使用します。静的クライアント ID は公開識別子で、Google の正確なホスト型コールバックに結び付けられています。GWC Bridge は現在 Gemini CLI OAuth クライアントを登録していません。

4. Gemini の管理者設定

Google では、Custom MCP Server の設定は組織全体の管理者操作として扱われます。^[1]

Google Cloud で、Gemini アプリを所有するプロジェクトを選択します。
Organization Policies（組織のポリシー）を開き、Disable custom MCP server connector for Gemini Enterprise（constraints/discoveryengine.managed.disableCustomMcpServerConnector）を探します。このプロジェクトに対して親ポリシーをオーバーライドし、適用（Enforcement）を Off に設定します。組織の明確なガバナンス上の決定でない限り、より広い組織スコープでポリシーを無効にしないでください。^[2]
プロジェクトが VPC Service Controls で保護されている場合、または関連するマネージドコネクターポリシーがこのプロジェクトに適用されている場合は、データソースとして custom_mcp を許可し、mcp.gwc-corp.com と api.gwc-corp.com の両方へのイグレスを許可します。^[1]^[5]
データストアを作成する管理者に、必須の Discovery Engine Editor ロール（roles/discoveryengine.editor）を付与します。^[1]
Gemini Enterprise → Data stores → Create data store → Custom MCP Server → Add MCP server を開きます。
OAuth 2.0 を選択し、次の値を入力します。

項目	値
MCP Server URL	`https://mcp.gwc-corp.com/mcp`
Authorization URL	`https://api.gwc-corp.com/oauth/authorize`
Authorization URL Parameters	空欄のままにする（Leave blank）
Token URL	`https://api.gwc-corp.com/oauth/token`
Client ID	`gwc-google-gemini-v1`
Client Secret	`none`
Scopes	`files:read files:write commands:run`
Enable PKCE Support	On
Use HTTP Basic	Off

Gemini の MCP アプリに関する Google Cloud の現在の設定例でも、同様に PKCE が有効化され、HTTP Basic のチェックが外されています。^[7]

このコネクターに対して Google が文書化しているリダイレクト URI は https://vertexaisearch.cloud.google.com/oauth-redirect のみです。GWC のクライアントプロファイルはこの URI のみを受け入れ、サブパス、別ホスト、ワイルドカードは一切受け入れません。^[1] none という値は共有シークレットではありません。PKCE パブリッククライアントでフォームが Client Secret 欄の入力を必須としている場合、Google 自身の Looker MCP 手順でもこのリテラル値 none が使用されています。^[6]

Verify Auth（認証を確認）をクリックし、GWC にサインインして要求された GWC 権限を確認し、アカウントと接続先が正しい場合のみ承認します。
データストアの作成を完了し、状態が Active になるまで待ちます。
データストアの Actions（アクション）ビューを開き、必要に応じてカスタムアクションを再読み込みし、Gemini に使用させたい GWC Bridge ツールのみを有効にします。Google はカスタム MCP のアクションを既定で無効にしています。^[1]
目的の Gemini アプリにデータストアを接続し、読み取り専用の初回確認を実行します：Use GWC Bridge to show which of my computers and shared folders are available. Do not change files or run commands.

5. Gemini CLI

Gemini CLI はリモート MCP サーバーに接続できますが、GWC Bridge は現在 Gemini CLI OAuth クライアントを有効にしていません。Gemini CLI に GWC Bridge の OAuth プロファイルを追加しないでください。GWC が別途レビュー済みのクライアント識別方式を公開するまで、この経路は未サポートです。

6. 個人向け Gemini のカスタムアプリ

Google の個人向け Gemini Apps ヘルプによると、対象ユーザーは Settings → Connected Apps（設定 → 接続済みアプリ）を開き、MCP サーバーの URL でカスタムアプリを追加し、サーバーが動的クライアント登録に対応していない場合は Advanced features（高度な機能）を開いて認証情報を入力できるとされています。^[4]

現時点では、そこに GWC のどちらの静的クライアント ID も入力しないでください。現在の Google ヘルプページには個人向けカスタムアプリの OAuth コールバック URI が記載されておらず、GWC には動的クライアント登録エンドポイントがありません。Enterprise 用のコールバックや CLI 用のループバックコールバックを流用するのは誤りであり、ワイルドカードを受け入れると OAuth のリダイレクト拘束が弱まってしまいます。

この経路をサポートできるようになるのは、次の少なくとも一方が満たされた後です。

Google が安定した正確な個人向けコールバック URI を公開し、GWC がそれを専用のパブリッククライアント ID に紐付けられるようになること、または
GWC が Gemini のクライアント登録フローを満たす動的クライアント登録を実装し、セキュリティレビューを完了すること。

それまでは、このガイドでサポートする顧客向け経路は Gemini のみです。

7. Gemini に見えるものと切断方法

Gemini が GWC Bridge のツールを呼び出すと、ツールの結果にはファイル名、ファイルの内容、コマンドの出力、デバイスラベルなど、許可されたツールが返すデータが含まれる場合があります。その内容はご自身の PC から送信され、選択した Gemini の利用環境で処理されます。Google は、サードパーティ製のカスタム MCP サーバーは Google の管理外であり、信頼できるサーバーのみを接続するよう推奨しています。^[4]

GWC Bridge の権限が引き続き最終的な判断基準となります。

ファイルの読み取りは、有効な GWC Bridge 接続に共有されているフォルダーに限定されます。
ファイルの変更には、接続とフォルダーの両方で変更が許可されていること、および保護された操作のチェックを通過することが必要です。
コマンドの実行には、接続で Commands が許可されていることが必要であり、承認が求められる場合があります。
承認したものとは異なる PC、異なるアカウント、または失効したグラントを流用することはできません。

切断するには：

Gemini： 管理者が組織のポリシーに従って、アクションを無効化する、アプリからデータストアの接続を解除する、またはカスタム MCP データストアを削除できます。
Gemini CLI： GWC OAuth クライアントは有効ではありません。認証を試みず、実験的な GWC Bridge OAuth プロファイルを削除してください。
GWC 側で対象の Bridge グラントを取り消すと、Gemini 側の設定にかかわらずアクセス権は無効になります。

8. トラブルシューティング

症状	確認すること
Gemini CLI OAuth を試行した	中止してください。GWC Bridge は現在 Gemini CLI OAuth をサポートしていません。
Gemini で Custom MCP Server がブロックされていると表示される	プロジェクトレベルのマネージド制約 Disable custom MCP server connector for Gemini Enterprise がオーバーライドされ、Off になっていることを確認してください。VPC Service Controls やマネージド強制適用が有効な場合は、`custom_mcp` と必要なイグレス FQDN も許可してください。
Verify Auth で無効なリダイレクトと報告される	Client ID が正確に `gwc-google-gemini-v1` であることを確認してください。GWC はそのクライアントに対して Google が文書化した `https://vertexaisearch.cloud.google.com/oauth-redirect` のみを受け入れます。
Verify Auth で無効なクライアントシークレットと報告される	正確に `none` と入力し、PKCE を有効にし、Use HTTP Basic をオフのままにしてください。GWC はこの 1 つのパブリッククライアントに対する Google のフォーム入力必須プレースホルダーとしてのみ `none` を受け入れ、それ以外のシークレットはすべて拒否します。
認可が即座に失敗する	GWC で Gemini の手動 OAuth が有効になっていることを確認してください。サーバー側の互換性フラグは既定でオフです。
Gemini がサーバーまたは OAuth エンドポイントに到達できない	イグレス制限が適用されている場合は、`mcp.gwc-corp.com` と `api.gwc-corp.com` の両方を許可してください。HTTPS URL が正確か再確認してください。
データストアは Active だが Gemini がツールを呼び出さない	カスタム MCP のアクションは既定で無効になっています。使用するアクションを有効にし、目的の Gemini アプリにデータストアを接続してください。

| サインインは成功するが GWC にアクセスを拒否される | GWC アカウントと有効な Connect Pass を確認したうえで、Bridge グラントと PC 側の権限を確認してください。状態を変更するツールをむやみに再試行しないでください。 | | PC またはフォルダーを利用できない | 目的の PC がオンラインであり、GWC Studio または GWC for VS Code が起動して接続されており、そのフォルダーがこの接続に共有されていることを確認してください。 | | 読み取りはできるが編集やコマンドが失敗する | GWC Bridge の Change files / Commands 権限と承認プロンプトを確認してください。拒否はポリシー上の境界であり、認証失敗を示すものではありません。 | | 個人向け Gemini のカスタムアプリで認証情報を求められる | Enterprise 用や CLI 用のクライアント ID を使用しないでください。現在、個人向けのコールバック URI が文書化されていないため、GWC は意図的にこの経路を拒否します。 |

GWC サポートに問い合わせる際は、ご利用の Gemini 環境（Enterprise または CLI）、設定手順のステップ、正確なエラーメッセージをお知らせください。パスワード、Bearer トークン、非公開ファイルの内容、実際のクライアントシークレットは絶対に送信しないでください。

9. 公式の参考資料

提供元の手順は 2026-10-22 (Asia/Singapore) に Google の現在の公式英語ドキュメントと照合して確認しました。