文書/ガイド

開発者ドキュメント

CurioはAI向けのデザインライブラリです。カタログを閲覧し、共有リンク、MCPサーバー、ダウンロードしたDESIGN.mdの3つの方法で、任意のスタイルをエージェントへ渡せます。このガイドでは3つの方法に加え、クライアント別の設定、ツール、ログイン、課金を説明します。

概要#

カタログ内の各デザインには、固定アドレスと、色、タイポグラフィ、余白、形、モーションを含む完全な機械可読仕様があります。AIにひとつ指定すれば、仕様を読み取り、制作中のものへその表現を適用します。

スタイルをエージェントへ渡す方法は3つあります。

  • 共有リンク — 任意のエージェントに貼り付ける、15分間有効の短いリンクです。
  • MCPサーバー — 一度接続すれば、エージェントがチャット内でスタイルを検索・適用します。
  • ダウンロード — スタイルのページからDESIGN.mdを取得します。
i
閲覧は無料です。検索、絞り込み、メタデータの参照ではクレジットを消費しません。スタイルの完全な仕様を解放したときだけ1クレジットを消費します。

クイックスタート#

最短の方法は、任意のスタイルページを開き、Hand off to my AI → Copy share linkを選ぶことです。スタイルを適用したいものと一緒に、リンクをエージェントへ貼り付けます。

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

エージェントがリンク先の仕様を取得し、そのスタイルで作品を組み直します。同じリンクをClaude、Cursor、Codex、Gemini、ChatGPTなど、MCP対応ツールで使えます。常時接続したい場合は、代わりにMCPで接続してください。

MCP経由#

Curio MCPサーバーを使うと、エージェントからカタログを直接検索・参照し、会話を離れずにスタイルを適用できます。サーバーURLはひとつ、OAuthで一度ログインするだけ。APIキーは不要です。

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

そのURLをクライアントへ追加し、OAuthログインを完了します。クライアント別の手順は、下のクライアントを接続をご覧ください。

i
すべてのプランで使えます。Freeアカウントでも接続し、上限内でFreeスタイルを解放できます。ProMaxなら全スタイルを解放できます。MCPにもウェブサイトと同じ利用制限が適用されるため、支払いを回避する手段ではありません。

ダウンロード#

各スタイルは、そのページのDownload ▾メニューから、人とエージェントの両方が読めるDESIGN.md仕様として書き出せます。

DESIGN.mdファイル

ひとつのMarkdownファイルで、YAMLフロントマターの後にデザイン要素ごとのセクションが続きます。正確なトークン値は本文に入り、構造は次のとおりです。初めての方は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アカウントではカスタムコネクタを1つ追加できます。）

Claude Code：CLIからサーバーを追加し、セッション内で/mcpを実行してOAuthログインを完了します。

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

Cursor#

Curioを~/.cursor/mcp.json（またはSettings → MCP）へ追加します。初回利用時にCursorがブラウザを開き、ログインを求めます。

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

VS Code (Copilot)#

Copilotエージェントモードで、Curioを.vscode/mcp.json（またはユーザーMCP設定）へ追加します。初回接続時に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へ進み、サーバーURLhttps://mcp.designbycurio.com/mcpを入力します。

その他のクライアント#

OAuthを使うリモートStreamable 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_style1スタイルのメタデータ＋プレビュー画像Free
get_style_spec完全なデザイン仕様。有料スタイルはPro/Maxが必要1クレジット
get_quota現在の期間の残り上限Free

自然な言葉で頼むだけです。例：「Bauhausスタイルを探して、スライドに適用して」。エージェントが検索し、仕様を取得して適用します。

ログインと権限#

OAuth、APIキー不要。接続とはログインすることです。CurioはDynamic Client Registrationを備えた標準OAuthを使うため、キーやトークンの作成、貼り付け、ローテーションは不要です。

読み取り専用。接続先はデザインライブラリだけです。ファイル、リポジトリ、データには一切触れません。

いつでも解除できます。アカウントの接続済みアプリページで管理できます。解除すると、そのクライアントのアクセスは直ちに無効になります。

課金と上限#

共有リンク、MCP取得、ダウンロードは、すべて同じクレジットと利用制限を共有します。プランと料金は料金ページをご覧ください。

クレジットの消費対象

スタイルの完全な仕様を解放すると1クレジットを消費します。MCP経由のget_style_spec、ダウンロード、共有リンクの生成が対象です。検索、一覧表示、メタデータの参照、get_quotaは無料です。15分以内に同じスタイルを再度解放した場合は、同じクレジットが再利用されます。

Freeアカウントでも使えますか？

はい。接続してライブラリ全体を検索・閲覧し、上限内でFreeスタイルを解放できます。有料スタイルにはProまたはMaxが必要で、プランなしで解放するとtier_deniedエラーが返ります。

上限に達したら？

解放時にはquota_exhaustedが返ります。ProとMaxの上限はローリング方式の7日間枠で回復します。Freeのクレジットは生涯1回限りなので、さらに解放するにはアップグレードが必要です。閲覧、検索、メタデータの参照は引き続き利用できます。

© 2026 Curio Design