DeepSeek Harness용 Meshy 플러그인
DeepSeek Harness에 Meshy 플러그인을 설치하면 채팅에서 3D 모델, 텍스처, 애니메이션을 생성하고 3D 프린트를 준비할 수 있습니다.
개요
Meshy 플러그인은 DeepSeek Harness(dsh)에 두 가지 스킬을 추가합니다:
meshy-3d-generation: 텍스트로 3D, 이미지로 3D, 멀티 이미지로 3D, AI 텍스처링 및 리텍스처링, 폴리곤 예산에 맞춘 리메시, UV 언래핑, 휴머노이드 캐릭터용 오토 리깅 및 애니메이션, 그리고 GLB, FBX, OBJ, STL 또는 USDZ로의 내보내기를 지원합니다.meshy-3d-printing: 프린팅 가능성 분석 및 복구, 단색 및 다색 3MF, 실제 치수에 맞춘 크기 조정, 피규어·램프·키링·냉장고 자석 등 Creative Lab 제품, 설치된 슬라이서로의 전달을 지원합니다.
이 플러그인에는 npm의 meshy-cli 패키지인 Meshy CLI가 포함되어 있습니다. 스킬이 이를 실행하여 프로젝트에 파일을 저장합니다. 브라우저에서 한 번만 로그인하면 되며, API 키는 필요하지 않습니다.
dsh Web과 Desktop에서는 플러그인이 사이드바에 Meshy 페이지, Meshy 설정 페이지, GLB 파일용 3D 미리보기도 추가합니다.
이 플러그인은 npm의 meshy-dsh 패키지이며, dsh는 이를 Plugins 아래에 Meshy로 표시합니다. 이 플러그인은 GitHub의 meshy-dsh 저장소에서 오픈 소스로 제공되며, 스킬은 meshy-3d-agent 저장소에서 가져옵니다.
시작하기 전에
-
DeepSeek Harness가 필요합니다. macOS 또는 Windows용 데스크톱 앱을 다운로드하려면 DeepSeek Harness 페이지로 이동하세요. 대신 dsh Web을 실행하려면 Node.js를 설치한 다음
npx @deepseek-ai/dsh web을 실행하세요. -
모델을 생성하려면 유료 Meshy 플랜이 필요합니다. 모든 생성 작업은 API 요율에 따라 Meshy 크레딧을 소비합니다. 각 작업의 비용은 요금을 참고하세요. 프린팅 가능성 분석은 무료이며, 모델 크기 재조정이나 슬라이서에서 열기 같은 로컬 프린트 단계에는 로그인이 필요하지 않습니다.
플러그인 설치
다음 방법 중 하나로 플러그인을 설치할 수 있습니다:
-
에이전트에게 요청: dsh 세션에서 Install the Meshy plugin이라고 요청하세요. 에이전트가 대신 설치해 줍니다.
-
Plugins 페이지: dsh에서 Plugins를 열고 Add plugin을 선택한 다음
meshy-dsh를 입력하세요. 중국 본토에서는 Mainland China mirror 레지스트리를 선택하세요. -
명령줄: 다음 명령을 실행하세요. GitHub에서 설치하려면 대신
github:meshy-dev/meshy-dsh를 사용하세요.dsh plugin --profile web add meshy-dshdsh는 프로필별로 플러그인을 설치합니다. 플러그인을
desktop이나tui같은 다른 프로필에 설치하려면web을 해당 프로필 이름으로 바꾸세요.
설치를 확인하려면 dsh에서 Plugins를 여세요. Meshy 플러그인이 목록에 표시되고 실행 중인 상태여야 합니다. 그런 다음 새 세션을 시작하고 /를 입력하세요. 목록에 meshy-3d-generation과 meshy-3d-printing이 표시됩니다. dsh는 설치 후에 시작한 세션에서만 스킬을 로드합니다.
플러그인에 Meshy CLI가 포함되어 있으므로 다른 것을 추가로 설치할 필요는 없습니다.
로그인
한 번만 로그인하면 새 세션이든 기존 세션이든 모든 세션에서 해당 로그인을 사용합니다. dsh Web과 Desktop에서는 Meshy 페이지 또는 Settings > Meshy에서 로그인할 수 있습니다. 채팅에서는 처음 모델을 요청할 때 에이전트가 링크와 코드를 보여줍니다.
Meshy 페이지에서 로그인하려면 다음 단계를 따르세요:
-
dsh 사이드바에서 Meshy를 선택하세요.
-
Site 아래에서 Global · meshy.ai를 선택하세요. 중국 본토에서는 China · meshy.cn을 선택하세요. 두 사이트 모두 동일한 Meshy 계정과 동일한 크레딧을 사용합니다.
-
Sign in to Meshy를 클릭하세요. 페이지에 QR 코드, 링크, 코드가 표시됩니다.

-
휴대폰으로 QR 코드를 스캔하거나 Open in browser를 클릭하세요.
-
Meshy가 로그인을 요청하면 Meshy 계정으로 로그인하세요.
-
Connect Meshy CLI 페이지에서 코드가 dsh에 표시된 코드와 일치하는지 확인한 다음 Connect를 클릭하세요.

-
dsh로 돌아가세요. 페이지가 자동으로 완료되고 Signed in이 표시됩니다.
코드는 10분 후 만료됩니다. 만료되면 로그인을 다시 시작하세요.
이 로그인은 Meshy CLI 고유의 로그인이며, 이를 암호화하는 키는 운영 체제가 보관하므로 터미널의 meshy도 동일한 로그인을 사용합니다. dsh는 내보낸 MESHY_API_KEY를 에이전트의 셸에 노출하지 않으며 플러그인도 이를 전달하지 않으므로, 브라우저를 통해 로그인하세요.
Meshy 페이지와 3D 미리보기
dsh Web과 Desktop은 다음과 같은 Meshy 페이지를 보여줍니다. dsh tui와 헤드리스 모드에서는 이 페이지들이 표시되지 않지만, 스킬은 동일하게 작동합니다.
-
Meshy 페이지: 왼쪽 사이드바에서 Meshy를 선택하세요. 페이지에 Meshy 계정과 Start creating 아래 네 가지 예시 요청이 표시됩니다.

예시를 선택하면 해당 요청이 채워진 새 세션이 시작됩니다. 보내기 전에 요청을 편집할 수 있습니다.

-
Settings 페이지: Settings를 연 다음 Meshy를 선택하세요. Plugins 아래 Meshy 플러그인에서도 이 페이지를 열 수 있습니다. 로그인된 상태라면 페이지에 계정, 크레딧, 로그인 방식(브라우저 또는 API 키), 사이트, Meshy CLI 버전이 표시됩니다. 이 페이지에서 로그아웃하거나 크레딧을 더 받을 수 있습니다. China 사이트는 아직 계정 이름을 표시하지 않습니다.

-
3D 미리보기: 오른쪽 사이드바에서
.glb파일을 선택하거나 에이전트가 제공한 모델의 카드를 선택하세요. 미리보기는 파일 크기와 삼각형 수와 함께 모델을 3D로 보여줍니다. 드래그하면 회전하고, 스크롤하면 확대/축소하며, 버튼을 사용해 뷰를 재설정하거나 모델을 돌릴 수 있습니다. 미리보기는 최대 256MB까지 모델을 엽니다.
예시 프롬프트
원하는 작업을 자신의 말로 설명하세요. 예를 들면:
- 게임에 쓸 로우폴리 만화풍 보물 상자를 만들고 GLB로 내보내 줘.
- 첨부한 사진을 텍스처가 있는 3D 모델로 바꿔 줘. (이미지 첨부)
- 만화풍 기사를 만들고, 리깅한 다음 걷기 애니메이션을 추가하고 FBX로 내보내 줘.
- 10cm 높이의 시바견 피규어를 만들고 프린트 준비가 된 3MF를 만들어 줘.
- 게임에 쓸 로우폴리 물약 병 세 개를 만들어 줘, 각각 1,500 삼각형 이하로.
후속 요청은 이전 결과를 재사용합니다. 예를 들어 1,500면 LOD로 만들어 줘, 이제 FBX로, 또는 150mm로 크기 조정해 줘 등입니다. 에이전트는 크레딧을 소비하기 전에 비용을 알려주고 확인을 기다립니다.
문제 해결
다음 표는 흔히 발생하는 문제, 원인, 해결 방법을 정리한 것입니다.
| 문제 | 원인 | 해결 방법 |
|---|---|---|
/를 입력해도 Meshy 스킬이 목록에 표시되지 않음 | 세션이 설치 전에 시작되었거나, 플러그인을 다른 프로필에 설치했습니다. | 새 세션을 시작하세요. 그래도 스킬이 없다면 실제로 사용하는 프로필에 플러그인을 설치하세요. 예: dsh plugin --profile desktop add meshy-dsh. |
| 사이드바에 Meshy 항목이 없음 | Meshy 페이지가 없는 dsh tui 또는 헤드리스 모드를 사용 중입니다. | dsh Web 또는 Desktop을 사용하세요. 스킬은 모든 모드에서 작동합니다. |
| Meshy 페이지에 Needs attention이 표시됨 | 저장된 로그인을 확인할 수 없습니다. | 새로고침 아이콘을 클릭하세요. 메시지가 계속 표시되면 로그아웃 후 다시 로그인하세요. |
Meshy CLI가 MESHY_API_KEY를 사용하지 않음 | dsh는 에이전트의 셸에 자격 증명 변수를 노출하지 않습니다. | 브라우저를 통해 로그인하세요. 채팅에 API 키를 절대 붙여넣지 마세요. |
| 로그인 코드가 만료됨 | 코드는 10분 동안 유효합니다. | 로그인을 다시 시작하거나 에이전트에게 새 코드를 요청하세요. |
| 플랜 또는 크레딧 문제로 에이전트가 생성할 수 없음 | 생성하려면 유료 플랜과 충분한 크레딧이 필요합니다. | Meshy 웹 앱의 Subscription 페이지에서 플랜과 잔액을 확인하세요. |
| 3D 미리보기에 모델이 너무 크다고 표시됨 | 미리보기는 최대 256MB까지 모델을 엽니다. | 에이전트에게 모델을 더 적은 면으로 리메시해 달라고 요청한 다음 다시 여세요. |
| 잘못된 Meshy 계정으로 로그인되어 있음 | 플러그인은 마지막으로 수행한 로그인을 유지합니다. | Meshy 페이지에서 Sign out을 클릭한 다음 다시 로그인하세요. |
FAQ
- DeepSeek Harness에 Meshy를 어떻게 추가하나요?
- 에이전트에게 Meshy 플러그인을 설치해 달라고 요청하거나, Plugins > Add plugin 아래에서 meshy-dsh를 추가하거나, dsh plugin --profile web add meshy-dsh를 실행하세요. 그런 다음 새 세션을 시작하세요.
- Meshy API 키가 필요한가요?
- 아니요. 브라우저를 통해 한 번만 로그인하면 모든 dsh 세션이 해당 로그인을 사용합니다. dsh는 내보낸 MESHY_API_KEY를 에이전트에 전달하지 않습니다.
- Node.js나 Meshy CLI를 설치해야 하나요?
- 아니요. 플러그인에 Meshy CLI가 포함되어 있어 스킬을 위해 직접 실행합니다.
- dsh tui에서도 작동하나요?
- 네. 스킬은 모든 dsh 모드에서 작동합니다. Meshy 페이지, 설정 페이지, 3D 미리보기는 dsh Web과 Desktop에서만 제공됩니다.
- 중국 본토에서도 사용할 수 있나요?
- 네. 로그인할 때 China · meshy.cn을 선택하세요. 동일한 Meshy 계정과 동일한 크레딧을 사용하며, 이후 요청은 China 사이트로 전송됩니다.
- 이것은 Codex 플러그인과 같은 스킬인가요?
- 네. Codex, Claude Code, Cursor, OpenClaw, Hermes Agent, DeepSeek Harness용 플러그인은 모두 오픈 소스 meshy-3d-agent 저장소의 meshy-3d-generation과 meshy-3d-printing을 사용합니다.
- 무료인가요?
- 플러그인은 무료이며 오픈 소스입니다. 3D 모델을 생성하려면 유료 Meshy 플랜이 필요하며 API 요율에 따라 Meshy 크레딧을 소비합니다. 프린팅 가능성 분석은 무료입니다.
다음 단계
-
Codex에서 동일한 스킬을 사용하려면 Meshy plugin for Codex를 참고하세요.
-
Hermes Agent에서 동일한 스킬을 사용하려면 Meshy skills for Hermes Agent를 참고하세요.
-
자신의 API 키로 AI 에이전트에서 Meshy API를 호출하려면 AI integration을 참고하세요.