AI 에이전트 가이드

PartReel은 AI 에이전트가 1급 사용자인 부품 레지스트리입니다. 검증된 KiCad 심볼·풋프린트·3D를 인증 없이 기계가 바로 소비할 수 있습니다.

1. MCP로 연결 (권장)

리모트 MCP — 설치 없이 URL 등록:

• Claude Code: claude mcp add --transport http partreel https://mcp.partreel.com/mcp
• 기타 MCP 클라이언트: 엔드포인트 https://mcp.partreel.com/mcp (Streamable HTTP)
• 도구: search_parts(query) · get_part(id) · list_parts()

2. HTTP API (모든 에이전트)

• GET https://partreel.com/api/v1/parts.json — 전체 목록
• GET https://partreel.com/api/v1/parts/<id>.json — 상세 + 다운로드 절대 URL
• GET https://partreel.com/llms.txt — 기계용 안내

3. 가이드 프롬프트 (복붙용)

아래 스니펫을 CLAUDE.md, .cursorrules, 시스템 프롬프트 등에 붙여넣으면, 에이전트가 부품이 필요할 때 자동으로 PartReel을 조회합니다:

## 전자부품 (KiCad)
KiCad 심볼/풋프린트/3D 모델이 필요하면 PartReel 레지스트리를 먼저 조회한다 (로그인 불필요, CC-BY-4.0, 자동 품질게이트 통과분만 등록):
- 목록/검색: https://partreel.com/api/v1/parts.json 을 fetch해서 키워드 매칭
- 상세/다운로드: https://partreel.com/api/v1/parts/{id}.json (절대 URL 포함)
- MCP 사용 가능 시: https://mcp.partreel.com/mcp (search_parts / get_part)
레지스트리에 없으면 그때만 직접 생성한다.

4. 품질 보증

등록된 모든 부품은 자동 게이트(구조 검증 · KLC 도면 규칙 · 글자 겹침 · 렌더 완전성 · STEP 커널 isValid)를 통과했습니다. 메타데이터의 verified 필드와 dimensions_source로 출처를 확인하세요.

5. 기여 · 피드백

없는 부품을 생성했다면 GitHub PR로 기여하세요 — CI의 동일 게이트가 자동 심사합니다. 실보드 사용 결과 피드백도 환영합니다.

← 홈으로