lowpoly는 2026. 10. 30.에 지원 종료됩니다. 요청 오류를 피하려면 해당 날짜 전에 모델을 전환하세요. 모든 지원 중단 보기

AI 연동

도구 호출을 위한 Meshy MCP server를 통해, 또는 문서를 읽기 위한 llms.txt와 llms-full.txt를 통해 AI 에이전트와 코딩 어시스턴트를 Meshy에 연결하세요.

Claude Code, Cursor, Windsurf, Codex, 또는 다른 MCP 클라이언트를 사용한다면 MCP server를 설치하세요. 사용 중인 채팅 에이전트가 MCP를 지원하지 않는다면, 대신 https://docs.meshy.ai/llms.txt를 가리키도록 설정하세요.

MCP란 무엇인가

Model Context Protocol (MCP)는 AI 어시스턴트가 외부 도구를 호출하고 구조화된 컨텍스트를 받을 수 있게 해주는 개방형 표준입니다. Meshy MCP server는 Meshy REST API를 에이전트가 호출할 수 있는 도구로 감쌉니다. 이를 통해 에이전트는 직접 작성한 HTTP 코드 없이도 모델을 생성하고, 작업을 확인하고, 결과물을 다운로드할 수 있습니다.

MCP server는 오픈 소스입니다. npm에 @meshy-ai/meshy-mcp-server로 게시되어 있으며, 소스 코드는 GitHub의 meshy-mcp-server 저장소에 있습니다.

Meshy API 키가 필요합니다. Developer Platform의 API Keys 페이지에서 생성하세요. MCP server는 이를 MESHY_API_KEY 환경 변수에서 읽어옵니다.

MCP server 설치하기

server를 설치하려면 사용 중인 AI 클라이언트에 해당하는 탭을 사용하세요. msy_YOUR_API_KEY를 실제 API 키로 바꾸세요.

# Detects installed AI clients and configures Meshy for each
npx add-mcp @meshy-ai/meshy-mcp-server --env MESHY_API_KEY=msy_YOUR_API_KEY

skill 쪽을 선호하시나요? 오픈 소스 meshy-3d-agent skill 팩에는 모델 생성, 작업 폴링, 결과물 다운로드 같은 Claude Code, Cursor, OpenClaw용 완성된 Meshy 워크플로가 준비되어 있습니다. 이 skill은 Meshy REST API를 직접 호출하므로 MCP server가 필요하지 않습니다.

npx skills add meshy-dev/meshy-3d-agent

사용 가능한 도구

MCP server는 Meshy REST API를 다음과 같은 도구들로 제공하며, 기능별로 그룹화되어 있습니다.

3D 생성

  • meshy_text_to_3d: 텍스트 prompt로부터 텍스처가 없는 미리보기 메시를 생성합니다
  • meshy_image_to_3d: 이미지 한 장으로 3D 모델을 생성합니다
  • meshy_multi_image_to_3d: 동일한 객체의 여러 이미지로 3D 모델을 생성합니다
  • meshy_text_to_3d_refine: 미리보기 메시에 텍스처를 추가합니다

후처리

  • meshy_remesh: 기존 모델의 topology나 폴리곤 수, 또는 둘 다를 변경합니다
  • meshy_retexture: 기존 모델에 새 텍스처를 적용합니다
  • meshy_rig: 3D 휴머노이드 캐릭터에 스켈레톤을 추가합니다
  • meshy_animate: rig가 적용된 캐릭터에 애니메이션을 적용합니다
  • meshy_convert: 모델을 다른 파일 형식으로 변환합니다
  • meshy_resize: 모델을 실제 크기 치수에 맞게 크기 조정합니다
  • meshy_uv_unwrap: 모델에 대한 새 UV 레이아웃을 생성합니다
  • meshy_text_to_motion: 텍스트 prompt로부터 애니메이션을 생성합니다
  • meshy_list_animations: 사전 설정된 애니메이션 액션 ID를 무료로 조회합니다

Creative Lab

  • meshy_creative_lab: 사진을 완성된 Creative Lab 제품으로 변환합니다 (프로토타입 및 빌드 작업을 실행합니다)

이미지 생성

  • meshy_text_to_image: 텍스트로부터 2D 이미지를 생성합니다
  • meshy_image_to_image: 참조 이미지로부터 2D 이미지를 생성합니다

작업 관리

  • meshy_get_task_status: 작업 상태와 다운로드 URL을 확인합니다
  • meshy_list_tasks: 유형이나 상태로 필터링하여 최근 작업 목록을 조회합니다
  • meshy_cancel_task: 작업을 삭제합니다. Meshy는 PENDING 상태의 작업을 제거하고 환불하며, 완료된 작업은 삭제합니다. IN_PROGRESS 상태의 작업은 취소할 수 없으며, API는 409를 반환합니다.
  • meshy_download_model: 완료된 모델 파일을 다운로드하여 로컬에 저장합니다

작업 공간

  • meshy_list_models: 최근 텍스트로 3D 모델 목록을 조회합니다. 다른 작업 유형의 경우 meshy_list_tasks를 사용하세요.

3D 프린팅

  • meshy_send_to_slicer: 컴퓨터에 설치된 슬라이서를 찾아, 모델을 해당 슬라이서에서 여는 명령을 반환합니다. 로컬에서 실행되며 Meshy API를 호출하지 않습니다.
  • meshy_analyze_printability: 수밀성, 부피, 구멍, 비매니폴드 에지, 퇴화 면 등을 포함해 모델의 FDM 프린팅 가능성을 무료로 확인합니다
  • meshy_process_multicolor: 텍스처가 적용된 모델을 프린팅용 다중 색상 3MF 파일로 변환합니다
  • meshy_repair_printability: FDM 프린팅을 위해 모델을 수리합니다
  • meshy_auto_split: 모델을 별도로 프린팅 가능한 부품들로 분할합니다

계정

  • meshy_check_balance: 남은 크레딧을 확인합니다
  • meshy_list_usage: Studio 및 Enterprise 팀을 위해, 팀의 완료된 API 작업과 각 작업에서 사용된 크레딧 목록을 조회합니다

도구 이름과 동작은 변경될 수 있습니다. 전체 목록은 MCP server 소스 코드의 도구들을 참고하세요.

예시 prompt

시작하려면 MCP가 활성화된 채팅에서 다음 prompt를 시도해 보세요:

Generate a 3D fox from the prompt "a cartoon fox sitting", preview it, then
texture it with PBR maps. Download the final GLB to ./outputs.

Take the image at https://example.com/sculpture.jpg and convert it into a
riggable 3D character. Use `should_remesh: true` and 50k target polycount.

What's my current Meshy credit balance?

List my last 10 successful text-to-3d tasks and download the top 3 as GLB
into ./downloads/.

llms.txt 및 llms-full.txt

사용 중인 에이전트가 MCP를 지원하지 않거나, Meshy 문서를 prompt에 직접 넣고 싶다면, 문서의 일반 텍스트 버전을 가리키도록 설정하세요:

  • llms.txt: 비동기 작업을 폴링하는 방법, 인증, 요청 제한, 모델 선택, 흔한 실수 등 연동 지침이 담긴 간결한 색인입니다.
  • llms-full.txt: 모든 API 페이지를 하나의 파일로 모아 두어, 에이전트가 한 번의 요청으로 문서를 전부 읽을 수 있습니다.
  • 페이지별 Markdown: 모든 엔드포인트 URL에 .md를 추가하면 됩니다. 예: https://docs.meshy.ai/api/text-to-3d.md.

Meshy는 문서 사이트가 빌드될 때마다 이 세 가지 파일을 모두 재생성하므로, 항상 HTML 문서와 내용이 일치합니다.

FAQ

MCP server는 상태를 저장하지 않나요(stateless)?
자격 증명을 저장하지 않습니다. server는 MESHY_API_KEY를 메모리에만 보관하며 디스크에 쓰지 않습니다. 기본적으로 다운로드한 모델은 메타데이터와 함께 작업 디렉터리의 meshy_output 폴더에 저장됩니다. 다운로드 위치를 다른 곳으로 지정하려면 다운로드 도구에 save_to 경로를 지정하세요.
MCP의 비용은 REST API와 동일한가요?
네. MCP 도구 호출은 동일한 REST 호출을 수행하며 동일한 비율로 크레딧을 사용합니다. 모든 가격은 Pricing 페이지를 참고하세요.
요청 제한은 어떻게 되나요?
MCP server의 호출은 REST API 호출과 동일한 요청 제한에 포함됩니다. 각 플랜의 제한은 Rate limits 페이지를 참고하세요.
MCP server는 어떤 Meshy 데이터에 접근할 수 있나요?
사용 중인 MESHY_API_KEY가 REST API를 통해 접근할 수 있는 범위로 한정되며, 동일한 권한이 적용됩니다.
문제는 어떻게 보고하나요?
GitHub의 meshy-mcp-server 저장소에 이슈를 등록하세요: https://github.com/meshy-dev/meshy-mcp-server/issues