MCP 是开放标准，任何支持它的客户端都能与 Frolick 协作。教师不需要代码编辑器：直接把 Frolick 接入浏览器或手机上的聊天助手即可。
通过 URL 几次点击即可连接——无需安装、无需令牌。适用于网页端、桌面端和移动应用。
经典场景：编辑器里的助手创建游戏和内容集，你专注于课程材料。
终端代理与脚本：批量导入内容集、按计划生成游戏、自动化日常工作。
列表并不完整：任何支持 Model Context Protocol 的客户端都可以——通过 URL 远程连接，或使用本地 stdio 服务器。
MCP（Model Context Protocol，模型上下文协议）是一个开放标准，让 AI 助手能够使用外部工具。Frolick MCP 服务器是公开 API 之上的轻量代理：启动时它获取平台的实时能力清单并自动注册当前工具。助手直接读取并创建你账户中的内容——无需浏览器，无需复制粘贴。
工具来自实时清单：平台的新能力会自动出现，无需更新软件包，也无需重启客户端。
所有内容都在你自己的 Frolick 账户中创建——通过 OAuth 授权或个人访问令牌，两者都由你掌控。
@frolick/mcp 软件包开源且不含业务逻辑——只知道如何调用公开、有文档的 API。
大约三十多个面向教师的工具，外加两个目录资源。部分亮点：
生成七种 Frolick 游戏类型中的任意一种——跳棋、四子棋、Dobble、井字棋、卡片、测验和宾果——内容可直接提供或来自内容集。
创建内容集、添加行、批量填充字段值、一次调用导入结构化数据、复制，并列出兼容的游戏。
创建模板、在棋盘游戏类型之间转换，并通过字段映射关联内容集——一个模板可驱动多个游戏。
创建独立小组件、保存样式预设，并将多个小组件组合成课堂白板——计时器、骰子、记分牌、投票等。
读取你的资料、内容集、模板、游戏、小组件和白板，让助手基于你已有的内容工作。
两个只读资源——游戏目录和小组件类型目录——让助手在创建前了解有效的类型和内容模型。
连接后复制提示词粘贴给助手——或者写你自己的。
通过 URL 与 OAuth 的快速远程接入——或需要完全控制时，使用带令牌的本地 stdio 服务器。
在客户端中填入服务器地址——它会显示授权按钮，你在 frolick.ru 上确认访问即可连接。无需粘贴令牌，令牌自动更新。
https://app.frolick.ru/api/v1/mcp客户端通过 npx 启动 stdio 服务器，并使用你的个人访问令牌调用 API。适合不支持 OAuth 的客户端、CI 和脚本。需要 Node.js 18+。
npx -y @frolick/mcp
选择客户端——几分钟后助手就开始为你搭建课程。
Claude、ChatGPT、Cursor、VS Code、终端——右侧的说明会根据你的选择变化。
例如：“用我第 3 单元的词汇集创建一个卡片游戏”——或者直接使用上面的现成提示词。
打开 claude.ai → 设置 → 连接器（Connectors）。
点击“Add custom connector”，粘贴服务器地址。
点击 Connect，在弹出的 frolick.ru 窗口中确认访问。
在聊天的工具菜单中启用 Frolick 工具，然后让助手搭建课程。
https://app.frolick.ru/api/v1/mcp自定义连接器在 Claude 付费套餐中可用，也支持移动应用。
@frolick/mcp stdio 服务器读取的环境变量。
| 变量 | 默认值 | 用途 |
|---|---|---|
| FROLICK_API_TOKEN | 必填 | 个人访问令牌（pat_…）。所有涉及你账户的操作都需要它。 |
| FROLICK_API_BASE_URL | https://app.frolick.ru | 服务器读取清单并发送调用的 API 源地址。 |
| FROLICK_MCP_TIMEOUT_MS | 15000 | 每个请求的超时时间（毫秒）。 |
| FROLICK_MCP_REFRESH_MS | 300000 | 清单刷新间隔——新工具无需重启即可出现；设为 0 可禁用。 |
| FROLICK_MCP_READONLY | — | 设为 1 则只暴露读取工具，隐藏所有会修改数据的工具。 |
通过 URL 远程连接无需任何配置：授权通过 OAuth 完成，服务器会自行刷新清单。
MCP 免费。你能构建什么取决于你的 Frolick 套餐。
@frolick/mcp 软件包采用 MIT 许可证，免费使用。将其连接到助手不收取额外费用。
你的 Frolick 订阅——Free、Silver 或 Gold——决定可用的游戏、小组件和限制。助手可调用 list_billing_plans 读取当前套餐。
公开读取（如套餐列表和公开模板）以及游戏和小组件目录完全无需授权即可使用。
服务器有意不做的事。
仅暴露面向教师的接口。管理、内部计费、AI、聊天和媒体接口永远无法通过 MCP 访问。
访问以你的身份进行，且仅限你自己的数据。不具备任何提升的或组织级的权限。
可复用模板支持跳棋、四子棋和 Dobble。测验、卡片、宾果和井字棋请直接创建游戏。
部分小组件和功能需要付费套餐。当你的套餐不包含某功能时，工具会返回平台的常规错误。
请求经由标准公开 API，受速率限制。每次调用默认 15 秒后超时（可配置）。
想要更安全？设置 FROLICK_MCP_READONLY=1，本地服务器会隐藏所有会更改数据的工具。
不需要。最简单的方式是把 Frolick 接入聊天助手：Claude.ai（包括移动应用）、Claude Desktop 或开启开发者模式的 ChatGPT。编辑器和终端只是场景之一。
任何 Model Context Protocol 客户端——Claude.ai、Claude Desktop、ChatGPT、Claude Code、Cursor、VS Code、Windsurf、Zed 等。可通过 URL 远程连接，或运行本地 stdio 服务器，任你选择。
远程是带 OAuth 授权的 URL：无需安装，令牌自动更新，访问可在设置中撤销。本地则通过 npx 用个人访问令牌运行服务器——适合 CI、脚本和不支持 OAuth 的客户端。
远程——不需要：客户端直接连接 https://app.frolick.ru/api/v1/mcp。本地服务器只需 Node.js 18+——npx 会按需下载最新的 @frolick/mcp。
服务器仅以你的身份调用 Frolick 公开 API。管理和内部接口无法访问，OAuth 授权可一键撤销，本地服务器还可以以只读模式运行。
会。工具列表来自平台的实时清单，因此 Frolick 的新能力会自动出现——无需升级软件包。
可以——公开读取工具以及游戏和小组件目录无需授权即可使用。当你希望助手以你的身份创建内容时，再连接账户。