Clunk 연결 서버
AI 도구 연결(MCP)v0.1.0생성 직후,
에이전트가 검사합니다.
Clunk가 직접 운영하는 HTTP MCP를 한 번 연결하면 Claude Code, Codex, Cursor, GitHub Copilot, Claude Desktop, VS Code가 이 웹사이트와 똑같은 검사 규칙을 쓰고, 똑같은 검사 기록을 받아 갑니다.
웹으로 바로 쓰는 도구 7개내 컴퓨터에서 쓰는 도구 7개원본 파일 덮어쓰기 0
보기
단계
clunk-messy-sample.glb1,124 B · 181473ff49e2…
검사 완료검사 결과를 바로 읽습니다.
파일 검사 점수와 발견된 문제를 실제 샘플 수치로 보여 줍니다. 엔진에서 찍은 화면이 없으면 그 빈칸을 그대로 남깁니다.
근거
파일 읽기 · 규칙 · 발견 사항파일 검사통과
99/100 · 막는 문제 0건엔진 화면증거 없음
엔진에서 찍은 화면 필요게임 화면확인 전
실제 게임 화면 전사람 검토확인 전
사람이 직접 봐야 합니다연결 주소/api/mcp웹으로 바로 연결합니다
인증내 계정 전용 키로그인 후 키 발급
쓸 수 있는 도구HTTP 원격 도구 7개내 컴퓨터의 파일을 직접 읽고 쓰는 일은 로컬 stdio 도구 7개가 맡습니다. 그 도구는 내 컴퓨터에 설치해야 씁니다.
한 번 연결하면 다섯 종류에이전트가 부르면
이 흐름으로 들어옵니다.파일은 내 컴퓨터에서 열거나, 직접 올려서 시작합니다.
이 흐름으로 들어옵니다.파일은 내 컴퓨터에서 열거나, 직접 올려서 시작합니다.
PIXELSPRITEUI PREVIEW
cell · pivot · hitbox
REGIONSATLASUI PREVIEW
page · regions · trim
RIGSPINEUI PREVIEW
bones · slots · clips
CLIPMOTIONUI PREVIEW
duration · loop · root motion
SCENEGLBUI PREVIEW
mesh · material · bounds
연결하기 전에 결과부터에이전트가 부르면
에이전트가 부르면
이 결과가 돌아옵니다.
아래는 미리 준비된 예시라 크레딧이 들지 않습니다. 엔진 화면과 사람의 검토는 따로 남습니다.
실제로 배포된 예시 파일clunk-messy-sample.glb
2D이미지 · 스프라이트 시트지원 형식 · 화면 예시
2D본 애니메이션 · 움직임지원 형식 · 화면 예시
실제 예시clunk-messy-sample.glb파일 크기 1,124B
01원본 파일은 그대로 둡니다.해시 · 용량 · 출처를 함께 기록
실제 파일에서 시작합니다파일 검사통과파일 내용 · 지문 · 규칙 엔진 화면증거 없음엔진에서 찍은 화면 필요 게임 화면확인 전실제 게임 화면 전 사람 검토확인 전사람 검토 대기
실제 파일에서 시작합니다.
Clunk에 들어 있는 GLB 파일을 그대로 씁니다. 이 예시의 파일과 지문은 고정되어 있고, 예시가 통과했다고 해서 내 파일이 통과한 것은 아닙니다.
네 단계면 끝납니다연결은 짧고,
연결은 짧고,
결과는 실제여야 합니다.
키를 발급하고, 설정을 복사하고, 서버가 실제로 응답하는지까지 확인합니다.
- 011. 키 발급내 계정 전용 키를 한 번 받습니다
- 022. 클라이언트 선택쓰는 도구를 고릅니다
- 033. 설정 복사연결 주소와 키가 채워진 설정을 붙여 넣습니다
- 044. 연결 확인서버가 실제로 응답하는지 확인합니다
쓰는 도구 설정쓰는 도구를 고르면
쓰는 도구를 고르면
설정이 완성됩니다.
선택한 클라이언트에 그대로 붙여 넣을 설정을 복사합니다. 인증에 실패하면 실패한 사실도 화면에 그대로 남습니다.
서버 이름과 MCP protocol 응답을 확인합니다.
키 발급 후 실제 도구 목록을 요청합니다.
이 핸드셰이크 PASS는 구조/연결 확인이며 player-facing 승인이 아닙니다.
2. 클라이언트 선택선택한 클라이언트: Claude Code
Clunk가 발급한 연결 키와 HTTPS endpoint를 그대로 등록합니다. 로컬 경로 치환이 없습니다.
원격 MCP · 권장
Clunk 연결을 한 줄로 완료
Clunk가 발급한 연결 키와 HTTPS endpoint를 그대로 등록합니다. 로컬 경로 치환이 없습니다.
키 발급 후 바로 연결
terminal‘Clunk 연결 키 만들기’를 누르면 이 설정에 실제 endpoint와 Bearer 키가 자동으로 채워집니다.이 공개 예시의 ${CLUNK_API_KEY}를 Clunk에서 발급한 연결 키로 바꾼 뒤 실행하세요.
에이전트가 부를 수 있는 도구연결하면 바로 쓰는
연결하면 바로 쓰는
7개 도구
만들기·검사하기·기록 연결이 같은 규칙을 씁니다. 웹으로 연결한 쪽은 내 컴퓨터의 파일 경로를 읽지 않습니다.
clunk_connection_check인증·endpoint·원격 기능이 실제 응답하는지 확인합니다.넣는 것 Bearer key · 나오는 것 connection, endpoint, capabilitiesclunk_asset_inspectbase64 파일 또는 안전한 multi-file bundle을 구조적으로 검사합니다.넣는 것 bytesBase64 또는 files[], targetProfileId (예: harvest-frontier-web-three) · 나오는 것 AssetEvidence, findings, hashesclunk_asset_validate업로드한 바이트를 선언된 프로파일 정책과 대조합니다.넣는 것 bytesBase64 또는 files[], targetProfileId (예: harvest-frontier-web-three) · 나오는 것 valid, score, hardBlockers, observationsclunk_asset_inspection_evidence검증된 v2 evidence를 받아 구조·런타임·사람 판정을 분리합니다.넣는 것 clunk.asset-inspection-evidence.v2 · 나오는 것 identity, qualityPolicy, findings, review statesclunk_collaboration_appendframe manifest를 append/replace로 협업 스레드에 기록합니다.넣는 것 threadId, evidenceMode, frame manifest · 나오는 것 normalized evidence, freshness, review statesclunk_scene_reviewframe manifest의 scene gap과 shipped evidence를 정규화합니다.넣는 것 manifest (HTTP는 local path를 dereference하지 않음) · 나오는 것 scene review, linked assets, visualRuntime/playerFacing/humanDecisionclunk_sprite_sheet_review선언된 Pixi sprite-sheet manifest를 정규화합니다. 실제 파일 재해시는 local CLI에서 수행합니다.넣는 것 manifest (HTTP는 local path를 dereference하지 않음) · 나오는 것 pixel contract, quality, readiness, review states결과를 바르게 읽는 법파일 검사 통과와
파일 검사 통과와
화면 통과는 다릅니다.
Clunk의 검사 규칙(clunk-game-ready-v1)이 확인하는 것은 파일 내용과 구조, 규칙 위반입니다. 엔진에서 실제로 그린 화면과 사람의 판단은 자동으로 통과가 되지 않습니다.
규칙과 상태 보기PixiJS 2DHarvest Frontier Web / Three.jsGodot 4Unity EditorUnreal Engine
사람 검토로 넘기기자동으로 나온 결과를
자동으로 나온 결과를
사람의 검토로 보냅니다.
예시가 통과했거나 파일 검사가 통과했다고 해서 게임에 넣어도 된다고 말하지 않습니다. 엔진에서 찍은 최신 화면과 사람의 결정을 따로 붙입니다.
돌려 보지 않은 엔진은 "확인할 환경 없음"으로 남고, 통과로 바뀌지 않습니다.파일 검사통과
엔진 화면증거 없음
게임 화면확인 전
사람 검토대기
다음실제 에셋을