將 GWC Bridge 手動連線至 Claude
將 GWC Bridge 作為自訂連接器連線至 Claude,讓 Claude 能夠在您自己的電腦上處理獲准存取的檔案並執行獲准的指令。
介面標籤說明: 引號內的標籤採用服務供應商英文介面文件中的原文。尚未驗證在地化標籤,你看到的介面可能不同。GWC Bridge 可讓 Claude 在您自己的電腦上處理獲准存取的檔案並執行獲准的指令,該電腦上需執行 GWC for VS Code 或 GWC Studio。本指南使用 Claude 的自訂連接器設定方式;手動新增伺服器並不代表 Anthropic 已審核或認可該伺服器。
1. 誰可以使用此方式
Claude 的 Free、Pro、Max、Team 和 Enterprise 方案均支援自訂遠端連接器。Free 帳號可新增一個自訂連接器。Team 方案必須先由組織 "Owner"(擁有者)或 "Primary Owner"(主要擁有者)將 GWC Bridge 新增至組織;Enterprise 方案則必須先由 "Owner"、"Primary Owner",或自訂角色包含 "Manage access to Libraries"(管理資料庫存取權限)權限的成員新增。[1]
Claude Code 的使用資格需另行透過支援的訂閱或組織安排取得。僅有 Free Claude 帳號並不包含 Claude Code 的存取權限。[3]
2. 開始之前
- 請準備好您的 GWC 帳號,確保 Connect Pass 處於有效狀態,並確認 GWC for VS Code 或 GWC Studio 已在您希望 Claude 使用的電腦上執行且已連線。
- 在電腦應用程式及授權 Claude 連接器時使用同一個 GWC 帳號登入;在 Claude 中新增 GWC Bridge 的 URL 不會安裝電腦端元件。
- 請檢查您準備開放的檔案、資料夾及指令權限,並從所需的最小權限開始設定。
- GWC Bridge 會拒絕未經身分驗證或不具備使用資格的呼叫端;新增伺服器 URL 或看到工具清單不會略過這些檢查。
3. 伺服器位址與 OAuth
請使用以下伺服器位址:
https://mcp.gwc-corp.com/mcpGWC Bridge 使用 Claude 發布的用戶端 ID 中繼資料文件(CIMD)和 PKCE 自動完成身分驗證。您不需要,也不得填寫 OAuth Client ID 或 OAuth Client Secret。請勿將密碼、存取權杖或用戶端密鑰貼到 Claude 對話或要求標頭中。[4]
使用外掛 ZIP 安裝(可選): 僅當 GWC Bridge 設定頁面提供 Claude 的 ZIP 下載時,才先從該頁面取得。在 Claude 的 Customize > Plugins > Add > Upload plugin 上傳 ZIP,再開啟 GWC Bridge > Connectors > Connect,使用電腦上的同一 GWC 帳戶登入。此方式與下方 Add custom connector 擇一,不要重複新增。
4. 個人設定(Free、Pro 或 Max)
- 在 claude.ai(或 Claude Desktop)中登入您打算使用的 Claude 帳號,並開啟 "Customize" → "Connectors"(自訂 → 連接器)。
- 點選 "+ Add"(+ 新增)或 "+" → "Add custom connector"(新增自訂連接器)。如果使用統一選單版面,請點選 "Add" → "Custom" → "Web"。
- 將連接器命名為 GWC Bridge,並輸入
https://mcp.gwc-corp.com/mcp;如果對話方塊顯示 "Advanced settings"(進階設定)區段(包含選填的 OAuth Client ID 和 OAuth Client Secret),請將這兩個欄位都留白。 - 點選 "Continue"(繼續)(或在單一步驟的對話方塊中點選 "Add")查看偵測到的身分驗證設定:在 "Authentication" 下保留 "Sign in now"(請勿選擇 "No sign in");在 "OAuth client" 下保留 "Use Claude's published identity (Recommended)"(請勿選擇 "Register automatically",因為 GWC Bridge 不使用動態用戶端註冊,也不要選擇 "Use your own OAuth client");並將 "Request headers" 留白。
- 點選 "Add" 完成連接器建立,若登入流程尚未開始則點選 "Connect"(連線),然後在瀏覽器中完成 GWC 的登入及授權流程。
- 在 "Customize" → "Connectors" 中確認 GWC Bridge 顯示為已連線,在對話中開啟 "+" → "Connectors"(或 "Search and tools" 選單)並啟用 GWC Bridge,保持檔案變更與指令執行需要核准的設定,並進行首次唯讀檢查(
Use GWC Bridge to show which of my computers and shared folders are available. Do not change files or run commands.),請查看實際的工具結果而不只是 Claude 聲稱已連線的回覆。[1]
5. 組織設定(Team 或 Enterprise)
- 組織的 "Owner" 或 "Primary Owner"(在 Enterprise 方案中,自訂角色包含 "Manage access to Libraries" 權限的成員也可以執行此操作)開啟 "Organization settings" → "Connectors" → "Add" → "Custom" → "Web"(或直接選擇 "Add custom connector")。
- 輸入名稱 GWC Bridge 和伺服器 URL
https://mcp.gwc-corp.com/mcp,然後點選 "Continue"。 - 保留偵測到的身分驗證設定("Sign in now" 和 "Use Claude's published identity (Recommended)"),將 "Request headers" 和所有自訂 OAuth 用戶端憑證欄位留白,然後點選 "Add"。
- 將連接器新增至組織後,每位成員需開啟 "Customize" → "Connectors",找到標有 "Custom" 標籤的 GWC Bridge,點選 "Connect" 使用自己的 GWC 帳號登入,並在對話的 "+" → "Connectors"(或 "Search and tools")中啟用它。
讓組織可以使用連接器,並不會自動為成員登入。[1]
6. 行動裝置與 Claude Code
請先在 Claude 網頁版或 Claude Desktop 中設定 GWC Bridge 並完成身分驗證,然後在 Claude iOS 或 Android 應用程式中登入同一個 Claude 帳號(如適用,也請進入同一個組織)。網頁連接器在您的帳號中設定完成後,即可在 Claude Mobile 中使用。直接在行動裝置上安裝連接器目前仍處於測試階段;設定自訂連接器的主要方式仍是 Claude Desktop 和網頁版。[2]
在 Claude Code 中,請先查看 /mcp:如果您使用 Claude 帳號登入,您在 claude.ai 上新增的連接器可能已經自動載入;如果帳號連接器已存在,請勿重複新增 CLI 項目。如需透過 CLI 直接新增(或日後移除)GWC Bridge,請在終端機中執行:[3]
claude mcp add --transport http --scope user gwc-bridge https://mcp.gwc-corp.com/mcp
claude mcp remove gwc-bridge --scope user新增後啟動 Claude Code 並執行 /mcp,選擇 gwc-bridge,再選擇 "Authenticate"(進行驗證),然後在瀏覽器中完成 GWC 登入流程。user 範圍會讓這台電腦上的所有專案都能使用該伺服器。請確認伺服器狀態,並進行上方的首次唯讀檢查。您的組織可能會限制 Claude Code 可以載入哪些 MCP 伺服器;請勿透過變更身分驗證方式或切換帳號來規避組織原則。[3][4]
7. Claude 能看到什麼,以及如何中斷連線或移除
GWC Bridge 不只是一份工具名稱清單。當獲准使用的工具讀取檔案或傳回指令輸出時,這些內容會傳送給 Claude;連接器也可以提供 MCP 資源和工作流程提示詞。透過 GWC Bridge 可執行的操作取決於您的 GWC 權限和電腦上的資料夾原則。Claude 的工具權限設定可以限制 Claude 呼叫哪些工具,但不能授予 GWC Bridge 已拒絕的存取權限。請仔細查看核准提示,尤其是在編輯檔案、刪除檔案或執行指令之前。請勿認為遠端連接器的流量始終只在本機傳輸:在 claude.ai、Claude Desktop、Cowork 和 Claude Mobile 中,Claude 都透過 Anthropic 的雲端基礎架構連接遠端 MCP 伺服器。新增 URL 絕不會自動授予螢幕控制、無限制的檔案存取或未經核准的指令執行權限;只有您在 GWC 中授權的共用資料夾和功能才可使用。
如需中斷連線或移除 GWC Bridge,請開啟 "Customize" → "Connectors",然後選擇 GWC Bridge:
- "Disconnect"(中斷連線)會使 Claude 登出 GWC Bridge,但保留清單中的連接器。
- "Remove" / "Delete"(移除/刪除,位於連接器選單中)會從您的帳號移除個人自訂連接器。
- Team 和 Enterprise 方案的 "Organization-wide removal"(從整個組織移除)必須由獲授權的擁有者在 "Organization settings" → "Connectors" 中執行。
- 在對話的 "+" → "Connectors" 或 "Search and tools" 選單中關閉連接器,只會在該對話中停用它;如果連接器是從您的 claude.ai 帳號同步而來或由組織提供,請在 Claude 的連接器設定中管理或移除它(也可以在
/mcp中僅為自己關閉它)。
8. 疑難排解
| 症狀 | 檢查事項 |
|---|---|
| 沒有新增自訂連接器的選項 | 如果使用 Free 方案,請檢查唯一的自訂連接器名額是否已被使用。如果使用 Team 或 Enterprise,請讓組織擁有者(或擁有 "Manage access to Libraries" 權限的 Enterprise 管理員)在 "Organization settings" → "Connectors" 中新增。 |
| 連接器目錄中找不到 GWC Bridge | 請使用自訂連接器的 URL 設定流程(https://mcp.gwc-corp.com/mcp)。手動設定不要求連接器已在目錄中上架。 |
| 設定時要求填寫 OAuth Client ID 或 OAuth Client Secret | 請將 "Advanced settings" 中選填的 Client ID 和 Client Secret 欄位留白,切勿猜測或填寫靜態用戶端憑證。 |
| OAuth 用戶端註冊失敗 | 在兩步驟設定對話方塊中,確認 "OAuth client" 設為 "Use Claude's published identity (Recommended)",而不是 "Register automatically"(GWC Bridge 不使用動態用戶端註冊)或 "Use your own OAuth client"。 |
| 登入完成,但 GWC 拒絕存取 | 請確認您使用了正確的 GWC 帳號,而且該帳號的 Connect Pass 處於有效狀態。請勿選擇 "No sign in" 來規避拒絕。 |
| “Couldn’t reach the MCP server”(無法連接至 MCP 伺服器) | 請再次確認 URL 為 https://mcp.gwc-corp.com/mcp。暫時性服務中斷、OAuth 探索逾時,或 Anthropic 的 IP 位址範圍與伺服器之間受到網路防火牆/WAF 封鎖,都可能導致此錯誤。請向 GWC 支援團隊提供確切的錯誤訊息和參考 ID。 |
| 已連線,但 Claude 不使用工具 | 請檢查對話的 "+" → "Connectors"/"Search and tools" 選單中是否已啟用 GWC Bridge,並確認個別工具沒有被停用。請明確要求執行 GWC Bridge 操作。 |
| 電腦或資料夾無法使用 | 請確認目標電腦在線上、GWC Studio 或 GWC for VS Code 正在執行且已連線,而且已為此連線共用該資料夾。未確認另一台電腦是您希望使用的目標前,請勿切換過去。 |
| 可以讀取,但編輯或指令執行失敗 | 請同時檢查 Claude 的工具核准設定,以及 GWC 中該資料夾的 "Change files"(變更檔案)/"Commands"(指令)權限。請將權限拒絕視為需要解決的原則限制,而不是可以盲目重試的暫時性故障。 |
| 行動版沒有顯示連接器 | 請確認行動版登入的是同一個 Claude 帳號和組織,並先在 Claude 網頁版或 Claude Desktop 中完成自訂連接器的初始設定。 |
| Claude Code 沒有顯示網頁版新增的連接器 | 執行 /status 檢查您的登入方式。使用 API 金鑰或不同的供應商設定檔登入,會導致 claude.ai 帳號連接器無法載入。也請在 /mcp 中檢查組織的 MCP 原則。 |
| Claude Code 需要身分驗證,或瀏覽器沒有開啟 | 執行 /mcp,選擇 gwc-bridge,然後選擇 "Authenticate"。如果瀏覽器沒有自動啟動,請複製終端機中顯示的授權 URL 並將其開啟。 |
| 檔案變更或指令執行逾時 | 請勿認為操作已完全失敗。在重複執行會變更狀態的操作之前,請先檢查目前的檔案狀態或近期活動。 |
聯絡 GWC 支援團隊時,請提供您使用的 Claude 應用程式或介面、Claude 方案類型、發生問題的步驟,以及任何錯誤訊息或參考 ID。請勿傳送密碼、Bearer 權杖、用戶端密鑰或私人檔案內容。
9. 官方參考資料
服務供應商步驟已於 2026-10-21 (Asia/Singapore) 對照 Anthropic 官方英文文件核對: