连接与集成
连接让 AI 队友使用知是以外的服务,例如你的邮箱和飞书、项目的 GitHub 仓库,以及 Notion 这类服务。项目连接 Notion 之后,芝士可以读取团队在 Notion 里的组会安排。
个人连接与项目连接#
连接分两种,区别在于用谁的账号、由谁管理。
| 个人连接 | 项目连接 | |
|---|---|---|
| 包括 | 邮箱、飞书 | GitHub、Notion |
| 管理入口 | 个人设置 | 项目设置 |
| 账号 | 你自己的 | 授权人的 |
| 用于 | 你勾选的项目 | 这个项目 |
邮箱与飞书#
点左下角的头像,选「设置」,再点「连接」。在这里接入自己的邮箱或飞书,并选择允许哪些项目的 AI 队友使用。AI 队友以你的账号读邮件、写草稿、读写飞书文档。这些账号只有你自己能管理。
- 「接入邮箱」:选「邮箱服务」,填「邮箱地址」和「密码或授权码」,点「测试并保存」。
- 「连接飞书」:跳到飞书的授权页,用你的飞书账号授权。平台还没配置飞书应用时,这个按钮是灰色的,下方写着「管理员还没配置飞书应用」。
QQ、163 等邮箱要先在邮箱的设置里开启 IMAP/SMTP,即允许其他程序收发这个邮箱的邮件,再生成授权码填进来。Gmail 填应用专用密码。
接入后,每个账号是「已接入的账号」中的一行,右侧是状态:「正常」「授权已失效」「无法连接」或「异常」。在这一行的「允许这些项目的 AI 队友使用」中勾选项目。只有勾选的项目里,AI 队友能使用这个账号。
芝士写的邮件由你发送
芝士写的邮件只放进你邮箱的草稿箱,同时列在「连接」页的「待发送的邮件」里。每封写明收件人、主题、正文、附件和来自哪个项目。点「发送」并确认后才发出,发出后无法撤回;不发送时点「丢弃」。
邮件的附件只能是频道里的文件。起草之后附件有改动时,平台拒绝发送这封邮件。
GitHub#
新建项目时「代码仓库」选「连接 GitHub」的项目,要在「项目设置 → 仓库与署名」中连接一个 GitHub 仓库。连接之后,芝士的提交和 PR(请求把改动合入仓库的申请)都在这个仓库里。连接由项目所有者或团队管理员完成,步骤见连接 GitHub 仓库。
同一页的「连接 GitHub 账号」连接你自己的 GitHub 账号,用于识别你的提交署名,并以你的身份创建 PR。这个账号与登录知是用的 GitHub 授权相互独立,可以是不同的账号。
MCP 服务器#
MCP 是一种让 AI 调用外部服务的通用接口。Notion 等服务提供自己的 MCP 服务器地址;项目声明并连接之后,AI 队友就能使用这些服务的功能,例如搜索和读取 Notion 页面。
声明:项目里的 .mcp.json
项目要用哪些 MCP 服务器,写在项目文件最外层的 .mcp.json 里。这个文件一般交给芝士添加,例如:
{
"mcpServers": {
"notion": { "type": "http", "url": "https://mcp.notion.com/mcp" }
}
}芝士添加之后,采纳这次交付,服务器才会出现在「项目设置 → MCP 服务器」中:平台只读取项目已采纳的版本。带 command 的条目在频道的环境里直接运行,不出现在这一页。
连接
「项目设置 → MCP 服务器」中,每个服务器是一行:名字、地址、「来自项目的 .mcp.json」,以及连接状态。
- 「未连接」:点「连接」,跳到服务自己的授权页,授权后回到这一页。
- 「已连接(由 … 授权,…)」:可以使用。右侧的「断开」取消连接。
- 「需要重新连接」:授权过期或被拒绝,或者
.mcp.json里的地址改了。点「重新连接」。 - 「需要填写 …」:这个服务器用访问密钥授权,不走授权页。在这一行的输入框里填入服务提供的密钥,点「保存」,状态变为「已就绪」。
项目里的任何成员都能连接、断开和填写密钥。连接属于整个项目:之后这个项目里的 AI 队友都以授权人的账号使用这个服务。填过的密钥不再显示,输入框里只写「已填写」。
页面上的提示是「上游服务看到的是授权人的账号,建议用机器人或服务账号授权」。机器人或服务账号是专为程序使用开设的账号,可以只开放项目需要的内容。
连接之后芝士能做什么#
MCP 服务器连接后,项目里每个频道和任务的 AI 队友都能使用它,不需要再设置。还没连接时,芝士回复的支线顶部出现一行灰色提示,例如「notion 需要在项目设置里连接」,芝士也会说明它用不了这个服务。
邮箱和飞书只在你勾选的项目里可用。芝士在那里以你的账号读取和起草,邮件由你发送。
断开与删除#
- MCP 服务器:在「项目设置 → MCP 服务器」中点「断开」。之后 AI 队友不能使用这个服务,直到有人重新连接。
- 邮箱和飞书:在「个人设置 → 连接」中点这个账号的「删除」。删除后 AI 队友不能再使用这个账号,保存的密码或密钥同时删除。只想停用某个项目时,在「允许这些项目的 AI 队友使用」中去掉这个项目。
- GitHub 账号:在「项目设置 → 仓库与署名」中点「断开」。
接下来#
docs/manual/connections.md