跳转到主要内容
Pi 本身不带 MCP，要先装社区的 pi-mcp-adapter 扩展，再把 Open Study 加进它的配置，最后在 Pi 里授权一次。
这一页按 Pi 和 pi-mcp-adapter 的官方说明整理，我们还没有逐步实测。和你看到的不一致时，以官方说明为准，也欢迎告诉我们。

​
安装

1

装 MCP 扩展

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

加入 Open Study

打开 ~/.config/mcp/mcp.json，没有就新建。在 mcpServers 里合并下面这一条，不要覆盖已有的其他服务：
也可以在 Pi 里输入 /mcp setup，按提示新建配置。
3

装上使用说明（Skill）

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

​
授权

三步都做完后重启 Pi，输入：
浏览器会打开 Open Study 的授权页，登录后点 允许连接。也可以输入 /mcp 打开面板，选中 open-study 按回车。 让 AI 代为授权：Pi 里的 AI 可以用 mcp 工具的 auth-start 拿到授权链接，替你打开浏览器或把链接发给你；你登录后点 允许连接 即可。 Pi 跑在远程服务器上时，/mcp-auth 会先显示授权网址：在你自己电脑的浏览器里打开并允许。浏览器打不开 localhost 的回调页时，把地址栏里的完整网址复制回 Pi。 还没有 Open Study 账号，先到 study.faroapi.cn 注册。密码只填在网站的授权页，不用发给 Agent。

​
也可以让 AI 带你装

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

​
确认能用

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

请使用 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 说明。
  • 其他情况：见插件更新与连接问题。
  • 官方说明：Pi、pi-mcp-adapter。