开发者文档
Curio 是给 AI 的设计风格库。浏览风格库,然后用三种方式把任意一套风格交给你的 AI——分享链接、MCP 服务器,或下载 DESIGN.md。本指南覆盖这三种方式,外加各工具设置表、登录授权与 API 密钥、报错说明和积分。
概览#
风格库里每套设计都有稳定的地址和一份完整、机器可读的规格:色彩、字体、间距、形状、动效。把你的 AI 指向其中一套,它读取规格,再把这套样子套到你正在做的东西上。交给 AI 有三种方式:
浏览、搜索、看示意图都免费;解锁一套风格花 1 积分、只扣一次,见 积分。
通过 MCP#
一个分享链接带的是一套风格;MCP 接进来的是整座风格库——你的 AI 在对话里直接搜索、读取、套用。代价是要配置一次,而且只有支持 MCP 的客户端能用。如果你觉得每次粘个链接就够了,上一节看完就可以了。
一个接入地址,两种接法,接上之后能做的事完全一样。用哪种,看你的工具。
https://mcp.designbycurio.com/mcp
选哪种接法
| 登录授权(OAuth) | API 密钥 | |
|---|---|---|
| 适合 | Claude(网页版、桌面版)、ChatGPT、Claude Code、Cursor、VS Code、Codex、Windsurf、Gemini CLI | ZCode、WorkBuddy、Trae、Antigravity、Manus,以及只能填 token / 请求头、或者打不开登录页的工具 |
| 怎么接 | 填地址,在浏览器里登录 Curio,点「允许」 | 在个人中心生成密钥,连同地址作为请求头填进去 |
| 有效期 | 用着就自动续期,闲置 90 天过期 | 一直有效,直到你吊销 |
| 花积分 | 可以解锁新风格,AI 会被要求先问你 | 默认只读;生成时选了才能解锁 |
| 断开 | 个人中心 → MCP 连接 → 断开,立即生效 | 同一页 → 吊销,30 秒内生效 |
MCP 和网站用同一份积分、同一份已解锁清单,见 积分。
各工具设置#
找到你用的工具:用哪种接法、在哪里加,以及完整步骤。
| 工具 | 接法 | 在哪加 | 详细步骤 |
|---|---|---|---|
| Claude(网页版、桌面版)Claude 免费账户可以加一个自定义连接器。 | 登录授权 | Settings → Connectors → Add custom connector | 登录授权步骤 |
| Claude Code | 登录授权 | 终端claude mcp add --transport http curio https://mcp.designbycurio.com/mcp | 看步骤 |
| ChatGPT开发者模式需要付费套餐(Plus、Pro、Business 或 Enterprise)。 | 登录授权 | 设置 → 应用(先打开开发者模式) | 看步骤 |
| Cursor | 登录授权 | Settings → MCP,或 ~/.cursor/mcp.json 一键添加到 Cursor | 看步骤 |
| VS Code (Copilot) | 登录授权 | Copilot agent 模式下的 .vscode/mcp.json 一键安装到 VS Code | 看步骤 |
| Codex CLI / IDE 扩展 | 登录授权 | 终端(CLI 和 IDE 扩展共用 ~/.codex/config.toml)codex mcp add curio --url https://mcp.designbycurio.com/mcp
codex mcp login curio | 看步骤 |
| Codex 桌面 App | 登录授权 | Plugins 面板 | 登录授权步骤 |
| Gemini CLI | 登录授权 | 终端gemini extensions install https://github.com/designbycurio/curio-mcp-extension | 看步骤 |
| Windsurf | 登录授权 | ~/.codeium/windsurf/mcp_config.json(Windsurf 的 MCP 设置) | 看步骤 |
| WorkBuddy | API 密钥 | 侧边栏「插件」→ 右上角「MCP 服务器」→「配置 MCP」 | 看步骤 |
| Qoder | 登录或 API 密钥 | 右上角用户图标 →「Qoder 设置」→ MCP →「我的服务」→「+ 添加」 | 看步骤 |
| Antigravity | API 密钥 | Manage MCP Servers → View raw config | API 密钥步骤 |
| Manustoken 填 Bearer 加你的密钥。 | API 密钥 | 连接器设置 → 添加自定义 MCP 连接器 | API 密钥步骤 |
| 其它工具(ZCode、Trae、Cherry Studio 等)Cherry Studio 也能走登录授权,可以先试试。 | API 密钥 | 工具的 MCP 设置,要选传输方式就选 streamable HTTP | API 密钥步骤 |
各工具详细步骤#
常用工具的完整接入步骤,附可以直接粘贴的命令或配置。
Claude Code 登录授权
把 Curio 加进 Claude Code
在终端里运行下面的命令。
claude mcp add --transport http curio https://mcp.designbycurio.com/mcp
登录 Curio
在 Claude Code 会话里运行 /mcp,选 curio 登录。用邮箱、Google 或 GitHub 登录,确认页面上的应用名称是你刚配置的工具,再点「允许」。
直接提需求
回到 Claude Code,直接说需求,比如「找一套包豪斯风格,套到我的幻灯片上」。解锁新风格花 1 积分、只扣一次,AI 会被要求先问你。
ChatGPT 登录授权
把 Curio 加进 ChatGPT
在设置 → 应用(先打开开发者模式)里添加远程 MCP 服务器,地址填 https://mcp.designbycurio.com/mcp,请求头留空。开发者模式需要付费套餐(Plus、Pro、Business 或 Enterprise)。
登录 Curio
新建时 ChatGPT 会让你登录 Curio。用邮箱、Google 或 GitHub 登录,确认页面上的应用名称是你刚配置的工具,再点「允许」。
直接提需求
回到 ChatGPT,直接说需求,比如「找一套包豪斯风格,套到我的幻灯片上」。解锁新风格花 1 积分、只扣一次,AI 会被要求先问你。
Cursor 登录授权
把 Curio 加进 Cursor
点一键安装,或者自己在 Settings → MCP,或 ~/.cursor/mcp.json 里添加服务器,地址填 https://mcp.designbycurio.com/mcp。
{ "mcpServers": { "curio": { "url": "https://mcp.designbycurio.com/mcp" } } }登录 Curio
首次连接时 Cursor 会打开浏览器让你登录。用邮箱、Google 或 GitHub 登录,确认页面上的应用名称是你刚配置的工具,再点「允许」。
直接提需求
回到 Cursor,直接说需求,比如「找一套包豪斯风格,套到我的幻灯片上」。解锁新风格花 1 积分、只扣一次,AI 会被要求先问你。
VS Code (Copilot) 登录授权
把 Curio 加进 VS Code (Copilot)
点一键安装,或者自己在 Copilot agent 模式下的 .vscode/mcp.json 里添加服务器,地址填 https://mcp.designbycurio.com/mcp。
{ "servers": { "curio": { "type": "http", "url": "https://mcp.designbycurio.com/mcp" } } }登录 Curio
首次连接时 VS Code 会打开浏览器授权。用邮箱、Google 或 GitHub 登录,确认页面上的应用名称是你刚配置的工具,再点「允许」。
直接提需求
回到 VS Code (Copilot),直接说需求,比如「找一套包豪斯风格,套到我的幻灯片上」。解锁新风格花 1 积分、只扣一次,AI 会被要求先问你。
Codex CLI / IDE 扩展 登录授权
把 Curio 加进 Codex CLI / IDE 扩展
在终端(CLI 和 IDE 扩展共用 ~/.codex/config.toml)里运行下面的命令。
codex mcp add curio --url https://mcp.designbycurio.com/mcp codex mcp login curio
登录 Curio
codex mcp login curio 会打开浏览器登录。用邮箱、Google 或 GitHub 登录,确认页面上的应用名称是你刚配置的工具,再点「允许」。
直接提需求
回到 Codex CLI / IDE 扩展,直接说需求,比如「找一套包豪斯风格,套到我的幻灯片上」。解锁新风格花 1 积分、只扣一次,AI 会被要求先问你。
Gemini CLI 登录授权
把 Curio 加进 Gemini CLI
在终端里运行下面的命令。
gemini extensions install https://github.com/designbycurio/curio-mcp-extension
登录 Curio
在 Gemini CLI 里运行 /mcp auth curio 登录。用邮箱、Google 或 GitHub 登录,确认页面上的应用名称是你刚配置的工具,再点「允许」。
直接提需求
回到 Gemini CLI,直接说需求,比如「找一套包豪斯风格,套到我的幻灯片上」。解锁新风格花 1 积分、只扣一次,AI 会被要求先问你。
Windsurf 登录授权
把 Curio 加进 Windsurf
在~/.codeium/windsurf/mcp_config.json(Windsurf 的 MCP 设置)里添加远程 MCP 服务器,地址填 https://mcp.designbycurio.com/mcp,请求头留空。
{ "mcpServers": { "curio": { "serverUrl": "https://mcp.designbycurio.com/mcp" } } }登录 Curio
首次连接时 Windsurf 会打开浏览器让你登录。用邮箱、Google 或 GitHub 登录,确认页面上的应用名称是你刚配置的工具,再点「允许」。
直接提需求
回到 Windsurf,直接说需求,比如「找一套包豪斯风格,套到我的幻灯片上」。解锁新风格花 1 积分、只扣一次,AI 会被要求先问你。
WorkBuddy API 密钥
生成 API 密钥
在 designbycurio.com 登录,打开「个人中心 → MCP 连接」,点「生成密钥」。除非想让 WorkBuddy 解锁新风格(每套 1 积分),否则保持「只读」。马上复制,密钥只显示这一次。
把 Curio 加进 WorkBuddy
在侧边栏「插件」→ 右上角「MCP 服务器」→「配置 MCP」里添加服务器:地址填 https://mcp.designbycurio.com/mcp,请求头填 Authorization: Bearer 加你的密钥。保存后在连接器列表里点「启用」。
{ "mcpServers": { "curio": { "url": "https://mcp.designbycurio.com/mcp", "headers": { "Authorization": "Bearer curio_sk_…" } } } }直接提需求
回到 WorkBuddy,直接说需求,比如「找一套包豪斯风格,套到我的幻灯片上」。解锁新风格花 1 积分、只扣一次,AI 会被要求先问你。
Qoder 登录或 API 密钥
把 Curio 加进 Qoder
在右上角用户图标 →「Qoder 设置」→ MCP →「我的服务」→「+ 添加」里添加远程 MCP 服务器,地址填 https://mcp.designbycurio.com/mcp,请求头留空。
{ "mcpServers": { "curio": { "url": "https://mcp.designbycurio.com/mcp" } } }登录 Curio
Qoder 会打开浏览器登录 Curio。用邮箱、Google 或 GitHub 登录,确认页面上的应用名称是你刚配置的工具,再点「允许」。
如果始终不弹登录
在「个人中心 → MCP 连接」生成一把 API 密钥,在同一段配置里加上请求头:Authorization: Bearer 加你的密钥。
直接提需求
回到 Qoder,直接说需求,比如「找一套包豪斯风格,套到我的幻灯片上」。解锁新风格花 1 积分、只扣一次,AI 会被要求先问你。
登录授权(OAuth)#
适合 Claude、ChatGPT、Claude Code、Cursor、VS Code、Codex、Windsurf、Gemini CLI 等支持 MCP 登录的工具。不用生成、也不用复制密钥。
- 在工具里添加远程 MCP 服务器,粘贴接入地址,请求头留空。各工具在哪里加,见 下方。
- 开始登录。多数工具会自己打开浏览器;Claude Code 在会话里运行
/mcp,Codex 运行codex mcp login curio,Gemini CLI 运行/mcp auth curio。 - 用邮箱、Google 或 GitHub 登录或注册 Curio。下一页会显示是哪个应用在请求、能做什么;确认是你刚刚配置的工具,再点「允许」。
- 回到工具就连好了,直接提需求,比如 「找一个包豪斯风格,套到我的幻灯片上。」
连接用着就自动续期,闲置满 90 天才过期。授权过的工具列在 个人中心 → MCP 连接里,可以随时断开。
API 密钥#
给走不通登录的工具用:ZCode、WorkBuddy、Trae、Antigravity、Manus,以及只给你一个填 token / 请求头地方的工具。密钥代替登录。
- 在网站上登录 Curio,用邮箱就行。
- 打开 个人中心 → MCP 连接 ,点「生成密钥」。用工具的名字命名;除非想让 AI 解锁新风格,否则保持「只读」。马上复制密钥:它以
curio_sk_开头,只显示这一次。 - 在工具的 MCP 设置里填接入地址,再加上下面这个请求头。要选传输方式的话,选 streamable HTTP。
Authorization: Bearer curio_sk_…
大多数工具认这样一段 JSON(ZCode、WorkBuddy、Qoder、Trae、Cherry Studio、Cursor、Windsurf……)。有的把地址字段叫 serverUrl 或 httpUrl。
{
"mcpServers": {
"curio": {
"url": "https://mcp.designbycurio.com/mcp",
"headers": { "Authorization": "Bearer curio_sk_…" }
}
}
}
然后直接提需求,比如 「找一个包豪斯风格,套到我的幻灯片上。」
命令行工具
这些工具都能正常登录授权,一般用不着密钥。如果你更想用密钥(比如在没有浏览器的服务器上):
Claude Code 在命令里带上请求头:
claude mcp add --transport http curio https://mcp.designbycurio.com/mcp --header "Authorization: Bearer curio_sk_…"
Codex 从环境变量读密钥,配置文件里不留明文:
export CURIO_API_KEY=curio_sk_… codex mcp add curio --url https://mcp.designbycurio.com/mcp --bearer-token-env-var CURIO_API_KEY
VS Code 可以在连接时弹框让你输入密钥、加密保存,不写进 mcp.json:
{
"inputs": [
{ "type": "promptString", "id": "curio-key", "description": "Curio API key", "password": true }
],
"servers": {
"curio": {
"type": "http",
"url": "https://mcp.designbycurio.com/mcp",
"headers": { "Authorization": "Bearer ${input:curio-key}" }
}
}
}
让 AI 自己加上
能自己改 MCP 设置的 AI(WorkBuddy、Manus 等)可以替你加:把下面这段话填上密钥发给它。密钥会留在这段对话的记录里,所以请用只读密钥、一个工具一把,对话要分享出去之前先吊销。
请帮我添加一个远程 MCP 服务器:
名称:curio
地址:https://mcp.designbycurio.com/mcp
传输方式:streamable HTTP
请求头:Authorization: Bearer <你的密钥>
加好后,在 Curio 里搜一套包豪斯风格试试。
下载#
解锁一套风格后,它的页面上有「下载 DESIGN.md」按钮——一份写给人也写给 AI 的规格文件,想下几次都行。
DESIGN.md 文件
一个 Markdown 文件:YAML 前置元数据,然后每个设计维度一节。精确 token 值在正文里——结构如下。不熟悉这个格式?先读《什么是 DESIGN.md?》了解来龙去脉。
--- name: <style name> origin: <place, year> era: <era bucket> --- # <Style name> A short description of the look and the rules behind it. ## Colors # palette + roles ## Typography # families, scale, tracking ## Spacing # the spacing rhythm ## Shapes · Shadows · Motion · Composition
参考#
用得着时再查:AI 能用的工具、报错是什么意思、用 HTTP 直接取、权限,以及开源的部分。
MCP 工具
连上之后,你的 AI 就有这些工具。除了解锁风格,全部免费;解锁之前 AI 会先问你。
| 工具 | 作用 | 扣费 |
|---|---|---|
search_styles | 按用途、感觉、颜色、年代或名字搜索 | 免费 |
list_styles | 列出目录 | 免费 |
get_style | 单套风格的介绍 + 封面和场景示意图 | 免费 |
get_style_spec | 已解锁风格的完整 DESIGN.md;未解锁的返回 not_unlocked,附要花的积分和你的余额 | 免费 |
unlock_style | 你同意后解锁这套风格,并返回完整规格 | 1 积分 |
get_balance | 你的积分余额和已解锁的风格数 | 免费 |
用自然语言提需求即可,比如 「找一个包豪斯风格,套到我的幻灯片上。」 AI 会搜索、取规格、套用。
报错说明
| AI 看到的 | 意思 | 怎么办 |
|---|---|---|
not_unlocked | 这套风格还没解锁。 | AI 会告诉你要花几积分并先问你,同意后花 1 积分解锁。 |
insufficient_credits | 积分不够解锁。 | 已解锁的照常能用。去 定价页 买积分包。 |
balance_negative | 退款后余额变成负数。 | 余额回到 0 或以上前,下载、链接、MCP 取用暂停。 |
| 工具调用太频繁 | 同一账号一分钟内调用超过 60 次。 | 等一分钟再试。 |
| 要求重新登录 / 401 | 登录授权闲置 90 天过期,或者 API 密钥被吊销了。 | 重新登录,或生成一把新密钥。 |
用 HTTP 取
想用纯 HTTP?分享链接会按 Accept 头返回——curl 拿到原始 DESIGN.md,或请求 JSON 拿到给 agent 用的 manifest。
curl https://designbycurio.com/i/<token> # → DESIGN.md (markdown) curl -H "Accept: application/json" \ https://designbycurio.com/i/<token> # → agent manifest
登录与权限
两种接法,同一套规则。登录授权和 API 密钥接到的是同一座风格库、同一份积分。Curio 用标准 OAuth(支持 Client ID Metadata Document 与动态客户端注册),登录授权用着就自动续期,闲置满 90 天才过期。API 密钥一直有效,直到你吊销;生成时没选「可以解锁新风格」就是只读。
花积分前先问你。这个连接读取设计库,唯一能改动的是你的积分余额——unlock_style 会花 1 积分,Curio 的工具会要求 AI 调用前先问你。它绝不触碰你的文件、仓库或数据。
随时撤销。在个人中心的 MCP 连接页管理已授权的工具和 API 密钥。断开授权立即失效;吊销 API 密钥 30 秒内失效。注销账户会撤销全部连接和密钥,AI 客户端会提示你重新连接。
GitHub 资源
- Curio 的 GitHub 主页
- MCP 仓库与接入说明 — 客户端安装指南与接入问题反馈。
- 免费设计 Skill — 105 套免费设计系统,以及指导 AI 应用主题的使用规范。
Skill 内置本地文件,无需连接 MCP。网站下载、分享链接和 MCP 仍按各自的账户与积分规则使用。
积分#
网站、分享链接和 MCP 共用一份积分余额、一份已解锁清单。积分按包一次性购买——不订阅,永不过期。现有积分包见定价页。
什么会花积分?
只有解锁一套风格:1 积分,只扣一次,这套风格永久归你。之后在任何设备、任何客户端上下载、生成分享链接、MCP 取用都不再扣。搜索、列目录、看介绍、get_balance 从来不花积分。
没有积分能用吗?
能——登录后就能连接、搜索、浏览整座风格库,看每套风格的介绍和全部封面、场景示意图。只有解锁某套风格的完整规格才需要积分。
积分用完会怎样?
解锁会返回 insufficient_credits。已经解锁的风格照常能用,浏览、搜索也不受影响。想解锁更多,去定价页再买一个积分包。
退款之后会怎样?
退款或拒付会扣回那个积分包的全部积分,余额可能因此变成负数。余额为负期间,下载、分享链接和 MCP 取用都会返回 balance_negative,余额回到 0 或以上就恢复。解锁记录会保留。什么情况下可以退款见服务条款。


