Skip to content

将 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. 开始之前

  1. 请准备好您的 GWC 账户,确保 Connect Pass 处于有效状态,并确认 GWC for VS Code 或 GWC Studio 已在您希望 Claude 使用的电脑上运行且已连接。
  2. 在电脑应用和授权 Claude 连接器时使用同一个 GWC 账户登录;在 Claude 中添加 GWC Bridge 的 URL 不会安装电脑端组件。
  3. 请检查您准备开放的文件、文件夹和命令权限,并从所需的最小权限开始配置。
  4. GWC Bridge 会拒绝未经身份验证或不具备使用资格的调用方;添加服务器 URL 或看到工具列表不会绕过这些检查。

3. 服务器地址与 OAuth

请使用以下服务器地址:

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

GWC 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)

  1. 在 claude.ai(或 Claude Desktop)中登录您打算使用的 Claude 账户,并打开 "Customize" → "Connectors"(自定义 → 连接器)。
  2. 点击 "+ Add"(+ 添加)或 "+" → "Add custom connector"(添加自定义连接器)。如果使用统一菜单布局,请点击 "Add" → "Custom" → "Web"。
  3. 将连接器命名为 GWC Bridge,并输入 https://mcp.gwc-corp.com/mcp;如果对话框显示 "Advanced settings"(高级设置)部分(包含可选的 OAuth Client ID 和 OAuth Client Secret),请将这两个字段都留空。
  4. 点击 "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" 留空。
  5. 点击 "Add" 完成连接器创建,若登录流程尚未开始则点击 "Connect"(连接),然后在浏览器中完成 GWC 的登录和授权流程。
  6. 在 "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)

  1. 组织的 "Owner" 或 "Primary Owner"(在 Enterprise 套餐中,自定义角色包含 "Manage access to Libraries" 权限的成员也可以执行此操作)打开 "Organization settings" → "Connectors" → "Add" → "Custom" → "Web"(或直接选择 "Add custom connector")。
  2. 输入名称 GWC Bridge 和服务器 URL https://mcp.gwc-corp.com/mcp,然后点击 "Continue"。
  3. 保留检测到的身份验证设置("Sign in now" 和 "Use Claude's published identity (Recommended)"),将 "Request headers" 和所有自定义 OAuth 客户端凭据字段留空,然后点击 "Add"。
  4. 将连接器添加到组织后,每位成员需打开 "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:

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

  1. Get started with custom connectors using remote MCP.
  2. Use connectors to extend Claude's capabilities.
  3. Claude Code: Connect to tools via MCP.
  4. Authentication for connectors.