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

# 把 Open Study 连接到 Codex

> 在对话里整理视频、查找资料，与网站使用同一份云端资料库。

连接 AI 后，你可以在 Codex 中发送公开 B 站链接，或查询已经保存在 Open Study 云端资料库中的内容。

## 连接以后，你可以直接这样说

* “用 Open Study 整理这个视频。”
* “在我的资料库找与这个主题相关的视频。”
* “根据这份字幕给我三个实践步骤，并保留原话时间点。”

不需要在对话里手动查看积分、反复查询任务或搬运整段字幕。正常情况下，Codex 会等待 Open Study 返回结果，再回答你的问题。

## 网页和 Codex 为什么能看到同一份资料

```mermaid theme={null}
flowchart TD
  A[Open Study 网页] --> C[同一账号的云端资料库]
  B[Codex 插件] --> C
  C --> D[网页阅读资料]
  C --> E[Codex 查询与回答]
```

两边必须使用**同一个 Open Study 账号**。安装插件不会上传旧版 BiliStudy 的本地数据库，也不会把另一个账号的资料合并过来。

## 插件、Skill 和 MCP 分别是什么

<Steps>
  <Step title="插件告诉 Codex 什么时候使用 Open Study">
    Skill 负责识别“整理这个链接”“查找我的资料”等请求，并约束回答方式。
  </Step>

  <Step title="远程连接把请求交给 Open Study">
    MCP 是 Codex 与 Open Study 云端服务之间的连接方式。插件不会在你的电脑上再安装一套后端。
  </Step>

  <Step title="网站账号决定你能看到什么">
    首次连接时，在 Open Study 网页登录并允许连接。这个登录授权过程也叫 OAuth。
  </Step>
</Steps>

<Accordion title="需要手动配置时：产品 MCP 地址">
  普通插件安装会带好这个地址，不需要再添加一份相同连接：

  ```text theme={null}
  https://study.faroapi.cn/mcp
  ```

  文档站的搜索和文档 MCP 只能查使用说明，**不是**上面这个会整理视频、读取你资料库的产品连接。
</Accordion>

## 授权时会看到什么

首次连接时，Codex 可能打开 Open Study 的授权页。页面会说明应用请求的权限，例如：

* 读取你的学习资料；
* 代你整理资料。

确认是 Open Study 正式域名并看懂权限后，选择 **允许连接**。不想继续时选择 **拒绝并返回**。

## 从哪个客户端开始

当前文档提供 **Codex** 的安装、账号连接与使用步骤。更新方式取决于原安装来源；离线包尚无已验证的一键升级流程，详见[更新说明](/connect-ai/update-troubleshoot)。

其他兼容 MCP 的客户端可能需要不同的安装和授权方式。这版教程不承诺 Claude Code、Cursor 等客户端已经完成同样的使用验证。

## 需要把密码或密钥发给 AI 吗

不需要。插件发布包只包含操作说明和连接地址，不包含你的密码、B 站 Cookie、上游服务密钥或云端数据库。连接账号时使用网页授权，登录凭据由客户端的连接机制管理，不要粘贴到聊天里。

## 怎样知道连上了

新建 Codex 任务后，让它检查 Open Study 连接并查询已有资料。确认它实际调用了 Open Study 的连接检查和资料库查询，并成功收到结果。结果可以是当前账号的资料，也可以是空资料库。

只口头回复“已连接”或“资料库为空”，却没有成功调用，不算完成检查；真实查询返回空列表才是正常的空资料库结果。

如果还提示未连接，先看[连接问题的处理步骤](/connect-ai/update-troubleshoot)。

<CardGroup cols={2}>
  <Card title="安装 Codex 插件" icon="download" href="/connect-ai/install-codex">
    优先使用网站提供的离线包，或在有权限时从 GitHub 安装。
  </Card>

  <Card title="第一次发送链接" icon="message-square" href="/connect-ai/use-codex">
    新建任务并完成一次真实的整理或资料查询。
  </Card>
</CardGroup>