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 키가 필요합니다. https://www.meshy.ai/settings/api에서 생성하세요. 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

대신 바로 사용할 수 있는 스킬을 선호하시나요? 오픈 소스 meshy-3d-agent 스킬 팩은 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에서 3D 모델 생성
  • 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 — 리깅된 캐릭터에 애니메이션 적용

이미지 생성

  • meshy_text_to_image — 텍스트에서 2D 이미지 생성
  • meshy_image_to_image — 참조 이미지에서 2D 이미지 생성

작업 관리

  • meshy_get_task_status — 작업 상태와 다운로드 URL 확인
  • meshy_list_tasks — 최근 작업 나열, 선택적으로 유형/상태별 필터링
  • meshy_cancel_task — 대기 중이거나 진행 중인 작업 취소
  • meshy_download_model — 완료된 모델 파일을 가져와 로컬에 저장

작업 공간

  • meshy_list_models — 인증된 사용자의 작업 공간에 있는 모든 모델 나열

3D 프린팅

  • meshy_send_to_slicer — 설치된 슬라이서를 감지하고 그중 하나에서 모델 실행(사용자 머신에서 로컬로 실행되며 Meshy API 호출 없음)
  • meshy_analyze_printability — 현재 수동 프린트 준비 상태 체크리스트를 반환합니다(벽 두께, 오버행, 매니폴드 메시 등). Meshy 프린팅 가능성 API가 제공되면 자동 분석으로 업그레이드될 예정입니다.
  • meshy_process_multicolor — 텍스처가 적용된 모델을 프린팅용 다중 색상 3MF 파일로 변환

계정

  • meshy_check_balance — 남은 크레딧 조회

도구 이름과 동작은 변경될 수 있습니다. 권위 있는 목록은 MCP server source에 있습니다.

예시 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 호출에 매핑되며 정확히 동일한 비율로 크레딧을 소비합니다. 전체 매트릭스는 요금 페이지를 참조하세요.
속도 제한은 어떻게 되나요?
MCP server는 REST API와 동일한 속도 제한 체계를 공유합니다. 티어별 제한은 속도 제한 페이지를 참조하세요.
MCP는 어떤 Meshy 데이터에 접근할 수 있나요?
MESHY_API_KEY가 REST를 통해 접근할 수 있는 항목만 접근할 수 있습니다. 범위와 권한은 동일합니다.
문제는 어떻게 리포트하나요?
meshy-mcp-server 저장소에 이슈를 제출하세요: https://github.com/meshy-dev/meshy-mcp-server/issues