개발자를 위한 KURV

KURV 컬렉션을 내 앱, 웹사이트, 에이전트 워크플로에 가져오세요. 컬렉션 상태는 공개 컨트랙트에 담겨 있어요. HTTP API는 컬렉션 설정과 체인에서 읽은 값을 제공하고, 위젯은 임베드한 곳 어디서든 컬렉션을 보여 주며, MCP는 승인받은 에이전트가 크리에이터를 위해 제너러티브 컬렉션을 준비할 수 있게 해 줘요.

연동 방식 고르기

하고 싶은 일	시작할 곳
에이전트를 연결하고 컬렉션 준비하기	MCP로 에이전트 연결하기
컬렉션, 민팅 수, 컨트랙트 정보 읽기	공개 API
다른 사이트에 컬렉션 아트와 Mint 버튼 넣기	컬렉션 임베드
내 지갑 커넥터로 민팅 경험 만들기	내 사이트에서 민팅하기

엔드포인트와 네트워크

이 개발자 연동은 Base Sepolia, 체인 ID 84532만 사용하고, 다른 네트워크는 쓰지 않아요.

진입점	주소
원격 MCP 엔드포인트	https://mcp.kurv.fun/mcp
공개 API 탐색	https://testnet.kurv.fun/api/v1
컬렉션 카탈로그	https://testnet.kurv.fun/api/v1/collections
KurvDrop ABI	https://testnet.kurv.fun/api/v1/contracts/kurvdrop
연동 플레이그라운드	개발자를 위한 KURV

mcp.kurv.fun은 기계가 쓰는 서비스 엔드포인트예요. 연결 방법, 도구 안내, 연동 예시는 이 문서에 있어요. API와 iframe 읽기는 공개되어 있고, 계정이나 API 키가 필요 없어요. 에이전트 커넥터는 OAuth로 특정 KURV 계정을 승인해요.

에이전트로 만들기

1. OAuth를 지원하는 원격 MCP 클라이언트에 https://mcp.kurv.fun/mcp를 추가하세요.
2. KURV에 로그인하고 클라이언트가 요청한 권한을 승인하세요. 컬렉션 쓰기와 런칭 준비에는 기존 초대가 필요해요.
3. 에이전트에게 빌더 스키마를 확인하고, 컬렉션을 검증하고, 고정된 재시도 키로 내 소유의 초안을 만들어 달라고 하세요.
4. 위치가 맞춰진 실제 PNG, JPEG, WebP 특성 이미지를 올리세요. 커넥터는 작품 최대 1,000개, 특성 이미지 하나당 2 MiB까지 지원해요. 확인할 수 있도록 특성 레시피와 희귀도를 돌려줘요.
5. 런칭을 준비하고, 돌아온 검토 URL을 직접 여세요. 실제 아트를 검토하고 가져온 다음, KURV에서 렌더링하고 공개하고, 지갑 트랜잭션을 승인하세요.

커넥터에는 도구 열한 개, kurv://builder-guide 리소스, build-kurv-collection 프롬프트가 있어요. 이것들이 새로 모델을 학습시키지 않아도 에이전트에게 작업 흐름을 알려 줘요. 에이전트는 초안을 만들고 준비하며, 지갑 승인은 크리에이터의 몫으로 남아요. 컬렉션은 kurv_prepare_launch가 링크를 돌려줄 때가 아니라, 배포 트랜잭션이 확정된 뒤에 배포된 거예요.

권한, 정확한 도구 입력, 재시도 동작, 지원하는 아트와 판매 방식은 MCP로 에이전트 연결하기를 참고하세요.

다른 곳에서 보여 주고 민팅하기

컬렉션 위젯은 실제 아트나 공개 티저를 보여 주고, 확정된 민팅 수를 업데이트해요. 위젯의 Mint 버튼은 구매자의 계정과 지갑 승인을 위해 별도 탭에서 KURV를 열어요. 이 넘김 방식은 iframe 안의 계정 쿠키에 기대지 않고 작동해요.

내 사이트 안에서 바로 민팅하려면, 컬렉션의 컨트랙트 주소와 공개 ABI를 내 지갑 커넥터와 함께 쓰세요. 새 시세를 읽고, 필요한 컬렉션 코인과 추가 코인을 승인하고, 민팅을 시뮬레이션한 다음 트랜잭션 영수증을 기다리세요. 내 사이트에서 민팅하기에서 정확한 호출과 함께, 공개 단계, 비용 상한, 경매 모듈을 어떻게 다루는지 보여 줘요.

컬렉션 수치에는 읽은 시각이 함께 붙어요. 오래된 수치는 이전에 확정된 스냅숏이에요. 리빌되지 않은 컬렉션의 비공개 메타데이터와 아트 루트는 계속 공개되지 않아요. 컨트랙트 규칙, 수수료, 컬렉션의 조건은 모든 연동에 적용돼요. 수수료와 리스크 및 면책 조항을 읽어 주세요.