NexyFab 설계 파이프라인(텍스트→2D도안→3D 1차→2차→부품 단위 수정)을 HTTP API, MCP(Claude 등 AI 클라이언트), CLI로 사용할 수 있습니다. AI는 이해만 담당하고 형상 생성·검증(어휘·간섭·지지·구조 게이트)은 결정론 엔진이 수행합니다. 모든 산출물은 비법정(제작용 실시도서+검토 계산서)이며, 인허가 제출 도서는 유자격 기술사 날인 영역입니다.
핵심 엔드포인트(모두 POST · JSON). 응답의 assembly 객체를 다음 호출에 그대로 전달하면 수정 체인이 이어지고, 편집마다 REV 이력이 자동 축적됩니다.
| Endpoint | 기능 |
|---|---|
| /api/nexyfab/drawing/assemble | 자연어 → 다부품 어셈블리(게이트·1차 골격 draft 동봉) |
| /api/nexyfab/drawing/compose | 자연어 → 단일 부품 intent+SCAD |
| /api/nexyfab/drawing/edit-part | 🎯 선택 부품만 AI 수정(대상 외 불변 보장) |
| /api/nexyfab/drawing/face-drag | 면 푸시풀/치수 지정(AI 없음·결정론) |
| /api/nexyfab/drawing/part-op | 복제·삭제·이동·필렛(결정론) |
| /api/nexyfab/drawing/export-step | B-rep STEP 내보내기 |
| /api/nexyfab/drawing/package | 실시 도서 세트(GA·부품도·BOQ·사양서·DXF) |
# 1) 생성
curl -s https://nexyfab.com/api/nexyfab/drawing/assemble/ \
-H "Authorization: Bearer nf_live_XXXX" -H "Content-Type: application/json" \
-d '{"description":"베이스 플레이트 1000x800x20 위에 지름 200 높이 400 원통 기둥 2개"}' > r1.json
# 2) 부품만 수정 (r1.json 의 .assembly 를 그대로)
curl -s https://nexyfab.com/api/nexyfab/drawing/edit-part/ \
-H "Authorization: Bearer nf_live_XXXX" -H "Content-Type: application/json" \
-d "{\"assembly\": $(jq .assembly r1.json), \"partId\":\"column_1\", \"instruction\":\"높이를 600으로\"}"
# 3) 면 치수 직접 지정 (결정론 — AI 미사용)
# face: x±/y±/z± (box) · axis±/radial (회전체)
curl -s https://nexyfab.com/api/nexyfab/drawing/face-drag/ \
-H "Authorization: Bearer nf_live_XXXX" -H "Content-Type: application/json" \
-d '{"assembly": {…}, "partId":"column_1", "face":"axis+", "targetMm":600}'단일 파일 MCP 서버를 내려받아 등록하면 Claude가 도구 호출로 설계·수정합니다(Node 18+, 의존성 없음). 도구 5종: design_assembly · compose_part · edit_part · face_drag · part_op.
# Claude Code 등록 (API 키는 Pro 이상 발급)
claude mcp add nexyfab -e NEXYFAB_API_KEY=nf_live_XXXX -- node /절대경로/nexyfab-mcp.mjs
# 이후 Claude 에게:
# "nexyfab 으로 1000x800 베이스에 기둥 2개 조립체 만들고, column_1 높이를 600으로 수정해줘"저장소의 scripts/drawing-to-3d/cli.mjs 는 MCP와 동일한 도구면을 명령행으로 제공합니다(로컬 엔진 실행 — 저장소 보유 시). NEXYFAB_API_KEY 를 설정하면 생성·수정 5종은 호스팅 API 로 호출됩니다(원격 모드). 파이프에 물리면 순수 JSON, 터미널에선 요약 라인이 함께 출력됩니다.
export NEXYFAB_API_KEY=nf_live_XXXX # 원격 모드(Pro) — 미설정 시 로컬 엔진
node cli.mjs assemble "베이스 플레이트 위 기둥 2개" --out asm.json
node cli.mjs face-drag asm.json column_1 --face axis+ --target 600 --out asm.json
node cli.mjs part-op asm.json --op duplicate --ids column_1 --offset 300,0,0 --out asm.json
node cli.mjs package asm.json --out ./도서 --step # GA·부품도·BOQ·사양서·DXF·STEP
node cli.mjs list # 도구 21종 목록AI 생성 계열은 플랜 슬롯·일일 비용 한도를 따릅니다(결정론 연산인 face-drag·part-op 는 슬롯 미소모, 레이트리밋만). 게이트가 거부하면 형상을 조용히 바꾸지 않고 이유와 함께 422로 거부합니다. 자유곡면(mesh)은 생성기 파라미터 재생성으로만 수정됩니다(정점 직접 수정 비지원 — 제작 추적성).