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

# 连接指引：按你用的 Agent 找步骤

> 每个 Agent 软件怎么装 Open Study 插件、去哪里授权。先找到你用的那一个。

Open Study 能接进很多 Agent 软件。每个软件装插件和授权的位置都不一样，这一栏每个软件单独一页。

## 三步接上

1. **装插件**（这一步写给人看）：把下面这段话发给你的 Agent，它会找到这一栏里你那个软件的一页，照着帮你装。也可以登录网站，在左侧 **快速开始** 选中你的软件复制提示词，那里还附带插件文件。

   请帮我安装并连接 Open Study 的 Skill 和 MCP，用来整理视频和帖子、查询资料库。先读连接指引：[https://docs.study.faroapi.cn/connect/overview.md](https://docs.study.faroapi.cn/connect/overview.md) ，认出你所在的客户端（我另外指定的以我说的为准），再读那个软件的一页照着装。装完由你发起授权，拿到授权链接后用默认浏览器帮我打开并发给我；网页登录和「允许连接」由我本人点。已有任务时，另给我一段能接着做的提示词。装完提醒我完全退出并重开软件，我新开对话发一条视频链接测试。

   请帮我安装并连接 Open Study 的 Skill 和 MCP，用来整理视频和帖子、查询资料库。先读连接指引：[https://docs.study.faroapi.cn/connect/overview.md](https://docs.study.faroapi.cn/connect/overview.md) ，认出你所在的客户端（我另外指定的以我说的为准），再读那个软件的一页照着装。装完由你发起授权，拿到授权链接后用默认浏览器帮我打开并发给我；网页登录和「允许连接」由我本人点。已有任务时，另给我一段能接着做的提示词。装完提醒我完全退出并重开软件，我新开对话发一条视频链接测试。

2. **授权**：装完会显示需要授权。在软件里点一下授权，浏览器会打开 Open Study 登录页，登录后点 **允许连接**。每个软件授权的位置不同，见下面各页。

3. **试用**：完全退出并重开软件，新开对话，发那一页「确认能用」里的那句话。查到资料或提示资料库为空，就可以按[第一次使用](https://docs.study.faroapi.cn/connect-ai/use-codex.md)说出你要做的事了。

> [!NOTE]
>
> 授权必须在你自己的软件里完成：登录凭证存在你的软件里，网站没法替你点。浏览器里的 **允许连接** 也只能你本人点。

## 找到你的软件

### 常用

| 软件 | 怎么装 | 去哪里授权 |
| - | - | - |
| [Claude Code 桌面端](https://docs.study.faroapi.cn/connect/claude-desktop.md) | 上传 `.plugin` 文件 | 插件页里授权 |
| [Claude Code CLI](https://docs.study.faroapi.cn/connect/claude-code.md) | 两行命令 | 会话里输入 `/mcp` |
| [Codex CLI / 桌面端](https://docs.study.faroapi.cn/connect/codex.md) | 两条命令 | 桌面端 **设置 → 插件 → MCP** 点 **进行身份验证**；没反应就运行 `codex mcp login open-study` |
| [ZCode](https://docs.study.faroapi.cn/connect/zcode.md) | 插件市场添加 GitHub 仓库 | **设置 → MCP 服务器** 点 **打开授权** |
| [Pi](https://docs.study.faroapi.cn/connect/pi.md) | 先装 pi-mcp-adapter | 输入 `/mcp-auth open-study` |

### 命令行

| 软件 | 怎么装 | 去哪里授权 |
| - | - | - |
| [Gemini CLI](https://docs.study.faroapi.cn/connect/gemini-cli.md) | Gemini 兼容包 + `gemini extensions install` | 自动弹浏览器，或 `/mcp auth open-study` |
| [OpenCode](https://docs.study.faroapi.cn/connect/opencode.md) | 复制 Skill + `opencode.json` | `opencode mcp auth open-study` |
| [Qwen Code](https://docs.study.faroapi.cn/connect/qwen-code.md) | `qwen extensions install` | 自动弹浏览器，或 `/mcp` 里点 **Authenticate** |
| [Kimi Code CLI](https://docs.study.faroapi.cn/connect/kimi-cli.md) | `/mcp-config` + 复制 Skill | `/mcp-config login open-study` |
| [DeepSeek Harness](https://docs.study.faroapi.cn/connect/deepseek.md) | 补丁里写请求头密钥 | 不用网页授权，网站 **开发者密钥** 建一把完整访问的 |
| [Goose](https://docs.study.faroapi.cn/connect/goose.md) | **Extensions** 添加远程扩展 | 连接时自动弹浏览器 |
| [Cursor CLI](https://docs.study.faroapi.cn/connect/cursor-cli.md) | 和编辑器共用 `mcp.json` | `agent mcp login open-study` |
| [Amp](https://docs.study.faroapi.cn/connect/amp.md) | `amp mcp add` | 启动时自动弹浏览器 |
| [Crush](https://docs.study.faroapi.cn/connect/crush.md) | `crushrc` 里加连接，打开 `oauth` | 启动后按回车打开浏览器 |
| [Qoder CLI](https://docs.study.faroapi.cn/connect/qoder.md) | `qoder mcp add` | 首次使用按提示授权 |
| [Grok Build](https://docs.study.faroapi.cn/connect/grok-build.md) | `grok mcp add` | 首次使用自动弹浏览器，或 `/mcps` 里按 `i` |
| [Warp](https://docs.study.faroapi.cn/connect/warp.md) | **Settings → Agents → MCP servers** | 点 **Start** |

### 编辑器与 IDE

| 软件 | 怎么装 | 去哪里授权 |
| - | - | - |
| [Cursor](https://docs.study.faroapi.cn/connect/cursor.md) | 复制 Skill + `mcp.json` | **Customize** 里 open-study 点 **Connect** |
| [Cline](https://docs.study.faroapi.cn/connect/cline.md) | 复制 Skill + **Remote Servers** | 服务卡片点 **Authenticate** |
| [Devin Desktop（原 Windsurf）](https://docs.study.faroapi.cn/connect/windsurf.md) | `devin mcp add` | `devin mcp login open-study` 或 **Authenticate** |
| [Trae IDE](https://docs.study.faroapi.cn/connect/trae.md) | 设置里 **MCP → Add Manually** | 官方未写网页授权，可能连不上 |
| [Kilo Code](https://docs.study.faroapi.cn/connect/kilo-code.md) | **Settings → MCP → Add Server** | 点弹出的授权通知 |
| [Continue](https://docs.study.faroapi.cn/connect/continue.md) | `config.yaml` 加一条 | 首次连接按提示授权 |
| [Zed](https://docs.study.faroapi.cn/connect/zed.md) | **Settings → AI → MCP Servers** | 自动提示，点 **Authenticate** |
| [Antigravity IDE](https://docs.study.faroapi.cn/connect/antigravity.md) | Antigravity 兼容包 | **Customizations** 里点 **Authenticate** |

### 桌面与聊天

| 软件 | 怎么装 | 去哪里授权 |
| - | - | - |
| [Cherry Studio](https://docs.study.faroapi.cn/connect/cherry-studio.md) | 设置里添加 MCP 服务器 | 保存启用后浏览器登录 |
| [OpenClaw](https://docs.study.faroapi.cn/connect/openclaw.md) | 加入时写明 `auth: oauth` | `openclaw mcp login open-study` |
| [Hermes Agent](https://docs.study.faroapi.cn/connect/hermes.md) | `config.yaml` 写明 `auth: oauth` | 首次连接自动弹，或 `hermes mcp login open-study` |

### 已停止服务

| 软件 | 怎么装 | 去哪里授权 |
| - | - | - |
| [iFlow CLI](https://docs.study.faroapi.cn/connect/iflow-cli.md) | 已停止服务 | 建议换用其他软件 |
| [Roo Code](https://docs.study.faroapi.cn/connect/roo-code.md) | 已停止服务 | 建议换用 Kilo Code 或 Cline |

## 授权按钮叫什么

各软件里授权按钮的名字不一样，常见的有 **打开授权**、**Authenticate**、**Login**、**Connect**、**Sign in**，或者状态显示为「需要授权」「Needs authentication」。找不到时，看这个软件官方说明里「远程 MCP」或「OAuth」那一节。

## 列表里没有你的软件

只要它支持远程 MCP（Streamable HTTP）和网页授权（OAuth），一般都能连：

1. 在它的 MCP 设置里加一个远程服务器，名称填 `open-study`，地址填 `https://study.faroapi.cn/mcp`。
2. 它支持 Skill 的话，下载 **快速开始** 页下方离线包里的 **标准插件**，把 `skills/open-study` 整个目录放进它读 Skill 的目录。
3. 按它的提示授权，浏览器里登录 Open Study，点 **允许连接**。

每一页都有同名的纯文本版，给 AI 读更省事，例如 [https://docs.study.faroapi.cn/connect/zcode.md](https://docs.study.faroapi.cn/connect/zcode.md) 。代装时要守的规矩见[代装 Agent 须知](https://docs.study.faroapi.cn/connect-ai/agent-setup.md)。试过还是不行，[告诉我们](https://docs.study.faroapi.cn/help/contact.md)你在用哪个软件。

## 还是连不上

见[插件更新与连接问题](https://docs.study.faroapi.cn/connect-ai/update-troubleshoot.md)。


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