MCP server는 상태가 없나요?

네. MESHY_API_KEY는 요청당 사용되며 서버 측에 저장되지 않습니다.

MCP는 REST API와 비용이 동일한가요?

네 — 모든 MCP 도구 호출은 단일 REST 호출에 매핑되며 동일한 속도로 크레딧을 소모합니다. 전체 매트릭스는 요금 페이지를 참조하세요.

속도 제한은 어떻게 되나요?

MCP server는 REST API와 동일한 속도 제한 평면을 공유합니다. 계층별 제한은 속도 제한 페이지를 참조하세요.

MCP가 접근할 수 있는 Meshy 데이터는 무엇인가요?

REST를 통해 MESHY_API_KEY가 접근할 수 있는 데이터만 가능합니다. 범위와 권한은 동일합니다.

문제는 어떻게 보고하나요?

meshy-mcp-server 저장소에 문제를 등록하세요: https://github.com/meshy-dev/meshy-mcp-server/issues

AI 연동

Meshy는 AI 에이전트와 코딩 보조를 위해 두 가지 채널을 제공합니다: 도구 호출을 위한 Meshy MCP server와 문서 수집을 위한 llms.txt / llms-full.txt.

Claude Code, Cursor, Windsurf, Codex 또는 다른 MCP 호환 도구에서 Meshy를 연동하는 경우, 아래의 MCP server를 설치하세요. MCP 지원이 없는 일반 채팅 에이전트에서 연동하는 경우, https://docs.meshy.cn/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 — 텍스트 프롬프트로 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 소스에 있습니다.

예제 프롬프트

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 문서를 직접 프롬프트에 수집하려는 경우, 우리의 평문 텍스트 표면을 참조하세요:

llms.txt — 간단한 색인 + 연동 지침 (올바른 비동기 폴링 패턴, 인증 규칙, 속도 제한, 모델 선택, 일반적인 실수).
llms-full.txt — 모든 API 페이지가 단일 파일로 연결되어 단일 페치 수집에 적합.
페이지별 Markdown: 엔드포인트 URL에 .md를 추가하세요. 예: https://docs.meshy.cn/api/text-to-3d.md.

이 세 가지는 문서 사이트가 빌드될 때마다 재생성되므로 HTML 문서와의 차이가 없습니다.

FAQ

MCP server는 상태가 없나요?: 네. MESHY_API_KEY는 요청당 사용되며 서버 측에 저장되지 않습니다.
MCP는 REST API와 비용이 동일한가요?: 네 — 모든 MCP 도구 호출은 단일 REST 호출에 매핑되며 동일한 속도로 크레딧을 소모합니다. 전체 매트릭스는 요금 페이지를 참조하세요.
속도 제한은 어떻게 되나요?: MCP server는 REST API와 동일한 속도 제한 평면을 공유합니다. 계층별 제한은 속도 제한 페이지를 참조하세요.
MCP가 접근할 수 있는 Meshy 데이터는 무엇인가요?: REST를 통해 MESHY_API_KEY가 접근할 수 있는 데이터만 가능합니다. 범위와 권한은 동일합니다.
문제는 어떻게 보고하나요?: meshy-mcp-server 저장소에 문제를 등록하세요: https://github.com/meshy-dev/meshy-mcp-server/issues