将 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 官方英文文档核对: