> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 连接器：GitHub、Gmail 与其他应用

> 连接器让云端会话以你的身份访问 GitHub、Gmail 等服务。本页说明连接、Gmail 权限档位、授权失效与重新连接、发信确认、访问权限管理和断开。

**连接器**是你授权给 AIHubMix Cloud 的第三方账号。连接后，云端会话可以以你的身份读写这些服务，例如拉取 GitHub 仓库、搜索 Gmail。授权在浏览器中完成，不需要填写 token。

连接器只管「账号」；Agent 的能力扩展（插件、MCP、Skills）在[插件 / MCP / Skills](https://docs.aihubmix.com/cn/cloud/integrations/plugins-mcp-skills.md)里管理。

## 适用范围

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

## 入口

* 「设置 › 集成 › 连接器」。
* 新建项目选「从 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 账号。

| 档位 | Agent 能做什么 |
| - | - |
| 读取并发送邮件（默认） | 搜索、阅读邮件，也可以代你发信 |
| 仅发送邮件 | 只能代你发信，不能搜索或阅读邮件 |

* **更改权限**：在 Gmail 管理页点「更改授权范围」，选择新档位后点「前往 Google 授权」。
* **重新连接**：授权失效时点「重新连接」，沿用当前档位。
* 如果你选了「读取并发送邮件」，但在 Google 授权页面没有勾选读取权限，Gmail 行会显示「仅发送」，Agent 暂时不能读取邮件。点「更改授权范围」重新授权并勾选读取权限即可。

### 发信前确认

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

## 连接器管理与访问权限

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

### 访问权限

访问权限列表来自该账号在服务方的实际授权，不同应用、不同账号看到的项目不同。

* 已授权的权限可以用开关停用或启用；保存成功后才生效。关闭某项权限后，会话调用该能力时会被拦下。
* 灰色不可切换的项，是此账号未授予、不可修改，或需要重新连接的权限。要扩大授权范围需要重新授权。
* 保存失败或读取授权信息失败时，点「重新读取」后再试。

### 断开连接

1. 在管理页点「断开连接」。
2. 在确认弹窗里点「断开连接」。断开后云端任务将无法再访问此应用，之后可以随时重新连接。

断开失败时连接仍然保留，点「重新读取」后再试。

## 注意与限制

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

## 常见问题

### 需要把 GitHub token 填进来吗？

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

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

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

### 断开 GitHub 会删掉我的项目吗？

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

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

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

## 相关

* [插件 / MCP / Skills](https://docs.aihubmix.com/cn/cloud/integrations/plugins-mcp-skills.md)
* [用户介入](https://docs.aihubmix.com/cn/cloud/sessions/user-intervention.md)
* [项目](https://docs.aihubmix.com/cn/cloud/projects/projects.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.