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

바로 사용 가능한 스킬을 원하시나요? 오픈 소스 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 소스에서 확인할 수 있습니다.

예시 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 페이지를 단일 fetch로 수집할 수 있도록 하나의 파일로 연결한 것.
  • 페이지별 Markdown: 원하는 엔드포인트 URL 뒤에 .md를 붙이세요. 예: https://docs.meshy.ai/api/text-to-3d.md.

이 세 가지는 모두 문서 사이트가 빌드될 때마다 재생성되므로 HTML 문서와 어긋나는 일이 없습니다.

FAQ

Is the MCP server stateless?
Yes. Your MESHY_API_KEY is used per request and never persisted on the server side.
Does MCP cost the same as the REST API?
Yes — every MCP tool call maps to a single REST call and consumes credits at the exact same rate. See the Pricing page for the full matrix.
What are the rate limits?
The MCP server shares the same rate-limit plane as the REST API. See the Rate Limits page for per-tier limits.
What Meshy data can the MCP access?
Only what the MESHY_API_KEY can access via REST. Scopes and permissions are identical.
How do I report issues?
File an issue at the meshy-mcp-server repository: https://github.com/meshy-dev/meshy-mcp-server/issues