Onshape Native는 브라우저에 로그인한 상태를 이용해 AI 클라이언트가 Onshape의 CAD 명령을 실행하고 편집할 수 있게 하는 MCP 서버다. 별도의 Onshape API 키는 필요하지 않지만, 브라우저 승인 절차는 직접 완료해야 한다.

Codex, Claude Code 또는 로컬 표준 입출력(stdio) 방식의 MCP 서버를 지원하는 클라이언트와 함께 사용할 수 있다. 에이전트에 Onshape URL을 주거나 현재 열려 있는 Onshape 탭을 사용하도록 요청하면 된다.

설치하려면 먼저 uv와 AI 클라이언트를 설치한 뒤 터미널이나 PowerShell에서 다음 명령을 실행한다.

sh
uv run --python 3.12 https://raw.githubusercontent.com/godbrigero/onshape-native/main/install.py --client codex

codex는 claude, both 또는 generic으로 바꿀 수 있다. --directory "PATH"를 추가하면 소스와 확장 프로그램을 저장할 위치를 지정할 수 있다. 저장소를 로컬에 내려받았다면 uv run --python 3.12 install.py --client codex를 실행한다.

설치 프로그램은 서버를 내려받고 Python 환경을 만들며, 기기에서 비공개 페어링 데이터를 생성한 뒤 선택한 클라이언트에 서버를 등록한다. generic을 선택하면 클라이언트의 MCP 설정으로 가져올 .mcp.json 항목을 만든다.

설치 후 브라우저의 확장 프로그램 페이지에서 개발자 모드를 켜고 ‘압축해제된 확장 프로그램 로드’를 선택한 다음 설치 프로그램이 출력한 확장 프로그램 폴더를 지정해야 한다. Onshape에 로그인한 뒤 AI 클라이언트를 다시 시작한다. 설치 프로그램은 브라우저의 승인 절차를 자동화하지 않는다. AI 클라이언트, 서버, Chromium 브라우저는 같은 컴퓨터에서 실행해야 한다. 설치 프로그램은 macOS, Linux, Windows 경로를 처리하지만, 전체 브라우저 설정은 macOS에서만 테스트됐다. 자세한 내용은 설치 및 업데이트 안내를 참고하면 된다.

이 서버는 명령 탐색과 형상 확인, 스케치·피처·어셈블리 편집을 지원한다. 탭·폴더·피처 트리를 탐색하고 편집하거나 질량과 재료를 확인할 수 있으며, 표시 여부와 카메라 시점, 메이트 동작을 제어하고 뷰포트를 캡처할 수도 있다. 응답은 간결한 요약을 우선 제공하고, 저장된 세부 정보는 artifact_page 도구로 확인할 수 있다.

제작자는 이 통합이 비공식 역공학 기반이라고 밝힌다. Onshape API와 UI의 모든 기능을 지원한다고 보장하지 않으며, 네이티브 명령은 Onshape 업데이트에 따라 달라질 수 있다. 서버는 백엔드 명령을 우선 사용하고 필요한 경우 UI 대체 기능을 제공한다.

개발 명령은 다음과 같다.

sh
uv sync --frozen
uv run pytest
uv run python scripts/package.py

생성된 실행 파일, 페어링 토큰, 캐시와 환경은 로컬에 보관되며 소스 관리와 배포 ZIP에서는 제외된다. 추가 자료: 응답 형식 · 측정된 토큰 절감량 · 모델링 스킬