AI 연동
Meshy는 AI 에이전트와 코딩 어시스턴트를 위해 두 가지 채널을 제공합니다. 도구 호출을 위한 Meshy MCP server와, 문서 수집을 위한 llms.txt / llms-full.txt입니다.
Claude Code, Cursor, Windsurf, Codex 또는 그 밖의 MCP 호환 도구에서 Meshy를 연동하는 경우, 아래의 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.com/meshy-dev/meshy-mcp-server.
Meshy API 키가 필요합니다. Developer Platform의 API Keys 페이지에서 생성하세요. MCP server는 MESHY_API_KEY 환경 변수에서 이를 읽어옵니다.
빠른 설치
# 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 워크플로우(생성 → 폴링 → 다운로드)를 제공합니다. 이는 Meshy REST API를 직접 호출하므로 MCP server가 필요하지 않습니다.
npx skills add meshy-dev/meshy-3d-agent
사용 가능한 도구
MCP server는 Meshy REST API를 기능별로 그룹화된 도구로 제공합니다.
3D 생성
meshy_text_to_3d: 텍스트 prompt로부터 텍스처가 없는 preview 메시 생성meshy_image_to_3d: 이미지 한 장으로부터 3D 모델 생성meshy_multi_image_to_3d: 동일한 객체를 촬영한 여러 이미지로부터 3D 모델 생성meshy_text_to_3d_refine: preview 메시에 텍스처 추가
후처리
meshy_remesh: 기존 모델의 topology 및/또는 폴리곤 수 변경meshy_retexture: 기존 모델에 새 텍스처 적용meshy_rig: 3D 휴머노이드 캐릭터에 스켈레톤 추가meshy_animate: 리그된 캐릭터에 애니메이션 적용meshy_convert: 모델을 다른 파일 형식으로 변환meshy_resize: 모델을 실제 크기 치수로 크기 조정meshy_uv_unwrap: 모델에 대한 새 UV 레이아웃 생성
Creative Lab
meshy_creative_lab: 사진을 완성된 Creative Lab 제품으로 변환 (prototype 및 build 작업 실행)
이미지 생성
meshy_text_to_image: 텍스트로부터 2D 이미지 생성meshy_image_to_image: 참조 이미지로부터 2D 이미지 생성
작업 관리
meshy_get_task_status: 작업 상태 및 다운로드 URL 확인meshy_list_tasks: 최근 작업을 유형/상태별로 필터링하여 목록으로 표시meshy_cancel_task: 작업 삭제.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_check_balance: 남은 크레딧 조회
도구 이름과 동작은 변경될 수 있습니다. 공식적인 목록은 MCP server 소스 코드에서 확인할 수 있습니다.
예시 Prompt
아래 내용을 시작점으로 삼아 MCP를 지원하는 채팅에 입력해 보세요.
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.
이 세 가지는 문서 사이트가 빌드될 때마다 다시 생성되므로 HTML 문서와 어긋나지 않습니다.
FAQ
- MCP server는 상태를 저장하지 않나요?
- 네. MESHY_API_KEY는 요청마다 사용되며 서버 측에 저장되지 않습니다.
- MCP 비용은 REST API와 동일한가요?
- 네 — 모든 MCP 도구 호출은 단일 REST 호출에 매핑되며 정확히 동일한 비율로 크레딧을 소비합니다. 전체 요율표는 Pricing 페이지를 참고하세요.
- 속도 제한은 어떻게 되나요?
- MCP server는 REST API와 동일한 속도 제한 체계를 공유합니다. 등급별 제한은 Rate Limits 페이지를 참고하세요.
- MCP는 어떤 Meshy 데이터에 접근할 수 있나요?
- MESHY_API_KEY가 REST를 통해 접근할 수 있는 범위에 한정됩니다. 범위와 권한은 동일합니다.
- 문제는 어떻게 리포트하나요?
- meshy-mcp-server 저장소에 이슈를 등록해 주세요: https://github.com/meshy-dev/meshy-mcp-server/issues