跳转到主要内容
连接器是你授权给 AIHubMix Cloud 的第三方账号。连接后,云端会话可以以你的身份读写这些服务,例如拉取 GitHub 仓库、搜索 Gmail。授权在浏览器中完成,不需要填写 token。 连接器只管「账号」;Agent 的能力扩展(插件、MCP、Skills)在插件 / MCP / Skills里管理。

适用范围

桌面客户端、网页版和手机网页都支持。连接器只用于云端会话,不改动你本机的配置;每个连接器连接一个账号。

入口

  • 「设置 › 集成 › 连接器」。
  • 新建项目选「从 GitHub 导入」但还没连接 GitHub 时,点「前往连接 GitHub」。

连接器页

页面分为「代码」(GitHub)、「邮件」(Gmail)、「已连接的应用」「可连接的应用」几组。每行显示名称和状态: 能连接哪些应用以页面显示为准。

连接应用

  1. 在应用一行点「连接」(Gmail 需要先选择权限档位,见下文)。
  2. 浏览器打开该服务的授权页,在上面完成授权。没看到页面时点「重新打开浏览器」。
  3. 完成后回到 AIHubMix Cloud,该应用显示为已连接。
授权没有完成时会提示「授权未完成」并写明原因,点「重试」或「重新连接」再来一次。如果提示已经连着另一个账号,要换账号请先断开现有连接。

GitHub

GitHub 授权后可以导入仓库建项目、在云主机上拉取代码、推送分支、创建 PR,会话中也能读取 Issue、PR 和搜索代码。能访问哪些仓库和组织,在 GitHub 中管理:在管理页点「在 GitHub 管理」可以追加组织或仓库。 断开 GitHub 后,已有的云端环境将无法拉取代码、推送分支或创建 PR,环境里的文件会保留。

Gmail

Gmail 有两个权限档位,并且 Agent 发信前一定会在会话里征求你的同意。每个 AIHubMix 账号只能连接一个 Google 账号。
  • 更改权限:在 Gmail 管理页点「更改授权范围」,选择新档位后点「前往 Google 授权」。
  • 重新连接:授权失效时点「重新连接」,沿用当前档位。
  • 如果你选了「读取并发送邮件」,但在 Google 授权页面没有勾选读取权限,Gmail 行会显示「仅发送」,Agent 暂时不能读取邮件。点「更改授权范围」重新授权并勾选读取权限即可。

发信前确认

Agent 要发邮件时,会先在会话里显示「发送邮件前需要你确认」,列出发件人、收件人、主题和正文。点「发送」或「不发送」。管理页里的权限开关不能跳过这一步确认;连接 Outlook 后发信同样需要确认。

连接器管理与访问权限

已连接的应用都可以点「管理」打开「连接器管理」,查看已连接账号、访问权限,以及「断开连接」。

访问权限

访问权限列表来自该账号在服务方的实际授权,不同应用、不同账号看到的项目不同。
  • 已授权的权限可以用开关停用或启用;保存成功后才生效。关闭某项权限后,会话调用该能力时会被拦下。
  • 灰色不可切换的项,是此账号未授予、不可修改,或需要重新连接的权限。要扩大授权范围需要重新授权。
  • 保存失败或读取授权信息失败时,点「重新读取」后再试。

断开连接

  1. 在管理页点「断开连接」。
  2. 在确认弹窗里点「断开连接」。断开后云端任务将无法再访问此应用,之后可以随时重新连接。
断开失败时连接仍然保留,点「重新读取」后再试。

注意与限制

  • 每个连接器只连接一个账号;要换账号先断开。
  • 连接器只对云端会话生效,不改动本机配置。
  • 能看到哪些权限、能否修改,由服务方的实际授权决定。

常见问题

需要把 GitHub token 填进来吗?

不需要。所有连接器都通过浏览器授权。

GitHub 或 Gmail 显示「授权已失效」怎么办?

通常是在服务方撤销了授权。点行内的「重新连接」即可,Gmail 沿用之前的档位。

断开 GitHub 会删掉我的项目吗?

不会。云端环境里的文件会保留,只是无法再拉取代码、推送分支或创建 PR。

Agent 会不经我同意就发邮件吗?

不会。无论档位和权限开关如何,发信前都会在会话里请你确认。

相关