AI 에이전트 & 개발자

모델 선택은 에이전트에게 맡기세요.

Codels의 모든 모델에는 기계가 읽을 수 있는 쌍둥이가 있어요. API 키 불필요, CORS 허용, 고정 URL. 모델 페이지에서 AI 에이전트용 복사를 누르거나, 에이전트에게 https://codels.download/llms.txt 주소를 알려 주고 스스로 검색하게 하세요.

“AI 에이전트용 복사”가 클립보드에 넣는 내용

Add the 3D model "Pine Tree" from the Codels library to this three.js project.

1. First read the agent page (preview image, size, parts and ready-to-use code):
   https://codels.download/m/pine-tree.md?snow=true
2. Then integrate it:
   - Preferred: ES module https://codels.download/m/pine-tree.js?snow=true — exports createPineTree(): THREE.Group …
   - Or the binary glTF: https://codels.download/m/pine-tree.glb?snow=true
   - React Three Fiber component: https://codels.download/m/pine-tree.jsx?snow=true

Conventions: meters, +Y up, front faces +Z, origin at the center of the base (y = 0).

떠 있는 모델(픽업 아이템, 행성)은 원점을 중심으로 배치되고, 벽걸이 소품은 뒷면이 z = 0 평면에 놓여요 — 모든 에이전트 페이지에 정확한 원점이 나와 있어요.

MCP 서버

Claude Code, Cursor, Windsurf 등 모든 MCP 클라이언트에 Codels를 연결하세요. 에이전트는 6가지 도구를 쓸 수 있어요: search_models, get_model (에이전트가 실제로 볼 수 있는 4방향 미리보기 이미지 반환), get_model_code, list_packs, get_pack, list_categories.

claude mcp add --transport http codels https://codels.download/mcp

다른 클라이언트 (예: Cursor mcp.json):

{
  "mcpServers": {
    "codels": {
      "url": "https://codels.download/mcp"
    }
  }
}

엔드포인트

/m/<slug>.md

에이전트 페이지: 설명, 미리보기 이미지, 크기, 파트 표, 파라미터, 전체 three.js 코드 — 한 번의 요청으로 모든 걸 얻어요.

/m/<slug>.js

create<Name>(): THREE.Group을 내보내는 ES 모듈. three 외에는 의존성이 없어요.

/m/<slug>.jsx

React Three Fiber 컴포넌트.

/m/<slug>.instanced.js

인스턴싱 모듈: bake<Name>()(머티리얼당 지오메트리 1개) + create<Name>Instances(count, place)로 수백 개의 복사본을 적은 드로우 콜로 그려요.

/m/<slug>.html

단독 실행 가능한 데모 페이지 (CDN의 three.js 사용).

/m/<slug>.png · .sheet.png

미리보기 렌더 / 4방향 시트 (3/4, 정면, 측면, 위) — 에이전트가 모델을 “볼” 수 있어요.

/m/<slug>.glb · .gltf · .obj · .stl · .json

바이너리/JSON glTF, 버텍스 컬러 포함 OBJ, STL, 원본 CodelSpec.

/api/v1/models?q=&category=&tags=&sort=

패싯 검색. 모든 결과의 URL을 반환해요.

/api/v1/models/<slug> · /api/v1/tags · /api/v1/categories

메타데이터, 개수 포함 태그 조회, 카테고리 트리.

/c/<pack>.md · .js · .zip · .json

팩과 공개 컬렉션: 에이전트 개요, 모든 모델이 담긴 단일 ES 모듈, 또는 GLB + 모듈 ZIP.

/llms.txt

이 사이트에 대한 기계 판독용 가이드.

/mcp

검색, 미리보기, 코드 도구를 갖춘 Model Context Protocol 엔드포인트 (Streamable HTTP).

파라메트릭 변형

파라메트릭 모델은 모든 URL에서 쿼리 문자열로 파라미터를 받아요. .md 페이지에 각 파라미터와 범위가 나와 있어요.

// fetch a taller pine with snow caps as a ready ES module
const src = await fetch('https://codels.download/m/pine-tree.js?height=5.5&snow=true').then((r) => r.text());

코드 사용하기

import * as THREE from 'three';
import { createPineTree } from './pine-tree.js';

const forest = new THREE.Group();
for (let i = 0; i < 40; i++) {
  const tree = createPineTree();
  tree.position.set((Math.random() - 0.5) * 60, 0, (Math.random() - 0.5) * 60);
  tree.rotation.y = Math.random() * Math.PI * 2;
  tree.scale.setScalar(0.8 + Math.random() * 0.5);
  forest.add(tree);
}
scene.add(forest);

코드에서 검색하기

const res = await fetch('https://codels.download/api/v1/models?q=medieval+barrel&sort=relevance');
const { items } = await res.json();
console.log(items[0].urls.code); // → https://codels.download/m/<slug>.js

요청 한도 & API 키

키가 없어도 모든 기능을 쓸 수 있어요(IP당 분당 API 요청 120건). 더 많이 쓰려면 무료 API 키를 만드세요: 분당 1,200건의 요청과 사용 통계를 제공해요. 키는 Authorization: Bearer cdl_… 형태로 보내세요 — 응답에는 X-RateLimit-Remaining이 포함되고, 429 응답은 언제 다시 시도하면 되는지 알려 줘요.

curl -H "Authorization: Bearer cdl_your_key" "https://codels.download/api/v1/models?q=barrel"
claude mcp add --transport http codels https://codels.download/mcp --header "Authorization: Bearer cdl_your_key"