Claude Desktop에서 QCAD 사용하기

소개

QCAD에는 MCP(Model Context Protocol) 서버가 포함되어 있습니다. MCP는 AI 어시스턴트가 다른 응용 프로그램에서 제공하는 도구를 사용할 수 있게 해 주는 개방형 표준입니다. QCAD MCP 서버를 사용하면 Claude Desktop 앱이 QCAD에서 현재 열려 있는 도면으로 직접 작업할 수 있습니다. 예를 들어 Claude에게 다음을 요청할 수 있습니다.

익숙하지 않은 도면과 그 레이어, 블록, 치수 및 텍스트 설명
닫히지 않은 폴리라인, 중복된 엔티티 또는 레이어 0의 지오메트리와 같은 문제가 있는지 도면 검사
거리, 길이 및 면적 측정
블록 참조로부터 부품 목록 작성
레이어, 선, 호, 원, 폴리라인, 텍스트, 치수 및 해치 추가
기존 엔티티의 이동, 회전, 축척, 트림, 라운드 또는 오프셋
도면을 PNG, PDF, SVG, DXF 또는 DWG로 내보내기

이 튜토리얼에서는 Windows 또는 macOS에서 QCAD를 Claude Desktop에 연결하는 방법을 설명합니다.

요구 사항

Claude Desktop과 같은 컴퓨터에 설치되어 실행 중인, MCP 플러그인이 포함된 QCAD
Windows 또는 macOS용 Claude Desktop 앱

Claude Desktop용 QCAD 확장 프로그램은 QCAD와 함께 제공됩니다. 이는 QCAD 설치 경로의 mcp 폴더에 있는 qcad.mcpb 파일입니다. 예:

Windows: C:\Program Files\QCAD\mcp\qcad.mcpb
macOS: /Applications/QCAD-Pro.app/Contents/Resources/mcp/qcad.mcpb

macOS에서는 이 폴더가 응용 프로그램 패키지 안에 있으므로 Applications 폴더를 열어도 Finder에 표시되지 않습니다. QCAD에서 기타 > MCP > Claude Desktop에 설치를 사용하면 파일을 열거나 표시해 줍니다(아래 참조).

Node.js를 별도로 설치할 필요는 없습니다. Claude Desktop에는 확장 프로그램을 실행하는 데 필요한 모든 것이 포함되어 있습니다.

QCAD에서 MCP 서버 시작하기

QCAD의 MCP 서버는 자동으로 시작되지 않습니다. 서버가 시작될 때까지 QCAD는 어떠한 연결도 받아들이지 않습니다.

QCAD를 시작합니다.
기타 > MCP > 시작을 선택합니다.

QCAD 창 아래쪽의 명령줄에 서버가 실행 중임을 확인하는 메시지가 표시됩니다.

MCP: MCP server running on port 3907 (http://127.0.0.1:3907/mcp)

서버는 기타 > MCP > 중지를 선택하거나 QCAD를 종료할 때까지 계속 실행됩니다. QCAD를 시작할 때마다 서버를 다시 시작해야 합니다.

기타 > MCP 메뉴에는 다음 항목도 있습니다.

Claude Desktop에 설치: Claude Desktop에 QCAD 확장 프로그램을 설치하는 과정을 도와줍니다(아래 참조)
상태: 서버가 실행 중인지, 어떤 포트에서 실행 중인지를 명령줄에 표시합니다
다시 시작: 서버를 중지했다가 다시 시작합니다(예: 포트를 변경한 후)

서버는 같은 컴퓨터(주소 127.0.0.1)로부터의 연결만 받아들입니다. 네트워크의 다른 컴퓨터에서는 서버에 접근할 수 없습니다.

Claude Desktop에 QCAD 확장 프로그램 설치하기

확장 프로그램은 한 번만 설치하면 됩니다. 시작하기 전에 Claude Desktop이 설치되어 있고 로그인되어 있는지 확인하십시오.

QCAD 확장 프로그램은 로컬 확장 프로그램입니다. Claude Desktop이 사용자의 컴퓨터에서 이 확장 프로그램을 실행하고, 확장 프로그램은 QCAD의 MCP 서버에 연결됩니다. 이를 위해 Claude에서 Add custom connector를 사용하지 마십시오. 사용자 지정 커넥터는 인터넷에서 https 주소로 접근할 수 있는 서버만 받아들이므로 QCAD의 주소 http://127.0.0.1:3907/mcp는 그곳에서 허용되지 않습니다.

Windows

QCAD에서 기타 > MCP > Claude Desktop에 설치를 선택합니다. QCAD가 파일 탐색기에서 qcad.mcpb 파일을 선택된 상태로 표시합니다. QCAD의 명령줄에도 설치 단계가 표시됩니다.
Claude Desktop에서 창의 왼쪽 위에 있는 메뉴를 열고 File > Settings를 선택합니다.
Extensions로 이동하여 Advanced settings를 열고 Install Extension을 클릭합니다.
qcad.mcpb 파일(예: C:\Program Files\QCAD\mcp\qcad.mcpb)을 선택합니다.

Windows에서는 qcad.mcpb 파일을 더블 클릭하거나 Claude Desktop 창으로 끌어다 놓지 마십시오. 어느 방법으로도 확장 프로그램이 설치되지 않습니다. Claude Desktop은 이 파일 형식에 자신을 등록하지 않으므로 더블 클릭하면 Windows가 파일을 열 앱을 묻기만 합니다.

macOS

QCAD에서 기타 > MCP > Claude Desktop에 설치를 선택합니다. QCAD가 qcad.mcpb 파일을 Claude Desktop에서 직접 엽니다.
Claude Desktop을 찾을 수 없는 경우 QCAD는 대신 Finder에서 파일을 표시합니다. 파일을 Claude Desktop 창으로 끌어다 놓거나, Claude Desktop의 메뉴 막대에서 Claude > Settings를 선택하고 Extensions로 이동하여 Advanced settings를 열고 Install Extension을 클릭한 다음 파일을 선택합니다.

설치 완료

Claude Desktop에 QCAD 확장 프로그램의 세부 정보가 표시됩니다. Install을 클릭하고 확인합니다.

설치가 끝나면 Settings > Extensions의 확장 프로그램 목록에 QCAD가 나타납니다. 활성화되어 있는지 확인하십시오.

확장 프로그램 설정

QCAD 확장 프로그램에는 세 가지 설정이 있으며, Claude Desktop의 Settings > Extensions > QCAD에서 변경할 수 있습니다. 일반적으로 기본값을 변경할 필요는 없습니다.

QCAD host: QCAD MCP 서버의 주소입니다. 127.0.0.1로 그대로 두십시오.
QCAD MCP port: QCAD MCP 서버의 포트이며, 기본값은 3907입니다. QCAD에 구성된 포트와 일치해야 합니다.
Reply timeout (ms): Claude가 QCAD의 응답을 기다리는 시간이며, 기본값은 60000 ms(1분)입니다. 매우 큰 도면으로 작업하는 경우 이 값을 늘리십시오.

Claude 및 QCAD로 작업하기

QCAD에서 도면을 열거나 새 도면으로 시작합니다.
MCP 서버가 실행 중인지 확인합니다(기타 > MCP > 상태).
Claude Desktop에서 새 채팅을 열고 필요한 것을 요청합니다. 예:

QCAD에 열려 있는 도면을 설명해 줘.

QCAD의 도면에 문제가 있는지 검사하고 발견한 내용을 나열해 줘.

도면의 블록 참조로부터 부품 목록을 작성해 줘.

새 레이어 "외곽선"에 100 x 50 mm 크기의 직사각형을 그리고 모든 모서리를 반지름 5 mm로 라운드 처리해 줘.

어떤 QCAD 도구를 사용할지는 Claude가 결정합니다. 도구가 처음 사용될 때 Claude Desktop이 사용자의 권한을 요청합니다. 도구를 한 번만 허용하거나 항상 허용할 수 있습니다.

Claude는 항상 QCAD에서 현재 활성화된 도면으로 작업합니다. 여러 도면이 열려 있는 경우 요청하기 전에 QCAD에서 올바른 도면으로 전환하십시오.

Claude가 변경한 내용은 QCAD 창에 즉시 나타납니다. 기존 엔티티를 수정 또는 삭제하거나, 레이어 이름을 바꾸거나, 사용하지 않는 레이어와 블록을 정리하는 도구는 Claude가 변경 내용을 적용하도록 명시적으로 요청하지 않는 한 무엇이 변경될지만 보고합니다. 변경 내용을 먼저 검토하려면 적용하기 전에 무엇을 할 것인지 보여 달라고 Claude에게 요청하십시오. 모든 변경 내용은 QCAD에서 편집 > 실행 취소로 되돌리거나 Claude에게 되돌려 달라고 요청하여 취소할 수 있습니다.

Claude는 도면을 볼 수도 있습니다. 도면을 이미지로 렌더링하여 도면에 무엇이 표시되는지 확인하거나 변경 결과를 검증합니다.

음성 모드

Claude Desktop의 음성 모드에서는 MCP를 사용할 수 없습니다. QCAD 도구는 텍스트 채팅에서만 사용할 수 있습니다. QCAD로 작업하려면 요청을 말하는 대신 입력하십시오.

개인 정보 보호

QCAD MCP 서버와 확장 프로그램은 사용자의 컴퓨터 안에서만 서로 통신합니다. 그러나 Claude가 도면에서 읽어 들이는 모든 내용(예: 레이어 이름, 텍스트, 치수, 좌표)은 채팅에서 공유하는 다른 콘텐츠와 마찬가지로 대화의 일부로 Claude에 전송됩니다. 컴퓨터 밖으로 나가서는 안 되는 도면에는 MCP 서버를 사용하지 마십시오.

문제 해결

Windows에서 qcad.mcpb를 열 앱을 묻는 경우

Windows용 Claude Desktop은 더블 클릭으로 .mcpb 파일을 열 수 없습니다. 대화 상자를 닫고 대신 위에서 설명한 대로 Claude Desktop의 File > Settings > Extensions > Advanced settings > Install Extension에서 파일을 설치하십시오.

Claude가 QCAD의 주소를 커넥터로 받아들이지 않는 경우

Claude의 Add custom connector는 인터넷에서 접근할 수 있는 서버에서만 작동합니다. QCAD는 위에서 설명한 대로 대신 QCAD 확장 프로그램을 통해 연결됩니다.

Claude가 “Cannot reach QCAD”를 보고하는 경우

확장 프로그램이 QCAD에 연결할 수 없습니다. 다음을 확인하십시오.

QCAD가 실행 중인지
MCP 서버가 기타 > MCP > 시작으로 시작되었는지
기타 > MCP > 상태에 표시되는 포트가 Claude Desktop의 확장 프로그램 설정에 있는 포트와 일치하는지

QCAD를 Claude Desktop보다 먼저 시작할 필요는 없으며, MCP 서버를 시작한 후 Claude Desktop을 다시 시작할 필요도 없습니다. 그러나 Claude가 QCAD 도구를 인식하지 못하는 것처럼 보이면 먼저 QCAD와 MCP 서버를 시작한 다음 Claude Desktop에서 새 채팅을 여십시오.

서버를 시작할 수 없는 경우

기타 > MCP > 시작에서 주소가 이미 사용 중이라고 보고하면 다른 프로그램 또는 다른 QCAD 창이 이미 포트 3907을 사용하고 있는 것입니다. 하나의 포트에서는 하나의 QCAD 창만 MCP 서버를 실행할 수 있습니다. 다른 QCAD 창에서 기타 > MCP > 중지로 서버를 중지하고 작업하려는 창에서 서버를 시작하십시오.

Claude가 잘못된 도면으로 작업하는 경우

Claude는 항상 MCP 서버를 실행 중인 QCAD 인스턴스의 활성 도면으로 작업합니다. QCAD에서 Claude가 작업할 도면의 탭이나 창을 클릭하십시오. 여러 QCAD 인스턴스가 실행 중인 경우 현재 보고 있는 인스턴스에서 MCP 서버가 실행 중인지 확인하십시오.

요청이 오래 걸리거나 시간 초과로 실패하는 경우

QCAD에 대화 상자가 열려 있는 동안에는 QCAD가 응답할 수 없습니다. QCAD에서 열려 있는 대화 상자를 모두 닫고 다시 요청하십시오. 매우 큰 도면의 경우 확장 프로그램 설정에서 Reply timeout을 늘리십시오.