开发者文档

概览#

风格库里每套设计都有稳定的地址和一份完整、机器可读的规格——色彩、字体、间距、形状、动效。把你的 AI 指向其中一套，它读取规格，再把这套样子套到你正在做的东西上。

把一套风格交给 AI 有三种方式：

• 分享链接——一个 15 分钟有效的短链接，粘贴给任意 AI 即可。
• MCP 服务器——接入一次；你的 AI 就能在对话里搜索并套用风格。
• 下载——在风格页拿它的 DESIGN.md 与 Figma token JSON。

快速开始#

最快的路径：打开任意风格页，选「交给我的 AI → 复制分享链接」，把它连同你想改造的内容一起粘贴给你的 AI。

Restyle this slide deck with the Curio design at:
https://designbycurio.com/i/<token>

你的 AI 取出链接背后的规格，把作品按这套风格重做。同一个链接在 Claude、Cursor、Codex、Gemini、ChatGPT 或任意支持 MCP 的工具里都能用。想要常驻连接？改用 MCP 接入。

分享链接#

每套风格都有一个独立的分享链接，形如 designbycurio.com/i/<token>，在风格页生成。粘贴给你的 AI，它就取出完整规格并套用。链接有效期 15 分钟——每次会话单独生成一个。

用 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

通过 MCP#

Curio 的 MCP 服务器让你的 AI 一等公民式地访问整座风格库——搜索、读取、套用都在对话里完成。一个服务器地址，OAuth 登录一次，无需 API Key。

https://mcp.designbycurio.com/mcp

把这个地址加进你的客户端，完成 OAuth 登录。逐客户端步骤见下方 连接你的客户端。

下载#

每套风格都能从风格页的 「Download ▾」 菜单导出两种格式：一份写给人也写给 AI 的 DESIGN.md 规格，以及一份兼容 Figma 的 token JSON。

DESIGN.md 文件

一个 Markdown 文件：YAML 前置元数据，然后每个设计维度一节。精确 token 值在正文里——结构如下：

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

Figma / Tokens Studio JSON

同一套 token 以 Tokens Studio for Figma 格式导出——可直接导入 Figma variables 或 Style Dictionary 流程。

{
  "color": {
    "primary": { "value": "<hex>", "type": "color" }
  },
  "spacing": { "md": { "value": "<px>", "type": "spacing" } }
}

Claude#

Claude 桌面端 & claude.ai：打开 Settings → Connectors → Add custom connector，粘贴服务器地址，在弹出的 OAuth 窗口里登录。（免费账户可加一个自定义 connector。）

Claude Code：用 CLI 添加服务器，然后在会话里运行 /mcp 完成 OAuth 登录。

claude mcp add --transport http curio https://mcp.designbycurio.com/mcp

Cursor#

把 Curio 加到 ~/.cursor/mcp.json（或经 Settings → MCP）。首次使用时 Cursor 会开浏览器登录。

{
  "mcpServers": {
    "curio": { "url": "https://mcp.designbycurio.com/mcp" }
  }
}

VS Code (Copilot)#

在 Copilot agent 模式下，把 Curio 加到 .vscode/mcp.json（或用户级 MCP 配置）。首次连接时 VS Code 会开浏览器授权。

{
  "servers": {
    "curio": { "type": "http", "url": "https://mcp.designbycurio.com/mcp" }
  }
}

Codex#

Codex CLI 与 IDE 扩展共用 ~/.codex/config.toml——一行命令添加：

codex mcp add curio --url https://mcp.designbycurio.com/mcp

在 Codex 桌面 App 里则从它的 Plugins 面板连接——把同一个服务器地址加进去即可。

ChatGPT#

自定义 MCP connector 需要 开发者模式（Plus / Pro / Team / Enterprise 可用，Free 不行）。打开它，再到 Settings → Connectors → Create，填入服务器地址 https://mcp.designbycurio.com/mcp。

其它客户端#

任意支持「远程 streamable-HTTP MCP + OAuth」的客户端都能用——指向 https://mcp.designbycurio.com/mcp 并登录即可。

Antigravity 实验性

Antigravity 对远程 MCP 偏向 header / bearer-token 鉴权，而 Curio 是纯 OAuth（没有可粘贴的 token）。OAuth 握手不一定每个版本都能走通——若能连，经 Manage MCP Servers → View raw config 添加；否则改用上面任一原生支持 OAuth 的客户端。

Manus 实验性

Manus 的 connector 通常期望在 Authorization 头里带 bearer token，而 Curio 是纯 OAuth、不签发 token。若你的版本支持标准 OAuth 的 MCP 连接，在其 connector 设置里填服务器地址即可；否则目前暂无法从 Manus 连接 Curio。

MCP 工具#

连上之后，你的 AI 就有这些工具。浏览与搜索免费，只有取完整规格才扣积分。

用自然语言提需求即可，比如 「找一个包豪斯风格，套到我的幻灯片上。」 AI 会搜索、取规格、套用。

登录与权限#

OAuth，无 API Key。连接即登录。Curio 用标准 OAuth（含动态客户端注册 DCR），不需要你创建、粘贴或轮换任何 key / token。

只读。这个连接只读取设计库，绝不触碰你的文件、仓库或数据。

随时撤销。在账户的已连接的应用页管理授权；撤销后该客户端的访问立即失效。

计费与额度#

分享链接、MCP 取用、下载共用同一套积分、同一道闸门。方案与价格见定价页。

什么扣积分？

解锁某套风格的完整规格时扣 1 个积分——MCP 的 get_style_spec、下载、或生成分享链接。搜索、列目录、读元数据、get_quota 都不扣费。15 分钟内再次解锁同一套风格复用同一次积分。

免费账户能用吗？

可以——连接、搜索、浏览整座风格库，并在额度内解锁免费风格。付费风格需要 Pro 或 Max；未订阅时解锁会返回 tier_denied 错误。

额度用完会怎样？

解锁会返回 quota_exhausted。Pro 与 Max 的额度按 7 天滚动窗口释放；Free 档的积分是一次性的累计额度，用完需升级才能再解锁。浏览、搜索、读元数据不受影响。