> ## 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.

# 在 ZCode 里连接 Open Study

> 在 ZCode 的插件市场装上 Open Study，再到 MCP 服务器页点一次「打开授权」。

ZCode 能直接安装 Claude Code 格式的插件。装好之后还要你亲手点一次 **打开授权**：ZCode 不会自动发起授权，也没有给 AI 用的授权命令，这一步不点，Open Study 会一直显示「需要授权」。

## 安装插件

**1. 打开插件市场**

进入 **设置 → 插件**。插件页要先打开任意一个工作区才能用；提示「打开一个工作区以管理插件」时，先随便打开一个项目。

**2. 添加 Open Study 的插件市场**

点右上角 **创建 → 添加插件市场**，来源选 GitHub 仓库，填下面这一串：

```text theme={null}
moonlight-code-space/open-study
```

**3. 安装**

添加成功后，在 **个人** 分段找到 **Open Study**，点 **安装**。状态变成「已安装」就好了，新装的插件默认启用。

> **连不上 GitHub 时**
>
> 只在第一次安装、又连不上 GitHub 时用；已经从 GitHub 装过的，保留原来的来源。
>
> 登录网站，打开左侧 **快速开始**，在页面下方 **离线包** 里下载 **Codex 插件**（ZCode 也用它），解压到一个固定目录，不要放在下载文件夹或临时目录。回到 **创建 → 添加插件市场**，选本地的市场清单目录，指向解压出来的 `open-study-codex-marketplace-v版本号` 文件夹（里面有 `.claude-plugin`）。

## 授权

**1. 找到 open-study**

进入 **设置 → MCP 服务器**。插件带来的服务在 **Plugin MCP 服务器** 那一组，open-study 那一行会显示「需要授权」。

**2. 点「打开授权」**

ZCode 会用系统浏览器打开 Open Study 的授权页。登录你的 Open Study 账号，点 **允许连接**。

**3. 回到 ZCode**

ZCode 会自动重连并加载 Open Study 的工具。新开一个对话再用。

还没有 Open Study 账号，先到 [study.faroapi.cn](https://study.faroapi.cn) 注册。密码只填在网站的授权页，不用发给 Agent。

## 也可以让 AI 带你装

这一节写给人看：登录网站，打开左侧 **快速开始**，点 **ZCode** 那张卡片，在 **提示词** 页签复制安装提示词，到 ZCode 里新开一个对话发过去。它会读这一页，一步步告诉你在界面上点哪里。插件市场和「打开授权」都要你自己点。

## 确认能用

新开一个对话，把这段发过去：

请使用 Open Study 查询我的资料库，列出最多三条资料标题和内容 ID。没有资料就说明为空；还没连上就告诉我下一步。只查询已有资料，不整理新视频。

请使用 Open Study 查询我的资料库，列出最多三条资料标题和内容 ID。没有资料就说明为空；还没连上就告诉我下一步。只查询已有资料，不整理新视频。

收到资料列表或「资料库为空」，就说明连上了。之后直接把视频链接发给它，说明你想做什么。

## 只想连上工具

不装插件、只加连接也可以，但拿不到 Open Study 的使用说明（Skill），AI 不知道什么时候该用它。

1. 进入 **设置 → MCP 服务器**，点右上角 **新建 MCP 服务器**。
2. 类型选 HTTP，名称填 `open-study`，地址填 `https://study.faroapi.cn/mcp`，点 **添加**。
3. 回到列表，这一行显示「需要授权」时点 **打开授权**，按上面的授权步骤完成。

## 更新

插件有新版本时，在 **设置 → 插件** 点 Open Study 打开详情页，底部有更新入口；也可以在 **管理已安装** 里点 **检查更新**。更新后 ZCode 会自动刷新受影响的会话。GitHub 上的版本有时比网站上显示的晚，这是正常的：保留 GitHub 来源，不要为了追版本换成本地下载的文件。

## 遇到问题

* **一直显示「需要授权」**：确认点过 **打开授权**，并在浏览器里点了 **允许连接**。新建会话时授权没完成，ZCode 只会把这一个服务标成失败，不影响别的。
* **换了服务地址或授权范围**：要重新授权一次。
* **其他情况**：见[插件更新与连接问题](https://docs.study.faroapi.cn/connect-ai/update-troubleshoot.md)。
* **ZCode 官方说明**：[插件](https://zcode.z.ai/cn/docs/plugin)、[MCP](https://zcode.z.ai/cn/docs/mcp-services)。


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