將 GWC Bridge 手動連線至 Gemini

將 GWC Bridge 連線至 Gemini，讓 Gemini 能夠在您自己的電腦上處理獲准存取的檔案並執行獲准的指令。

介面標籤說明： 引號內的標籤採用 Google 目前英文文件中的原文。隨著 Google 陸續推出各項功能，您看到的介面可能會有所不同。GWC Bridge 可讓 Gemini 在您自己的電腦上處理獲准存取的檔案並執行獲准的指令，該電腦上需執行 GWC for VS Code 或 GWC Studio。新增自訂 MCP 伺服器並不代表 Google 已審核或認可 GWC Bridge。

1. 誰可以使用此方式

Gemini： 在專案的受管理組織原則允許自訂 MCP 連接器後，管理員可以新增 Custom MCP Server 資料存放區（Data store）。Google 要求建立資料存放區的管理員具備 Discovery Engine Editor 角色；如果啟用了 VPC Service Controls 或受管理原則強制執行，還可能需要額外調整對外流量（egress）與資料來源原則。^[1]^[2]

Gemini CLI： GWC Bridge 目前不支援此路徑。請勿設定靜態 Gemini CLI OAuth 用戶端。

個人版 Gemini 自訂應用程式： Google 目前僅向符合資格的使用者開放自訂應用程式：年滿 18 歲、位於美國、使用個人 Google Account 登入、已開啟 “Keep Activity”（保留活動記錄），且將此功能的語言設為英文。設定從 Gemini 網頁版應用程式開始。^[4] GWC Bridge 尚未對此個人版流程啟用。 Google 文件說明，當伺服器不支援動態用戶端註冊（Dynamic Client Registration）時，可在 “Advanced features”（進階功能）下輸入憑證，但目前的說明頁面並未公布需要由 GWC 加入允許清單的回呼 URI。GWC 不會猜測該位址，也不會接受萬用字元重新導向。

2. 開始之前

請準備好您的 GWC 帳號，確保 Connect Pass 處於有效狀態，並確認 GWC for VS Code 或 GWC Studio 已在您希望 Gemini 使用的電腦上執行且已連線。
當 OAuth 視窗開啟時，請登入同一個 GWC 帳號。新增 MCP URL 不會安裝或啟動電腦端元件。
請檢查該電腦開放的檔案、資料夾及指令權限，並從所需的最小權限開始設定。
GWC Bridge 仍會強制執行自身的帳號、授權（grant）、資料夾、資源、核准與指令原則。Gemini 無法自行授予遭 GWC 拒絕的存取權限。

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 的對外流量（egress）。^[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

Google 目前針對 Gemini MCP 應用程式提供的 Cloud 範例同樣顯示已啟用 PKCE 且未勾選 HTTP Basic。^[7]

Google 為此連接器記錄的重新導向位址固定為 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 靜態 Client ID。目前的 Google 說明頁面未公布個人版自訂應用程式的 OAuth 回呼 URI，且 GWC 沒有動態用戶端註冊端點。混用 Enterprise 回呼或 CLI 本機迴路回呼是不正確的，而接受萬用字元則會削弱 OAuth 重新導向綁定的安全性。

只有在滿足以下至少一項條件後，該方式才可獲得支援：

Google 公布穩定且確切的個人版回呼 URI，使 GWC 能夠將其綁定至專用的公開 Client ID；或
GWC 實作並通過安全審查符合 Gemini 用戶端註冊流程的動態用戶端註冊。

在此之前，本指南唯一受支援的客戶路徑是 Gemini。

7. Gemini 能看到什麼，以及如何中斷連線

當 Gemini 呼叫 GWC Bridge 工具時，工具結果可能包含檔案名稱、檔案內容、指令輸出、裝置標籤或獲准使用的工具傳回的其他資料。這些內容會離開您的電腦，並由您選擇的 Gemini 介面進行處理。Google 聲明第三方自訂 MCP 伺服器不受 Google 控制，並建議僅連接您信任的伺服器。^[4]

GWC Bridge 權限始終具有最終決定權：

檔案讀取僅限於與目前有效 GWC Bridge 連線共用的資料夾。
檔案變更要求連線與資料夾均允許變更，並通過受保護動作檢查。
指令執行要求連線允許 Commands，且仍可能需要核准。
不同的電腦、不同的帳號或已撤銷的授權（grant）不能與您已授權的對象互換使用。

如需中斷連線：

Gemini： 管理員可依組織原則停用動作、中斷資料存放區與應用程式的連線，或移除自訂 MCP 資料存放區。
Gemini CLI： 目前沒有啟用 GWC OAuth 用戶端。請移除任何實驗性的 GWC Bridge OAuth 設定，不要嘗試進行身分驗證。
在 GWC 中撤銷底層 Bridge 授權（grant）會立即使存取失效，無論 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 回報無效的重新導向（invalid redirect）	確認 Client ID 嚴格為 `gwc-google-gemini-v1`。針對該用戶端，GWC 僅接受 Google 文件記錄的 `https://vertexaisearch.cloud.google.com/oauth-redirect`。
Verify Auth 回報無效的用戶端密鑰（invalid client secret）	請嚴格輸入 `none`、啟用 PKCE，並將 Use HTTP Basic 保持為 Off。GWC 僅將此值視為 Google 表單針對該公開用戶端要求的預留位置，任何其他密鑰均會遭拒。
授權立即失敗	確認 GWC 已啟用 Gemini 手動 OAuth。伺服器端相容性開關預設處於關閉狀態。
Gemini 無法連上伺服器或 OAuth 端點	如果啟用了對外流量控制，請同時放行 `mcp.gwc-corp.com` 與 `api.gwc-corp.com`，並再次核對 HTTPS URL 是否完全一致。
資料存放區狀態為 Active，但 Gemini 不呼叫工具	自訂 MCP 動作預設處於停用狀態。請啟用所需動作，並將資料存放區連接至目標 Gemini 應用程式。

聯絡 GWC 支援團隊時，請說明您使用的 Gemini 介面（Enterprise 或 CLI）、設定步驟以及確切的錯誤訊息。切勿傳送密碼、Bearer 權杖、私人檔案內容或任何真實的用戶端密鑰。

9. 官方參考資料

服務供應商步驟已於 2026-10-22 (Asia/Singapore) 對照 Google 目前官方英文文件核對：