Developer docs开发者文档

Overview概览#

Every design in the catalog has a stable address and a complete, machine-readable spec — color, typography, spacing, shapes, motion. Point your AI at one and it reads the spec, then applies that look to whatever you are building.风格库里每套设计都有稳定的地址和一份完整、机器可读的规格——色彩、字体、间距、形状、动效。把你的 AI 指向其中一套，它读取规格，再把这套样子套到你正在做的东西上。

There are three ways to hand a style to an agent:把一套风格交给 AI 有三种方式：

• Share link — a short, 15-minute link you paste into any agent.分享链接——一个 15 分钟有效的短链接，粘贴给任意 AI 即可。
• MCP server — connect once; your agent searches and applies styles in-chat.MCP 服务器——接入一次；你的 AI 就能在对话里搜索并套用风格。
• Download — grab a style's DESIGN.md from its page.下载——在风格页拿它的 DESIGN.md。

Quick start快速开始#

The fastest path: open any style's page, choose Hand off to my AI → Copy share link, and paste it into your agent with what you want restyled.最快的路径：打开任意风格页，选「交给我的 AI → 复制分享链接」，把它连同你想改造的内容一起粘贴给你的 AI。

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

Your agent fetches the spec behind the link and rebuilds the work in that style. The same link works in Claude, Cursor, Codex, Gemini, ChatGPT, or any MCP-aware tool. Prefer a permanent connection? Connect over MCP instead.你的 AI 取出链接背后的规格，把作品按这套风格重做。同一个链接在 Claude、Cursor、Codex、Gemini、ChatGPT 或任意支持 MCP 的工具里都能用。想要常驻连接？改用 MCP 接入。

Share link分享链接#

Each style has a unique share link of the form designbycurio.com/i/<token>, minted from its page. Paste it into your agent and it retrieves the full spec and applies the style. Links stay live for 15 minutes — generate a fresh one per session.每套风格都有一个独立的分享链接，形如 designbycurio.com/i/<token>，在风格页生成。粘贴给你的 AI，它就取出完整规格并套用。链接有效期 15 分钟——每次会话单独生成一个。

Fetch over HTTP用 HTTP 取

Prefer plain HTTP? A share link responds to the Accept header — curl it for the raw DESIGN.md, or request JSON for an agent-ready manifest.想用纯 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

Over MCP通过 MCP#

The Curio MCP server gives your agent first-class access to the catalog — search, read, and apply styles without leaving the conversation. One server URL, sign in once with OAuth, no API keys.Curio 的 MCP 服务器让你的 AI 一等公民式地访问整座风格库——搜索、读取、套用都在对话里完成。一个服务器地址，OAuth 登录一次，无需 API Key。

https://mcp.designbycurio.com/mcp

Add that URL in your client and complete the OAuth sign-in. Per-client steps are in Connect your client below.把这个地址加进你的客户端，完成 OAuth 登录。逐客户端步骤见下方 连接你的客户端。

Download下载#

Every style exports from its page's Download ▾ menu as a DESIGN.md spec, written for both humans and agents.每套风格都能从风格页的 「Download ▾」 菜单导出一份写给人也写给 AI 的 DESIGN.md 规格。

The DESIGN.md fileDESIGN.md 文件

A single Markdown file: YAML front-matter, then a section per design aspect. The exact token values live in the body — the structure looks like this. New to the format? Read What is a DESIGN.md? for the full background.一个 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

Claude#

Claude Desktop & claude.ai: open Settings → Connectors → Add custom connector, paste the server URL, and sign in when the OAuth window opens. (Free accounts can add one custom connector.)Claude 桌面端 & claude.ai：打开 Settings → Connectors → Add custom connector，粘贴服务器地址，在弹出的 OAuth 窗口里登录。（免费账户可加一个自定义 connector。）

Claude Code: add the server from the CLI, then run /mcp in a session to finish the OAuth sign-in.Claude Code：用 CLI 添加服务器，然后在会话里运行 /mcp 完成 OAuth 登录。

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

Cursor#

Add Curio to ~/.cursor/mcp.json (or via Settings → MCP). Cursor opens a browser to sign in on first use.把 Curio 加到 ~/.cursor/mcp.json（或经 Settings → MCP）。首次使用时 Cursor 会开浏览器登录。

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

VS Code (Copilot)#

In Copilot agent mode, add Curio to .vscode/mcp.json (or your user MCP config). VS Code opens a browser to authorize on first connect.在 Copilot agent 模式下，把 Curio 加到 .vscode/mcp.json（或用户级 MCP 配置）。首次连接时 VS Code 会开浏览器授权。

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

Codex#

The Codex CLI and IDE extension share ~/.codex/config.toml — add the server with one command:Codex CLI 与 IDE 扩展共用 ~/.codex/config.toml——一行命令添加：

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

In the Codex desktop app, connect it from the Plugins panel instead — add the same server URL there.在 Codex 桌面 App 里则从它的 Plugins 面板连接——把同一个服务器地址加进去即可。

ChatGPT#

Custom MCP connectors need Developer Mode (Plus, Pro, Team, Enterprise — not Free). Turn it on, then go to Settings → Connectors → Create and enter the server URL https://mcp.designbycurio.com/mcp.自定义 MCP connector 需要 开发者模式（Plus / Pro / Team / Enterprise 可用，Free 不行）。打开它，再到 Settings → Connectors → Create，填入服务器地址 https://mcp.designbycurio.com/mcp。

Other clients其它客户端#

Any client that supports a remote streamable-HTTP MCP server with OAuth works — point it at https://mcp.designbycurio.com/mcp and sign in.任意支持「远程 streamable-HTTP MCP + OAuth」的客户端都能用——指向 https://mcp.designbycurio.com/mcp 并登录即可。

Antigravity Experimental实验性

Antigravity leans on header / bearer-token auth for remote MCP, while Curio is pure OAuth (no token to paste). The OAuth handshake may not complete in every version — if it connects, add the server via Manage MCP Servers → View raw config; otherwise use one of the OAuth-native clients above.Antigravity 对远程 MCP 偏向 header / bearer-token 鉴权，而 Curio 是纯 OAuth（没有可粘贴的 token）。OAuth 握手不一定每个版本都能走通——若能连，经 Manage MCP Servers → View raw config 添加；否则改用上面任一原生支持 OAuth 的客户端。

Manus Experimental实验性

Manus connectors typically expect a bearer token in the Authorization header, while Curio uses pure OAuth and issues no token. If your version supports a standard OAuth MCP connection, add the server URL in its connector settings; otherwise Curio can't be connected from Manus yet.Manus 的 connector 通常期望在 Authorization 头里带 bearer token，而 Curio 是纯 OAuth、不签发 token。若你的版本支持标准 OAuth 的 MCP 连接，在其 connector 设置里填服务器地址即可；否则目前暂无法从 Manus 连接 Curio。

MCP toolsMCP 工具#

Once connected, your agent has these tools. Browsing and search are free; only fetching a full spec draws a credit.连上之后，你的 AI 就有这些工具。浏览与搜索免费，只有取完整规格才扣积分。

Just ask in plain language, e.g. “Find a Bauhaus style and apply it to my slides.” Your agent searches, fetches the spec, and applies it.用自然语言提需求即可，比如 「找一个包豪斯风格，套到我的幻灯片上。」 AI 会搜索、取规格、套用。

Sign-in & permissions登录与权限#

OAuth, no API keys. Connecting means signing in. Curio uses standard OAuth with Dynamic Client Registration, so there's no key or token to create, paste, or rotate.OAuth，无 API Key。连接即登录。Curio 用标准 OAuth（含动态客户端注册 DCR），不需要你创建、粘贴或轮换任何 key / token。

Read-only. The connection only reads the design library. It never touches your files, your repository, or your data.只读。这个连接只读取设计库，绝不触碰你的文件、仓库或数据。

Revoke anytime. Manage connected apps on the connected apps page in your account; revoking immediately invalidates that client's access.随时撤销。在账户的已连接的应用页管理授权；撤销后该客户端的访问立即失效。

Billing & quota计费与额度#

Share links, MCP fetches and downloads all use the same credits and the same gate. For plans and prices, see pricing.分享链接、MCP 取用、下载共用同一套积分、同一道闸门。方案与价格见定价页。

What costs a credit?什么扣积分？

A credit is spent when a style's full spec is unlocked — get_style_spec over MCP, a download, or a generated share link. Searching, listing, reading metadata and get_quota are free. Unlocking the same style again within 15 minutes reuses the same credit.解锁某套风格的完整规格时扣 1 个积分——MCP 的 get_style_spec、下载、或生成分享链接。搜索、列目录、读元数据、get_quota 都不扣费。15 分钟内再次解锁同一套风格复用同一次积分。

Can a free account use it?免费账户能用吗？

Yes — connect, search and browse the whole library, and unlock free styles within your quota. Paid styles require Pro or Max; unlocking one without a plan returns a tier_denied error.可以——连接、搜索、浏览整座风格库，并在额度内解锁免费风格。付费风格需要 Pro 或 Max；未订阅时解锁会返回 tier_denied 错误。

What happens when quota runs out?额度用完会怎样？

Unlocking returns quota_exhausted. On Pro and Max your allowance refills on a rolling 7-day window; the Free tier's credits are a one-time lifetime allowance, so you'd upgrade to unlock more. Browsing, searching and reading metadata keep working.解锁会返回 quota_exhausted。Pro 与 Max 的额度按 7 天滚动窗口释放；Free 档的积分是一次性的累计额度，用完需升级才能再解锁。浏览、搜索、读元数据不受影响。