SolidCraft 독립 커뮤니티 가이드
Claude와 내 CAD 도구를 연결하세요.
SolidCraft 내장 MCP 서버로 호환되는 AI 클라이언트에서 로컬 CAD 도구를 사용할 수 있습니다. Claude Code 또는 Claude Desktop용 JSON을 준비한 뒤 내 컴퓨터에 적용하세요. 창 없는 Headless 세션과 실행 중인 데스크톱 앱 연결 중 선택할 수 있습니다.
먼저 준비하세요: AI 클라이언트에서 실행할 수 있는 SolidCraft CLI와 사용할 Claude 클라이언트가 필요합니다. 데스크톱 연결에는 데스크톱 앱도 필요합니다.
공식 설치 안내설정은 현재 브라우저에서 생성합니다.
CLI 경로와 생성한 JSON은 통계 이벤트에 포함하지 않습니다.
{
"mcpServers": {
"solidcraft": {
"command": "solidcraft-cli",
"args": [
"mcp"
]
}
}
}
설정 파일을 준비하는 도구입니다. 소프트웨어 설치, 기존 설정 병합과 MCP 연결은 내 컴퓨터에서 진행하세요. 파일이 mcp.json으로 저장되면 사용 전에 .mcp.json으로 이름을 바꾸세요. 처음 저장하거나 내보내기 전에 폴더 접근 권한을 설정하세요.
내 컴퓨터에서 마무리하기
설정 적용 대상: Claude Code.
- 프로젝트 최상위 폴더에
.mcp.json으로 저장하세요. 파일 이름 앞의 점이 빠졌다면mcp.json을.mcp.json으로 바꾸세요. 기존 서버가 있다면mcpServers객체에solidcraft항목만 병합하세요. - 해당 프로젝트에서 Claude Code를 열고 안내에 따라 MCP 서버를 확인하고 승인하세요. 필요하면 세션을 다시 시작하세요.
- 실행할 명령:
/mcpClaude Code에서 서버 상태와 도구 목록을 확인하세요. 서버가 시작되지 않으면 CLI 설치 여부와 경로를 확인하세요.
기본 Headless 서버를 터미널 명령으로 등록하기
claude mcp add solidcraft -- solidcraft-cli mcp프로젝트 JSON 설정과 아래 명령 중 하나를 선택하세요. 이 명령은 Claude Code의 기본 로컬 범위를 사용하며 공유 .mcp.json이나 폴더 권한을 만들지 않습니다. 저장과 내보내기 전 파일 접근 권한 설정 을 확인하세요.
실행 방식 선택
별도 세션으로, 또는 화면을 보면서.
MCP 서버는 내 컴퓨터에서 실행합니다. AI 클라이언트의 이용 조건, 비용과 데이터 처리 조건은 별도로 적용됩니다.
Headless: 창 없는 세션
solidcraft-cli mcp데스크톱 창과 독립된 모델링 세션을 사용합니다.
데스크톱 앱 연결
solidcraft-cli mcp --connect 127.0.0.1:7878제어 인터페이스를 켠 데스크톱 앱에 연결해 모델이 만들어지는 과정을 화면에서 확인합니다.
자주 묻는 질문
MCP 연결 문제 해결
CLI를 찾을 수 없다고 나와요.
설치 파일에 CLI가 포함되어 있는지 확인하고 바깥쪽 따옴표 없이 절대 경로를 입력하세요. 바로가기가 있어도 PATH 등록이 된 것은 아닙니다. Snap과 Flatpak 경로도 확인하세요.
연결은 됐는데 저장이 안 돼요.
실제 폴더가 존재하고 --allow-path 인수에 등록되어 있는지 확인하세요. 수정 후 서버를 다시 시작하세요.
데스크톱 앱 연결이 응답하지 않아요.
같은 컴퓨터에서 제어 인터페이스를 실행하고 양쪽 포트를 맞추세요. MCP가 먼저 시작되더라도 앱이 연결을 받을 때까지 모델링 명령은 실패할 수 있습니다.
이 페이지에서 내 컴퓨터에 직접 연결하나요?
설정 텍스트만 브라우저에서 만듭니다. 설치, JSON 적용과 서버 확인은 내 컴퓨터에서 진행하세요. CLI 경로와 JSON은 사이트 통계 이벤트에 넣지 않습니다.
출처 확인
공식 문서를 바탕으로 안내합니다.
확인일 . 소프트웨어 버전에 따라 동작이 달라질 수 있습니다. 시작 전에 최신 공식 문서와 사용 중인 버전을 확인하세요.