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

# 在 Gemini CLI 里连接 Open Study

> 用 Gemini 兼容包安装扩展；需要授权时 Gemini CLI 会自动打开浏览器，也可以输入 /mcp auth open-study。

Gemini CLI 用扩展安装 Open Study，扩展里同时带着使用说明（Skill）和连接。

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

## 安装

1. 登录网站，打开左侧 **快速开始**，在页面下方下载 **Gemini 兼容包**，解压到一个固定目录。解压后的目录根应该有 `gemini-extension.json` 和 `skills/`。
2. 在终端运行 `gemini extensions install <解压目录>`。
3. 重启 Gemini CLI，输入 `/extensions` 和 `/skills` 确认扩展和 Skill 都在。

## 授权

1. 第一次用到 Open Study 时，Gemini CLI 会自动打开浏览器的授权页。
2. 没弹出来就输入 `/mcp auth open-study`。
3. 浏览器里登录 Open Study，点 **允许连接**，再回到 Gemini CLI。

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

## 也可以让 AI 带你装

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

## 确认能用

退出当前会话重新启动 Gemini CLI，把这段发过去：

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

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

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

## 更新

网站 **快速开始** 出现新版本时，下载新的 **Gemini 兼容包**，解压后整个替换原来那个固定目录，再运行 `gemini extensions update open-study`。连接地址不变；提示需要授权时，按上面「授权」一节再做一次。更新后退出当前会话重新启动 Gemini CLI。

## 遇到问题

* **只想连上工具**：也可以运行 `gemini mcp add -s user -t http open-study https://study.faroapi.cn/mcp`。`-s user` 让它对所有项目生效，这条路没有 Skill。
* **一直显示需要授权**：确认在 Gemini CLI 里完成了授权那一步，并在浏览器里点了 **允许连接**。
* **其他情况**：见[插件更新与连接问题](https://docs.study.faroapi.cn/connect-ai/update-troubleshoot.md)。
* **Gemini CLI 官方说明**：[Gemini CLI 的 MCP](https://github.com/google-gemini/gemini-cli/blob/main/docs/tools/mcp-server.md)、[Gemini CLI 扩展](https://geminicli.com/docs/extensions/reference/)。


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