コレクション・ブループリント

KURV は現在、Base Sepolia と Solana Devnet で動いています。このページは、完成した実際のビルド（HANI the Dog、1,000 点、ユニーク 20 点）から生まれた現場のガイドで、https://mcp.kurv.fun/mcp の KURV コネクターを通じて AI エージェントと一緒に作業するクリエイターのために書かれています。コネクターは同じガイドをリソース kurv://blueprint としてエージェントに提供し、ツール kurv_builder_spec が正本です。このページとツールが食い違うときは、ツールを信じてください。

エージェントを接続する

1. リモート MCP と OAuth に対応したクライアントに、https://mcp.kurv.fun/mcp をリモート MCP サーバーとして追加します。MCP でエージェントを接続するに、クライアントとその手順の一覧があります。
2. ブラウザーで KURV にログインし、接続を承認します。接続にできること（読み取りのみ、読み取りと下書き、または読み取り、下書き、ローンチ準備）と、続く期間はあなたが選びます。
3. エージェントに kurv://blueprint を読むよう頼み、次にあなたのネットワークで kurv_account と kurv_builder_spec を呼ばせます。コネクターはプロンプト build-kurv-collection も提供しており、承認の停止点をすべて守りながら、このページに沿ってエージェントを進めます。

誰が何をするか

エージェントは、計画し、検証し、下書きを作り、アートをアップロードし、プレビューし、ローンチを準備します。あなたはアート、サンプル、すべての警告を承認し、確認リンクを開いて、自分のウォレットでローンチに署名します。エージェントはデプロイせず、署名せず、秘密鍵やシードフレーズを求めることもありません。アートが完成して承認されたら、KURV 側の作業（検証、作成、アップロード、プレビュー、準備）は約 20 分です。良いアートをつくるにはもっと時間がかかりますし、それが本来です。

上限

項目	上限
コレクションのサイズ	1 から 1,000 点、ユニークを含みます。ランダム 980 点とユニーク 20 点で、サイズは 1,000 です。
レイヤー	最大 12。
トレイト画像	すべてのレイヤーを合わせて最大 240 枚、ユニークだけが使うアートも含みます。空のレイヤーには費用がかかりません。
ユニーク	最大 32。
ルール	最大 48、どのネットワークでも同じです。
画像のファイルサイズ	1 枚ずつ送る画像は最大 2 MiB。zip の中の 1 枚の画像は最大 20 MiB。
キャンバス	正方形、最大 2,048 × 2,048 ピクセル。すべてのファイルがキャンバスとちょうど同じサイズです。
形式	背景: PNG、JPEG または WebP。ほかのすべてのレイヤー: 本物の透過を持つ PNG。
None という名前	大文字小文字を問わず予約されています。None という名のトレイトも、空の画像も作らないでください。レイヤーは noneWeight で任意になります。
説明	必須として扱います: 1 から 2,000 文字。すべての作品のメタデータに入ります。
下書き	アカウントごとに有効なものを 20。kurv_archive_draft はすぐに枠を空け、アーカイブした下書きのアートは 30 日間保持されたのち削除されます。
プレビュー	1 回の呼び出しで、ランダムなサンプル最大 9 点、または選んだ作品番号最大 9 点、64 から 512 ピクセルで。

エージェントは、検証のたびに validCombinations を読みます。レイヤーとルールが許す、異なる作品の数です。約 50 百万通りまでの空間は正確に数えられ、それを超えると推定値であることが示されます。コレクションのサイズより十分に大きく保ってください。

道筋、一歩ずつ

承認と記した手順では、エージェントは止まり、あなたのはっきりした「はい」を待ちます。

1. 写真。 実際のペットやキャラクターの鮮明な写真を 3 から 10 枚集めます: 顔、目、歯と口、模様、耳。顔が斜め四分の三の向きで写った主役の写真を 1 枚選びます。
2. アートの方向性。 スタイル 1 つ、ポーズ 1 つ（斜め四分の三が最もうまくいきます）、正方形のキャンバス 1 つ（2,048 × 2,048 を推奨）、短いスタイルシート: 線、陰影、パレット、雰囲気。承認: トレイトを作る前の、マスターキャラクター。
3. マスターベース。 最終ポーズのキャラクターを、平らな単色の背景に、中央に、キャンバスいっぱいのサイズで描き、実際のペットだとすぐにわかるものにします。すべてのトレイトはこのマスターの編集で、同じポーズ、縮尺、構図です。
4. レイヤー。 レイヤーは下から上へ描かれます: Background、Skin（ベースレイヤー）、Collar、Teeth、Eyes、Headwear（任意）。レイヤーは六つほど。コレクションを支えるのはキャラクターで、小道具ではありません。エージェントはベースレイヤーを base_layer で指定し、各レイヤーに、そのトレイトが収まるべきアンカーの枠を与えます。
5. トレイト。 各トレイトはマスターのコピーの編集で、トレイト自身のピクセルだけが見え、それ以外は透明になるように切り抜きます。体の単色コピーの上でトレイトを生成すると、毛が入り込みません。位置や縮尺がずれたトレイトは不合格です。
6. ユニーク。 全身が変身した体（ダイヤモンド、クローム、溶岩、ブロンズ）、それぞれに合わせた背景、首輪なし。そのアートは重み 0 のトレイトとしてそのレイヤーに入るので、ランダムな作品には決して現れません。240 枚の画像の数には含まれます。
7. ルール。 すべての肌と、すべての首輪、歯、目、かぶり物のトレイトを組み合わせたコンタクトシート。悪い組み合わせ（はみ出し、見えない、見苦しい）は、理由を記したメモ付きの、グループ化した除外ルールになります。
8. 承認: 下書きを作る前の、レイヤーシート、少なくとも 9 点の合成サンプル、ユニークのシート、設定、販売条件。
9. 設定と検証。 ネットワークを指定して kurv_builder_spec、次に設定で kurv_validate_collection を、issues の一覧にエラーがなくなるまで繰り返します。警告は、あなたが聞くべきことを名指しします。答えには、アップロードする正確なキーの required_assets と validCombinations が含まれます。
10. 下書き。 version: 3、ネットワーク、設定、販売条件、冪等キーを添えて kurv_create_collection を、まず check_only を true にして、次に本番で呼びます。失敗した呼び出しは同じキーで再試行します。販売条件はどのネットワークでも同じ形です: 販売条件をご覧ください。
11. アート。 kurv_upload_trait で 1 枚ずつ（背景、ベース、各レイヤー 1 トレイトを先に、次にプレビュー、それから残り）、または kurv_upload_collection_zip でウェブのフォルダー形式としてまとめて。空のレイヤーは noneWeight であり、透明な PNG ではありません。
12. 確認とプレビュー。 下書きを指定した kurv_validate_collection がアートの検査を実行します。最後のアップロードのあと、サンプル 9 点で kurv_preview_collection を呼び、さらにすべてのユニークと最も危険な組み合わせの作品番号を渡します。エージェントはすべての画像を見ます。長くかかる最初のプレビューは retry_after と保留中のサンプルを返し、エージェントはもう一度呼びます。
13. 新しい下書きなしの修正。 kurv_update_collection はルール、ユニーク、重み、ヒント、説明をその場で変えます。キャンバスは変えられません。kurv_replace_trait_image は 1 枚の画像を差し替え、kurv_rename_trait はトレイトの名前を変えてそのルールとユニークを更新し、kurv_delete_trait は何からも参照されないトレイトを削除します。そのあと、もう一度プレビューします。
14. 承認: 最終サンプルとすべての警告を、あなたに読み上げます。
15. 準備。 下書きを指定して kurv_prepare_launch。warnings_need_review が返ったら、エージェントは各警告を説明し、あなたが受け入れたあとにだけ、acknowledge_warnings を true にしてもう一度呼びます。ブラウザーのリンクが届きます。
16. 署名するのはあなたです。 1つのリンクを開き、入力内容を確認し、公開してローンチ を選び、最後のステップで自分のウォレットで署名します。どの回答も「戻る」1回の場所にあります。ツールがあなたの代わりに署名することはありません。

ルール

ルールは、2 つのレイヤーのトレイトを離すか、一緒にします: {"type", "when", "target", "note"} で、type は exclude または require、when と target はそれぞれレイヤーと、任意でトレイト（名前 1 つ、または名前の一覧）を指定します。トレイトがなければレイヤー全体を意味し、when と target は別のレイヤーでなければなりません。キーは trait です。traits と書いたルールは、正しいキーを示して拒否され、レイヤー全体に黙って適用されることはありません。None は、そのレイヤーの noneWeight が 0 より大きいときだけ、空のレイヤーを表せます。48 を超えないよう、組み合わせは一覧にまとめます: 肌のグループごとに 1 つのルールで、決して着けてはいけない首輪をすべて列挙します。

{"type": "exclude", "note": "Thick fur hides these collars", "when": {"layer": "Skin", "trait": ["Lion Mane", "Fire Fur"]}, "target": {"layer": "Collar", "trait": ["Bow Tie", "Name Tag"]}}

ルールは作品まで届きます。同じエンジンがプレビューと公開されるファイルを生成し、ミントはそのファイルを渡します。ユニークは ignoreRules を true にしてルールを飛ばせます。それでも一意性は保たれます。

ユニーク

ユニークは specials です: 名前、すべてのレイヤーとそのトレイトまたは None、任意の固定した作品番号、任意の説明。レイヤーを省いたユニークはそのレイヤーをランダムに受け取り、検証がどのレイヤーかを警告します。null は拒否され、存在しないトレイト名も拒否されます。

{"name": "Diamond Grail", "tokenId": 1, "traits": {"Background": "Diamond Vault", "Skin": "Pave Diamond", "Collar": "None", "Teeth": "Diamond Grill", "Eyes": "None"}}

人が欲しくなるアート

• 手をかけた、磨かれたアート。平板で、濁った、明らかに生成された見た目は避けます。
• 力強い背景: 大胆な色か、豊かな情景。場所をテーマにしたもの（都市、ビーチ）は、意図がなければ避けます。
• 斜め四分の三のポーズと、実際のペットだとわかる似姿: 模様、目の色、耳の形。
• キャラクターの体に合わせた大胆なトレイトを、マスターの形の上に描きます。歯は口にぴったり合わせます。
• 浮いたかぶり物はなし。帽子は接触の影とともに頭に乗り、大きな耳はつばの上に出ます。
• 服はたいてい動物に合いません。首輪、チェーン、首回りの飾りを選び、すべての肌で確かめます。
• 上位のユニークは全身が変身し、合わせた背景を持ち、首輪はありません。

コネクターは届いたアートをその場で検査します。エラーはアップロードを拒否します: キャンバスサイズの違い、背景より上で透過のない PNG でないレイヤー、見えるピクセルのない画像。警告は確認のためにあなたに返ります: アンカーの外にあるトレイト、レイヤーのほかと縮尺の違うトレイト、ベースのピクセルグリッドから外れたトレイト、ベースの絵を全部または一部そのまま持つトレイト、キャンバス全体を覆うトレイト。警告の 1 つは誤りのことがあります: サングラスと同じレイヤーにある自然な目は、意図して違うサイズです。エージェントはそのレイヤーに mixedScales を、またはあなたの同意のあとにそのトレイトに acknowledge を設定し、アートはあるべき姿のままです。

エージェントが読み返すもの

検証するツールはすべて、すべての問題を一度に 1 つの issues の一覧で答えます。それぞれにパス、コード、重大度、メッセージ、対処法があります。知らないキーは、最も近い正しいキーを示して名指しで拒否されます。ネットワークは名前で指定します（base-sepolia、solana-devnet、solana-localnet）。指定のない下書きは Base Sepolia を使い、そう告げます。販売方法はウェブサイトの名前を使います（fixed、mystery、rising、falling、auction）: コネクターを通じて、Base は fixed、mystery、rising を、Solana は fixed と rising を提供し、falling と auction の販売はウェブサイトで設定します。Solana のティッカーのように、ネットワークにない販売の項目は、名指しで拒否されます。メタデータは検証で証明されています: すべての作品がルールを守り、ユニークは固定された作品に置かれ、空のレイヤーは {"trait_type": "<layer>", "value": "None"} と書かれます。

完成した作品

すでに完成した画像として存在する作品はレイヤーを飛ばします: kurv_finished_art_limits、次にすべての画像と metadata.json に kurv_upload_finished_file_part、次に kurv_import_finished_collection。バイトはアニメーションも含めてそのまま保たれ、レイヤーの上限は適用されません。ウェブサイトの現在の公開上限が適用されます。完成した作品がファイルを説明します。

このビルドの既知の限界

• バージョン 2 の Solana の販売の値は、キーのあとにアプリ自身のパーサーが 1 つずつ検査します。バージョン 3 の販売は、すべての問題を一度に答えます。
• 完成した作品の下書きはその場で編集できません。修正は新しいアップロードと新しいキーです。
• アーカイブした下書きはコネクターから復元できません。アートは 30 日間保持されます。
• Robinhood Chain はコネクターから使えません: ネットワーク設定も販売スキーマもありません。Base と Solana のローンチのあとに来ます。

コレクションの数字はスナップショットで、ローンチはそのネットワーク上で実際の価値を動かします。お金について誰かに助言する前に、リスクと免責事項をお読みください。