跳转到主要内容
OpenCode 的连接写在 opencode.json 的 mcp 字段里,和别的软件常见的 mcpServers 写法不一样。它默认就支持网页授权。
这一页按 OpenCode 的官方说明整理,我们还没有逐步实测。和你看到的界面不一致时,以官方说明为准,也欢迎告诉我们。

安装

  1. 登录网站,打开左侧 快速开始,在页面下方下载 标准插件 包并解压到一个固定目录。
  2. 把包里 skills/open-study 整个目录复制到 ~/.config/opencode/skills/open-study(~/.agents/skills/ 也能被读到)。
  3. 在 ~/.config/opencode/opencode.json 的 mcp 里合并下面这一条,不要覆盖已有的其他服务;也可以运行 opencode mcp add 按提示添加。
配置写法:

授权

  1. 在终端运行 opencode mcp auth open-study,它会打开浏览器。第一次用到 Open Study 时它也会提示你授权。
  2. 浏览器里登录 Open Study,点 允许连接,再回到 OpenCode。
登录要用 Open Study 账号;还没有就先到 study.faroapi.cn 注册。密码只填在网站的授权页,不用发给 Agent。

也可以让 AI 带你装

这一节写给人看:登录网站,打开左侧 快速开始,点 OpenCode 那张卡片,在 提示词 页签复制安装提示词,在 OpenCode 里新开一个对话发过去。它会读这一页,能代你做的直接做,要在界面上点的会告诉你点哪里。浏览器里的 允许连接 要你自己点。

确认能用

退出当前会话重新启动 OpenCode,把这段发过去:

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

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

更新

网站 快速开始 出现新版本时,下载新的标准插件包,用里面的 skills/open-study 整个替换旧目录。连接地址不变;提示需要授权时,按上面「授权」一节再做一次。更新后退出当前会话重新启动 OpenCode。

遇到问题