首页/开发者文档

开发者文档

Curio 是给 AI 的设计风格库。浏览风格库,然后用三种方式把任意一套风格交给你的 AI——分享链接、MCP 服务器,或下载 DESIGN.md。本指南覆盖这三种方式,外加各工具设置表、登录授权与 API 密钥、报错说明和积分。

概览#

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

浏览、搜索、看示意图都免费;解锁一套风格花 1 积分、只扣一次,见 积分。

通过 MCP#

一个分享链接带的是一套风格;MCP 接进来的是整座风格库——你的 AI 在对话里直接搜索、读取、套用。代价是要配置一次,而且只有支持 MCP 的客户端能用。如果你觉得每次粘个链接就够了,上一节看完就可以了。

一个接入地址,两种接法,接上之后能做的事完全一样。用哪种,看你的工具。

endpoint
https://mcp.designbycurio.com/mcp

选哪种接法

登录授权(OAuth)API 密钥
适合Claude(网页版、桌面版)、ChatGPT、Claude Code、Cursor、VS Code、Codex、Windsurf、Gemini CLIZCode、WorkBuddy、Trae、Antigravity、Manus,以及只能填 token / 请求头、或者打不开登录页的工具
怎么接填地址,在浏览器里登录 Curio,点「允许」在个人中心生成密钥,连同地址作为请求头填进去
有效期用着就自动续期,闲置 90 天过期一直有效,直到你吊销
花积分可以解锁新风格,AI 会被要求先问你默认只读;生成时选了才能解锁
断开个人中心 → MCP 连接 → 断开,立即生效同一页 → 吊销,30 秒内生效
i
拿不准用哪种?先把地址加进去。工具带你打开了 Curio 登录页(有的要先点「连接」或运行一条登录命令,见下方各工具),就登录;工具只让你填 token 或请求头,或者登录页始终打不开,就用 API 密钥。Qoder、Cherry Studio 两种都可能走通:先试登录,不行再用密钥。

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 设置)看步骤
WorkBuddyAPI 密钥侧边栏「插件」→ 右上角「MCP 服务器」→「配置 MCP」看步骤
Qoder登录或 API 密钥右上角用户图标 →「Qoder 设置」→ MCP →「我的服务」→「+ 添加」看步骤
AntigravityAPI 密钥Manage MCP Servers → View raw configAPI 密钥步骤
Manustoken 填 Bearer 加你的密钥。API 密钥连接器设置 → 添加自定义 MCP 连接器API 密钥步骤
其它工具(ZCode、Trae、Cherry Studio 等)Cherry Studio 也能走登录授权,可以先试试。API 密钥工具的 MCP 设置,要选传输方式就选 streamable HTTPAPI 密钥步骤

各工具详细步骤#

常用工具的完整接入步骤,附可以直接粘贴的命令或配置。

Claude Code 登录授权

  1. 把 Curio 加进 Claude Code

    在终端里运行下面的命令。

    terminal
    claude mcp add --transport http curio https://mcp.designbycurio.com/mcp
  2. 登录 Curio

    在 Claude Code 会话里运行 /mcp,选 curio 登录。用邮箱、Google 或 GitHub 登录,确认页面上的应用名称是你刚配置的工具,再点「允许」。

  3. 直接提需求

    回到 Claude Code,直接说需求,比如「找一套包豪斯风格,套到我的幻灯片上」。解锁新风格花 1 积分、只扣一次,AI 会被要求先问你。

ChatGPT 登录授权

  1. 把 Curio 加进 ChatGPT

    在设置 → 应用(先打开开发者模式)里添加远程 MCP 服务器,地址填 https://mcp.designbycurio.com/mcp,请求头留空。开发者模式需要付费套餐(Plus、Pro、Business 或 Enterprise)。

  2. 登录 Curio

    新建时 ChatGPT 会让你登录 Curio。用邮箱、Google 或 GitHub 登录,确认页面上的应用名称是你刚配置的工具,再点「允许」。

  3. 直接提需求

    回到 ChatGPT,直接说需求,比如「找一套包豪斯风格,套到我的幻灯片上」。解锁新风格花 1 积分、只扣一次,AI 会被要求先问你。

Cursor 登录授权

  1. 把 Curio 加进 Cursor

    点一键安装,或者自己在 Settings → MCP,或 ~/.cursor/mcp.json 里添加服务器,地址填 https://mcp.designbycurio.com/mcp。

    一键添加到 Cursor

    ~/.cursor/mcp.json
    {
      "mcpServers": {
        "curio": {
          "url": "https://mcp.designbycurio.com/mcp"
        }
      }
    }
  2. 登录 Curio

    首次连接时 Cursor 会打开浏览器让你登录。用邮箱、Google 或 GitHub 登录,确认页面上的应用名称是你刚配置的工具,再点「允许」。

  3. 直接提需求

    回到 Cursor,直接说需求,比如「找一套包豪斯风格,套到我的幻灯片上」。解锁新风格花 1 积分、只扣一次,AI 会被要求先问你。

VS Code (Copilot) 登录授权

  1. 把 Curio 加进 VS Code (Copilot)

    点一键安装,或者自己在 Copilot agent 模式下的 .vscode/mcp.json 里添加服务器,地址填 https://mcp.designbycurio.com/mcp。

    一键安装到 VS Code

    .vscode/mcp.json
    {
      "servers": {
        "curio": {
          "type": "http",
          "url": "https://mcp.designbycurio.com/mcp"
        }
      }
    }
  2. 登录 Curio

    首次连接时 VS Code 会打开浏览器授权。用邮箱、Google 或 GitHub 登录,确认页面上的应用名称是你刚配置的工具,再点「允许」。

  3. 直接提需求

    回到 VS Code (Copilot),直接说需求,比如「找一套包豪斯风格,套到我的幻灯片上」。解锁新风格花 1 积分、只扣一次,AI 会被要求先问你。

Codex CLI / IDE 扩展 登录授权

  1. 把 Curio 加进 Codex CLI / IDE 扩展

    在终端(CLI 和 IDE 扩展共用 ~/.codex/config.toml)里运行下面的命令。

    terminal
    codex mcp add curio --url https://mcp.designbycurio.com/mcp
    codex mcp login curio
  2. 登录 Curio

    codex mcp login curio 会打开浏览器登录。用邮箱、Google 或 GitHub 登录,确认页面上的应用名称是你刚配置的工具,再点「允许」。

  3. 直接提需求

    回到 Codex CLI / IDE 扩展,直接说需求,比如「找一套包豪斯风格,套到我的幻灯片上」。解锁新风格花 1 积分、只扣一次,AI 会被要求先问你。

Gemini CLI 登录授权

  1. 把 Curio 加进 Gemini CLI

    在终端里运行下面的命令。

    terminal
    gemini extensions install https://github.com/designbycurio/curio-mcp-extension
  2. 登录 Curio

    在 Gemini CLI 里运行 /mcp auth curio 登录。用邮箱、Google 或 GitHub 登录,确认页面上的应用名称是你刚配置的工具,再点「允许」。

  3. 直接提需求

    回到 Gemini CLI,直接说需求,比如「找一套包豪斯风格,套到我的幻灯片上」。解锁新风格花 1 积分、只扣一次,AI 会被要求先问你。

Windsurf 登录授权

  1. 把 Curio 加进 Windsurf

    在~/.codeium/windsurf/mcp_config.json(Windsurf 的 MCP 设置)里添加远程 MCP 服务器,地址填 https://mcp.designbycurio.com/mcp,请求头留空。

    ~/.codeium/windsurf/mcp_config.json
    {
      "mcpServers": {
        "curio": {
          "serverUrl": "https://mcp.designbycurio.com/mcp"
        }
      }
    }
  2. 登录 Curio

    首次连接时 Windsurf 会打开浏览器让你登录。用邮箱、Google 或 GitHub 登录,确认页面上的应用名称是你刚配置的工具,再点「允许」。

  3. 直接提需求

    回到 Windsurf,直接说需求,比如「找一套包豪斯风格,套到我的幻灯片上」。解锁新风格花 1 积分、只扣一次,AI 会被要求先问你。

WorkBuddy API 密钥

  1. 生成 API 密钥

    在 designbycurio.com 登录,打开「个人中心 → MCP 连接」,点「生成密钥」。除非想让 WorkBuddy 解锁新风格(每套 1 积分),否则保持「只读」。马上复制,密钥只显示这一次。

  2. 把 Curio 加进 WorkBuddy

    在侧边栏「插件」→ 右上角「MCP 服务器」→「配置 MCP」里添加服务器:地址填 https://mcp.designbycurio.com/mcp,请求头填 Authorization: Bearer 加你的密钥。保存后在连接器列表里点「启用」。

    MCP config
    {
      "mcpServers": {
        "curio": {
          "url": "https://mcp.designbycurio.com/mcp",
          "headers": {
            "Authorization": "Bearer curio_sk_…"
          }
        }
      }
    }
  3. 直接提需求

    回到 WorkBuddy,直接说需求,比如「找一套包豪斯风格,套到我的幻灯片上」。解锁新风格花 1 积分、只扣一次,AI 会被要求先问你。

Qoder 登录或 API 密钥

  1. 把 Curio 加进 Qoder

    在右上角用户图标 →「Qoder 设置」→ MCP →「我的服务」→「+ 添加」里添加远程 MCP 服务器,地址填 https://mcp.designbycurio.com/mcp,请求头留空。

    MCP config
    {
      "mcpServers": {
        "curio": {
          "url": "https://mcp.designbycurio.com/mcp"
        }
      }
    }
  2. 登录 Curio

    Qoder 会打开浏览器登录 Curio。用邮箱、Google 或 GitHub 登录,确认页面上的应用名称是你刚配置的工具,再点「允许」。

  3. 如果始终不弹登录

    在「个人中心 → MCP 连接」生成一把 API 密钥,在同一段配置里加上请求头:Authorization: Bearer 加你的密钥。

  4. 直接提需求

    回到 Qoder,直接说需求,比如「找一套包豪斯风格,套到我的幻灯片上」。解锁新风格花 1 积分、只扣一次,AI 会被要求先问你。

登录授权(OAuth)#

适合 Claude、ChatGPT、Claude Code、Cursor、VS Code、Codex、Windsurf、Gemini CLI 等支持 MCP 登录的工具。不用生成、也不用复制密钥。

  1. 在工具里添加远程 MCP 服务器,粘贴接入地址,请求头留空。各工具在哪里加,见 下方。
  2. 开始登录。多数工具会自己打开浏览器;Claude Code 在会话里运行 /mcp,Codex 运行 codex mcp login curio,Gemini CLI 运行 /mcp auth curio。
  3. 用邮箱、Google 或 GitHub 登录或注册 Curio。下一页会显示是哪个应用在请求、能做什么;确认是你刚刚配置的工具,再点「允许」。
  4. 回到工具就连好了,直接提需求,比如 「找一个包豪斯风格,套到我的幻灯片上。」

连接用着就自动续期,闲置满 90 天才过期。授权过的工具列在 个人中心 → MCP 连接里,可以随时断开。

API 密钥#

给走不通登录的工具用:ZCode、WorkBuddy、Trae、Antigravity、Manus,以及只给你一个填 token / 请求头地方的工具。密钥代替登录。

  1. 在网站上登录 Curio,用邮箱就行。
  2. 打开 个人中心 → MCP 连接 ,点「生成密钥」。用工具的名字命名;除非想让 AI 解锁新风格,否则保持「只读」。马上复制密钥:它以 curio_sk_ 开头,只显示这一次。
  3. 在工具的 MCP 设置里填接入地址,再加上下面这个请求头。要选传输方式的话,选 streamable HTTP。
header
Authorization: Bearer curio_sk_…

大多数工具认这样一段 JSON(ZCode、WorkBuddy、Qoder、Trae、Cherry Studio、Cursor、Windsurf……)。有的把地址字段叫 serverUrl 或 httpUrl。

json
{
  "mcpServers": {
    "curio": {
      "url": "https://mcp.designbycurio.com/mcp",
      "headers": { "Authorization": "Bearer curio_sk_…" }
    }
  }
}

然后直接提需求,比如 「找一个包豪斯风格,套到我的幻灯片上。」

命令行工具

这些工具都能正常登录授权,一般用不着密钥。如果你更想用密钥(比如在没有浏览器的服务器上):

Claude Code 在命令里带上请求头:

terminal
claude mcp add --transport http curio https://mcp.designbycurio.com/mcp --header "Authorization: Bearer curio_sk_…"

Codex 从环境变量读密钥,配置文件里不留明文:

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

.vscode/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 等)可以替你加:把下面这段话填上密钥发给它。密钥会留在这段对话的记录里,所以请用只读密钥、一个工具一把,对话要分享出去之前先吊销。

prompt
请帮我添加一个远程 MCP 服务器:
名称:curio
地址:https://mcp.designbycurio.com/mcp
传输方式:streamable HTTP
请求头:Authorization: Bearer <你的密钥>
加好后,在 Curio 里搜一套包豪斯风格试试。
i
只读,还是可解锁。默认的只读密钥能搜索、浏览、取你已经解锁的风格,不会花积分。生成时选了「可以解锁新风格」的密钥,AI 还能花 1 积分解锁一套风格。Curio 的工具会要求 AI 先问你,但问不问取决于 AI 工具本身。密钥等同密码:别提交到代码仓库,别公开贴出去。随时可以在「个人中心 → MCP 连接」吊销,用它的工具 30 秒内失效。

下载#

解锁一套风格后,它的页面上有「下载 DESIGN.md」按钮——一份写给人也写给 AI 的规格文件,想下几次都行。

DESIGN.md 文件

一个 Markdown 文件:YAML 前置元数据,然后每个设计维度一节。精确 token 值在正文里——结构如下。不熟悉这个格式?先读《什么是 DESIGN.md?》了解来龙去脉。

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
i
上面的样例只展示结构。某套风格的精确数值在它的 DESIGN.md 里,解锁这套风格后即可下载。

参考#

用得着时再查: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。

GET/i/<token>
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 资源

Skill 内置本地文件,无需连接 MCP。网站下载、分享链接和 MCP 仍按各自的账户与积分规则使用。

积分#

网站、分享链接和 MCP 共用一份积分余额、一份已解锁清单。积分按包一次性购买——不订阅,永不过期。现有积分包见定价页。

什么会花积分?

只有解锁一套风格:1 积分,只扣一次,这套风格永久归你。之后在任何设备、任何客户端上下载、生成分享链接、MCP 取用都不再扣。搜索、列目录、看介绍、get_balance 从来不花积分。

没有积分能用吗?

能——登录后就能连接、搜索、浏览整座风格库,看每套风格的介绍和全部封面、场景示意图。只有解锁某套风格的完整规格才需要积分。

积分用完会怎样?

解锁会返回 insufficient_credits。已经解锁的风格照常能用,浏览、搜索也不受影响。想解锁更多,去定价页再买一个积分包。

退款之后会怎样?

退款或拒付会扣回那个积分包的全部积分,余额可能因此变成负数。余额为负期间,下载、分享链接和 MCP 取用都会返回 balance_negative,余额回到 0 或以上就恢复。解锁记录会保留。什么情况下可以退款见服务条款。

© 2026 Curio