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

# 在 Pi 里连接 Open Study

> 给 Pi 装上 pi-mcp-adapter，加入 Open Study 的连接，再输入 /mcp-auth open-study 授权。

Pi 本身不带 MCP，要先装社区的 [pi-mcp-adapter](https://github.com/nicobailon/pi-mcp-adapter) 扩展，再把 Open Study 加进它的配置，最后在 Pi 里授权一次。

> [!NOTE]
>
> 这一页按 Pi 和 pi-mcp-adapter 的官方说明整理，我们还没有逐步实测。和你看到的不一致时，以官方说明为准，也欢迎[告诉我们](https://docs.study.faroapi.cn/help/contact.md)。

## 安装

**1. 装 MCP 扩展**

在终端运行：

```bash theme={null}
pi install npm:pi-mcp-adapter
```

先别重启，下面两步做完再一起重启：中途重启会打断正在帮你装的 AI。

**2. 加入 Open Study**

打开 `~/.config/mcp/mcp.json`，没有就新建。在 `mcpServers` 里合并下面这一条，不要覆盖已有的其他服务：

```json theme={null}
{
  "mcpServers": {
    "open-study": {
      "url": "https://study.faroapi.cn/mcp",
      "auth": "oauth"
    }
  }
}
```

也可以在 Pi 里输入 `/mcp setup`，按提示新建配置。

**3. 装上使用说明（Skill）**

登录网站，打开左侧 **快速开始**，在页面下方下载 **标准插件** 包。解压后把 `skills/open-study` 整个目录复制到 `~/.agents/skills/open-study`。Pi 会从这里读取 Skill，知道什么时候该用 Open Study。

## 授权

三步都做完后重启 Pi，输入：

```text theme={null}
/mcp-auth open-study
```

浏览器会打开 Open Study 的授权页，登录后点 **允许连接**。也可以输入 `/mcp` 打开面板，选中 open-study 按回车。

**让 AI 代为授权**：Pi 里的 AI 可以用 mcp 工具的 `auth-start` 拿到授权链接，替你打开浏览器或把链接发给你；你登录后点 **允许连接** 即可。

Pi 跑在远程服务器上时，`/mcp-auth` 会先显示授权网址：在你自己电脑的浏览器里打开并允许。浏览器打不开 localhost 的回调页时，把地址栏里的完整网址复制回 Pi。

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

## 也可以让 AI 带你装

这一节写给人看：登录网站，打开左侧 **快速开始**，点 **Pi** 那张卡片，在 **提示词** 页签复制安装提示词，在 Pi 里发过去。它会读这一页，替你装扩展、改配置、复制 Skill。授权那一下要你自己在 Pi 里输入命令，再在浏览器里点。

## 确认能用

授权完成后，在 Pi 里把这段发过去：

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

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

收到资料列表或「资料库为空」，就说明连上了。

## 更新

网站 **快速开始** 出现新版本时，下载新的标准插件包，用里面的 `skills/open-study` 整个替换 `~/.agents/skills/open-study`。连接地址不变；提示需要授权时，按上面「授权」一节再做一次。更新后重启 Pi。

## 遇到问题

* **`/mcp` 里看不到 open-study**：检查 `mcp.json` 是不是合法的 JSON、条目名是不是 `open-study`，改完输入 `/reload`。
* **授权时提示凭证存储不可用**：没有图形界面的 Linux 需要可用的系统密钥环，见 pi-mcp-adapter 的 OAuth 说明。
* **其他情况**：见[插件更新与连接问题](https://docs.study.faroapi.cn/connect-ai/update-troubleshoot.md)。
* **官方说明**：[Pi](https://github.com/badlogic/pi-mono)、[pi-mcp-adapter](https://github.com/nicobailon/pi-mcp-adapter)。


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