Curio를 AI에 어떻게 연결하나요?

세 가지 방법이 있습니다. 15분짜리 공유 링크를 에이전트에 붙여 넣거나, https://mcp.designbycurio.com/mcp의 MCP 서버를 OAuth로 한 번 연결하거나, 스타일 페이지에서 DESIGN.md를 다운로드하세요. API 키는 필요 없습니다.

스타일을 가져오면 크레딧이 차감되나요?

MCP의 get_style_spec, 다운로드, 공유 링크 생성으로 스타일 전체 사양을 잠금 해제할 때 크레딧 1회가 차감됩니다. 검색, 목록 보기, 메타데이터 읽기, 할당량 확인은 무료입니다. 15분 안에 같은 스타일을 다시 열면 같은 크레딧을 재사용합니다.

MCP 할당량은 웹사이트 다운로드와 공유되나요?

예. MCP 가져오기, 다운로드, 공유 링크는 같은 할당량과 서버 측 제한을 사용하므로 MCP로 유료 제한을 우회할 수 없습니다. get_quota 도구로 언제든 남은 할당량을 확인하세요.

문서 · Curio Design

Q: Free 계정도 사용할 수 있나요?

예. Free 계정도 연결 후 전체 라이브러리를 검색하고 둘러볼 수 있으며 할당량 내에서 Free 스타일을 열 수 있습니다. 유료 스타일에는 Pro 또는 Max가 필요하며 플랜 없이 열면 tier_denied 오류가 반환됩니다.

Q: 할당량을 모두 쓰면 어떻게 되나요?

잠금 해제 시 quota_exhausted 오류가 반환됩니다. Pro와 Max의 할당량은 7일 롤링 방식으로 다시 채워집니다. Free 크레딧은 평생 한 번만 제공되므로 더 열려면 업그레이드해야 합니다. 탐색, 검색, 메타데이터 읽기는 계속 작동합니다.

개요#

카탈로그의 모든 디자인에는 고정 주소와 색상, 타이포그래피, 간격, 형태, 모션을 담은 완전한 기계 판독형 사양이 있습니다. 하나를 AI에 알려 주면 사양을 읽고 만들고 있는 작업에 그 스타일을 적용합니다.

에이전트에 스타일을 전달하는 방법은 세 가지입니다:

공유 링크 — 어떤 에이전트에도 붙여 넣을 수 있는 15분짜리 짧은 링크입니다.
MCP 서버 — 한 번 연결하면 에이전트가 채팅 안에서 스타일을 검색하고 적용합니다.
다운로드 — 스타일 페이지에서 DESIGN.md를 받습니다.

i

둘러보기는 무료입니다. 검색, 필터링, 메타데이터 읽기에는 크레딧이 들지 않으며 스타일 전체 사양을 잠금 해제할 때만 차감됩니다.

빠른 시작#

가장 빠른 방법은 스타일 페이지를 열어 내 AI에 전달 → 공유 링크 복사를 선택한 뒤, 바꾸고 싶은 내용과 함께 에이전트에 붙여 넣는 것입니다.

prompt

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

에이전트가 링크의 사양을 가져와 그 스타일로 작업물을 다시 만듭니다. 같은 링크를 Claude, Cursor, Codex, Gemini, ChatGPT 또는 MCP 지원 도구에서 사용할 수 있습니다. 상시 연결을 원한다면 MCP로 연결하세요.

각 스타일 페이지에서는 designbycurio.com/i/<token> 형식의 고유 공유 링크를 만들 수 있습니다. 에이전트에 붙여 넣으면 전체 사양을 가져와 스타일을 적용합니다. 링크는 15분 동안 유효하므로 세션마다 새로 만드세요.

일반 HTTP를 선호하나요? 공유 링크는 Accept 헤더에 응답합니다. curl로 원본 DESIGN.md를 받거나 JSON으로 에이전트용 매니페스트를 요청하세요.

GET/i/<token>

curl https://designbycurio.com/i/<token>          # → DESIGN.md (markdown)
curl -H "Accept: application/json" \
     https://designbycurio.com/i/<token>          # → agent manifest

MCP로#

Curio MCP 서버는 에이전트가 대화를 벗어나지 않고 카탈로그를 검색하고 읽고 스타일을 적용할 수 있게 합니다. 서버 URL 하나에 OAuth로 한 번 로그인하면 되며 API 키는 필요 없습니다.

endpoint

https://mcp.designbycurio.com/mcp

클라이언트에 URL을 추가하고 OAuth 로그인을 완료하세요. 클라이언트별 절차는 아래 클라이언트 연결에서 확인할 수 있습니다.

i

모든 플랜에서 작동합니다. Free 계정은 연결 후 할당량 내에서 Free 스타일을 열 수 있고, ProMax는 모든 스타일을 엽니다. MCP에도 웹사이트와 같은 사용량 제한이 적용되므로 유료 제한을 우회할 수 없습니다.

다운로드#

모든 스타일은 해당 페이지의 다운로드 ▾ 메뉴에서 사람과 에이전트 모두를 위해 작성된 DESIGN.md 사양으로 내보낼 수 있습니다.

DESIGN.md 파일

YAML 프런트매터 뒤에 디자인 요소별 섹션이 이어지는 하나의 Markdown 파일입니다. 정확한 토큰 값은 본문에 있으며 구조는 다음과 같습니다. 이 형식이 처음이라면 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

위 예시는 형식만 보여 줍니다. 스타일의 정확한 값은 다운로드에 포함됩니다. Free 스타일은 할당량 내에서 열 수 있고 유료 스타일에는 Pro 또는 Max 플랜이 필요합니다.

Claude#

Claude Desktop 및 claude.ai: Settings → Connectors → Add custom connector를 열어 서버 URL을 붙여 넣고 OAuth 창이 열리면 로그인하세요. Free 계정은 커스텀 커넥터 하나를 추가할 수 있습니다.

Claude Code: CLI에서 서버를 추가한 뒤 세션에서 /mcp를 실행해 OAuth 로그인을 마치세요.

terminal

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

Cursor#

~/.cursor/mcp.json 또는 Settings → MCP에서 Curio를 추가하세요. Cursor는 처음 사용할 때 브라우저를 열어 로그인합니다.

~/.cursor/mcp.json

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

VS Code (Copilot)#

Copilot 에이전트 모드에서 .vscode/mcp.json 또는 사용자 MCP 설정에 Curio를 추가하세요. VS Code는 처음 연결할 때 브라우저를 열어 인증합니다.

.vscode/mcp.json

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

Codex#

Codex CLI와 IDE 확장은 ~/.codex/config.toml을 공유합니다. 다음 명령 하나로 서버를 추가하세요:

terminal

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

Codex 데스크톱 앱에서는 Plugins 패널에서 같은 서버 URL을 추가해 연결하세요.

ChatGPT#

커스텀 MCP 커넥터에는 Developer Mode가 필요합니다(Plus, Pro, Team, Enterprise만 지원하며 Free는 제외). 이를 켠 뒤 Settings → Connectors → Create로 이동해 서버 URL https://mcp.designbycurio.com/mcp를 입력하세요.

기타 클라이언트#

OAuth를 사용하는 원격 스트리밍 HTTP MCP 서버를 지원하는 클라이언트라면 모두 작동합니다. https://mcp.designbycurio.com/mcp를 지정하고 로그인하세요.

Antigravity 실험적

Antigravity는 원격 MCP에 주로 헤더 또는 bearer 토큰 인증을 사용하지만 Curio는 붙여 넣을 토큰이 없는 순수 OAuth 방식입니다. 일부 버전에서는 OAuth 핸드셰이크가 완료되지 않을 수 있습니다. 연결된다면 Manage MCP Servers → View raw config에서 서버를 추가하고, 그렇지 않다면 위의 OAuth 기본 지원 클라이언트를 사용하세요.

Manus 실험적

Manus 커넥터는 보통 Authorization 헤더의 bearer 토큰을 요구하지만 Curio는 토큰을 발급하지 않는 순수 OAuth 방식입니다. 사용하는 버전이 표준 OAuth MCP 연결을 지원한다면 커넥터 설정에 서버 URL을 추가하세요. 그렇지 않다면 아직 Manus에서 Curio를 연결할 수 없습니다.

MCP 도구#

연결하면 에이전트가 다음 도구를 사용할 수 있습니다. 탐색과 검색은 무료이며 전체 사양을 가져올 때만 크레딧이 차감됩니다.

도구	수행 기능	비용
`search_styles`	키워드, 색상, 시대, 용도별 검색	Free
`list_styles`	카탈로그 목록	Free
`get_style`	스타일 메타데이터 + 미리보기 이미지	Free
`get_style_spec`	전체 디자인 사양; 유료 스타일은 Pro/Max 필요	1크레딧
`get_quota`	현재 기간의 남은 할당량	Free

자연어로 요청하면 됩니다. 예: “Bauhaus 스타일을 찾아 내 슬라이드에 적용해 줘.” 에이전트가 검색하고 사양을 가져와 적용합니다.

로그인 및 권한#

OAuth 방식이며 API 키가 없습니다. 연결은 로그인을 뜻합니다. Curio는 동적 클라이언트 등록이 포함된 표준 OAuth를 사용하므로 만들거나 붙여 넣거나 교체할 키와 토큰이 없습니다.

읽기 전용입니다. 연결은 디자인 라이브러리만 읽으며 파일, 저장소, 데이터에는 접근하지 않습니다.

언제든 해제할 수 있습니다. 계정의 연결된 앱 페이지에서 관리하세요. 해제하면 해당 클라이언트의 접근 권한이 즉시 무효화됩니다.

결제 및 할당량#

공유 링크, MCP 가져오기, 다운로드에는 모두 같은 크레딧과 제한이 적용됩니다. 플랜과 요금은 요금에서 확인하세요.

언제 크레딧이 차감되나요?

MCP의 get_style_spec, 다운로드, 공유 링크 생성으로 스타일 전체 사양을 잠금 해제할 때 크레딧 1회가 차감됩니다. 검색, 목록 보기, 메타데이터 읽기, get_quota는 무료입니다. 15분 안에 같은 스타일을 다시 열면 같은 크레딧을 재사용합니다.

Free 계정도 사용할 수 있나요?

예. 연결 후 전체 라이브러리를 검색하고 둘러볼 수 있으며 할당량 내에서 Free 스타일을 열 수 있습니다. 유료 스타일에는 Pro 또는 Max가 필요하며 플랜 없이 열면 tier_denied 오류가 반환됩니다.

할당량을 모두 쓰면 어떻게 되나요?

잠금 해제 시 quota_exhausted가 반환됩니다. Pro와 Max의 할당량은 7일 롤링 방식으로 다시 채워집니다. Free 크레딧은 평생 한 번만 제공되므로 더 열려면 업그레이드해야 합니다. 탐색, 검색, 메타데이터 읽기는 계속 작동합니다.

개발자 문서

개요#

빠른 시작#

공유 링크#

HTTP로 가져오기

MCP로#

다운로드#

DESIGN.md 파일

Claude#

Cursor#

VS Code (Copilot)#

Codex#

ChatGPT#

기타 클라이언트#

Antigravity 실험적

Manus 실험적

MCP 도구#

로그인 및 권한#

결제 및 할당량#

언제 크레딧이 차감되나요?

Free 계정도 사용할 수 있나요?

할당량을 모두 쓰면 어떻게 되나요?