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

# 连接与集成 {#connections}

连接让 AI 队友使用知是以外的服务，例如你的邮箱和飞书、项目的 GitHub 仓库，以及 Notion 这类服务。项目连接 Notion 之后，芝士可以读取团队在 Notion 里的组会安排。

## 个人连接与项目连接 {#kinds}

连接分两种，区别在于用谁的账号、由谁管理。

| | 个人连接 | 项目连接 |
|---|---|---|
| 包括 | 邮箱、飞书 | GitHub、Notion |
| 管理入口 | 个人设置 | 项目设置 |
| 账号 | 你自己的 | 授权人的 |
| 用于 | 你勾选的项目 | 这个项目 |

## 邮箱与飞书 {#mail-feishu}

点左下角的头像，选「设置」，再点「连接」。在这里接入自己的邮箱或飞书，并选择允许哪些项目的 AI 队友使用。AI 队友以你的账号读邮件、写草稿、读写飞书文档。这些账号只有你自己能管理。

- 「接入邮箱」：选「邮箱服务」，填「邮箱地址」和「密码或授权码」，点「测试并保存」。
- 「连接飞书」：跳到飞书的授权页，用你的飞书账号授权。平台还没配置飞书应用时，这个按钮是灰色的，下方写着「管理员还没配置飞书应用」。

QQ、163 等邮箱要先在邮箱的设置里开启 IMAP/SMTP，即允许其他程序收发这个邮箱的邮件，再生成授权码填进来。Gmail 填应用专用密码。

接入后，每个账号是「已接入的账号」中的一行，右侧是状态：「正常」「授权已失效」「无法连接」或「异常」。在这一行的「允许这些项目的 AI 队友使用」中勾选项目。只有勾选的项目里，AI 队友能使用这个账号。

### 芝士写的邮件由你发送 {#mail-drafts}

芝士写的邮件只放进你邮箱的草稿箱，同时列在「连接」页的「待发送的邮件」里。每封写明收件人、主题、正文、附件和来自哪个项目。点「发送」并确认后才发出，发出后无法撤回；不发送时点「丢弃」。

邮件的附件只能是频道里的文件。起草之后附件有改动时，平台拒绝发送这封邮件。

## GitHub {#github}

新建项目时「代码仓库」选「连接 GitHub」的项目，要在「项目设置 → 仓库与署名」中连接一个 GitHub 仓库。连接之后，芝士的提交和 PR（请求把改动合入仓库的申请）都在这个仓库里。连接由项目所有者或团队管理员完成，步骤见[连接 GitHub 仓库](https://docs.okcheese.com/projects#upstream)。

同一页的「连接 GitHub 账号」连接你自己的 GitHub 账号，用于识别你的提交署名，并以你的身份创建 PR。这个账号与登录知是用的 GitHub 授权相互独立，可以是不同的账号。

## MCP 服务器 {#mcp}

MCP 是一种让 AI 调用外部服务的通用接口。Notion 等服务提供自己的 MCP 服务器地址；项目声明并连接之后，AI 队友就能使用这些服务的功能，例如搜索和读取 Notion 页面。

### 声明：项目里的 .mcp.json {#mcp-json}

项目要用哪些 MCP 服务器，写在项目文件最外层的 `.mcp.json` 里。这个文件一般交给芝士添加，例如：

```json
{
  "mcpServers": {
    "notion": { "type": "http", "url": "https://mcp.notion.com/mcp" }
  }
}
```

芝士添加之后，采纳这次交付，服务器才会出现在「项目设置 → MCP 服务器」中：平台只读取项目已采纳的版本。带 `command` 的条目在频道的环境里直接运行，不出现在这一页。

### 连接 {#mcp-connect}

「项目设置 → MCP 服务器」中，每个服务器是一行：名字、地址、「来自项目的 .mcp.json」，以及连接状态。


**连接 notion**（网页上是一段几秒的演示画面，播完停在结果上；这里是文字版。在 Notion 的授权页上授权后回到这一页，这一行写明由谁授权。）

- 页头：MCP 服务器
- 一行「notion」：mcp.notion.com · 来自项目的 .mcp.json，「未连接」，按钮「连接」
- 点「连接」
- 一行「notion」：mcp.notion.com · 来自项目的 .mcp.json，「已连接（由 @lin 授权，刚刚）」


- 「未连接」：点「连接」，跳到服务自己的授权页，授权后回到这一页。
- 「已连接（由 … 授权，…）」：可以使用。右侧的「断开」取消连接。
- 「需要重新连接」：授权过期或被拒绝，或者 `.mcp.json` 里的地址改了。点「重新连接」。
- 「需要填写 …」：这个服务器用访问密钥授权，不走授权页。在这一行的输入框里填入服务提供的密钥，点「保存」，状态变为「已就绪」。

项目里的任何成员都能连接、断开和填写密钥。连接属于整个项目：之后这个项目里的 AI 队友都以授权人的账号使用这个服务。填过的密钥不再显示，输入框里只写「已填写」。

页面上的提示是「上游服务看到的是授权人的账号，建议用机器人或服务账号授权」。机器人或服务账号是专为程序使用开设的账号，可以只开放项目需要的内容。

## 连接之后芝士能做什么 {#after-connect}

MCP 服务器连接后，项目里每个频道和任务的 AI 队友都能使用它，不需要再设置。还没连接时，芝士回复的支线顶部出现一行灰色提示，例如「notion 需要在项目设置里连接」，芝士也会说明它用不了这个服务。

邮箱和飞书只在你勾选的项目里可用。芝士在那里以你的账号读取和起草，邮件由你发送。

## 断开与删除 {#disconnect}

- MCP 服务器：在「项目设置 → MCP 服务器」中点「断开」。之后 AI 队友不能使用这个服务，直到有人重新连接。
- 邮箱和飞书：在「个人设置 → 连接」中点这个账号的「删除」。删除后 AI 队友不能再使用这个账号，保存的密码或密钥同时删除。只想停用某个项目时，在「允许这些项目的 AI 队友使用」中去掉这个项目。
- GitHub 账号：在「项目设置 → 仓库与署名」中点「断开」。

## 接下来 {#next}

- [把外部服务连给芝士](https://docs.okcheese.com/connect-a-service#connect-a-service)：以 Notion 为例，从声明、连接到让芝士读页面。
- [技能](https://docs.okcheese.com/skills#skills)：把项目里常做的事保存成芝士按步骤执行的做法。
- [连接 GitHub 仓库](https://docs.okcheese.com/projects#upstream)：把项目接到一个 GitHub 仓库的步骤。