개요
Meshy MCP(Model Context Protocol) 서버를 사용하면 Claude Code, Cursor, Codex 및 stdio MCP 서버를 지원하는 기타 모든 클라이언트와 같은 로컬 AI 에이전트가 대화에서 바로 Meshy의 3D 도구를 호출할 수 있습니다.
한 번 연결하면 에이전트에 Text to 3D, Image to 3D, 텍스처링, 리메싱, 리깅, 출력 가능성 검사, 다운로드 등 24개의 Meshy 도구가 제공됩니다. 전체 설정 페이지는 meshy.ai/mcp에서 확인하세요.
Meshy 3D 에이전트와 Meshy MCP의 차이
Meshy 3D 에이전트는 브라우저의 meshy.ai 안에서 실행되므로 별도 설정이 필요 없습니다.
Meshy MCP는 동일한 생성 도구를 이미 사용 중인 AI 클라이언트로 가져와, 편집기나 터미널을 벗어나지 않고도 3D 에셋을 만들고 다운로드할 수 있게 해줍니다.
필요한 사항
Node.js 18 이상
Meshy API 키 — Meshy 개발자 플랫폼에서 생성하세요
옵션 A: 에이전트가 설치하도록 하기(권장)
Claude Code, Cursor 또는 Codex 세션에서 다음을 붙여넣으세요:
Meshy MCP 서버를 설치해 주세요. 문서: https://github.com/meshy-dev/meshy-mcp-server 클라이언트 설정에서 MESHY_API_KEY를 로컬로 구성하도록 도와주세요. 이 채팅에 API 키를 붙여넣으라고 요청하지 마세요.
옵션 B: 수동 설정
meshy.ai/mcp 또는 GitHub README에서 사용 중인 클라이언트에 맞는 수동 단계를 따르세요.
연결 확인
서버는 다음 메시지를 보낼 때 로드됩니다. 에이전트에게 "내 Meshy 크레딧 잔액은 얼마야?"라고 물어보세요.
답변이 오면 연결된 것입니다. 이제 원하는 모델을 설명하기만 하면 됩니다.
ChatGPT를 사용 중인가요?
ChatGPT 플러그인에서 Meshy 3D를 추가하고 Meshy 계정으로 로그인하세요. API 키나 로컬 설정이 필요 없으며 웹과 데스크톱 모두에서 작동합니다.
크레딧 및 보안
MCP를 통한 생성은 직접 API를 호출할 때와 마찬가지로 API 키에 연결된 계정의 API 크레딧을 사용합니다.
API 키는 비밀번호처럼 취급하세요. 절대 채팅에 붙여넣지 말고, 소스 관리 시스템이나 공유 구성 파일에 커밋하지 마세요.
자세히 알아보기
튜토리얼: Meshy API 및 MCP 사용하기
모든 통합: meshy.ai/integrations
AI 에이전트용 문서: docs.meshy.ai/api/ai.md
FAQ
1. MCP 서버가 브라우저의 Meshy 에이전트와 동일한가요?
아니요. Meshy 3D 에이전트는 meshy.ai의 채팅 인터페이스입니다. MCP 서버는 Claude Code, Cursor, Codex와 같은 외부 AI 클라이언트에 Meshy의 도구를 노출합니다.
2. 클라이언트에 Meshy 도구가 표시되지 않습니다. 어떻게 해야 하나요?
Node.js 18+가 설치되어 있는지, 클라이언트의 MCP 설정에 MESHY_API_KEY가 설정되어 있는지 확인한 후 클라이언트를 다시 시작하세요. GitHub README의 문제 해결 섹션을 참고하세요.
3. MCP 생성 시 웹 앱과 동일한 크레딧이 사용되나요?
API 키를 소유한 계정의 API 크레딧이 사용됩니다.
4. 생성된 모델은 어디에 저장되나요?
에이전트에게 필요한 형식(예: GLB 또는 FBX)으로 다운로드하도록 요청하세요. 로컬 다운로드는 meshy_output/ 아래에 저장되어 DCC 앱이나 슬라이서에서 바로 사용할 수 있습니다.
5. 하나의 API 키를 여러 도구에서 재사용할 수 있나요?
네, 신뢰하는 클라이언트 간에 재사용할 수 있습니다. 다만 공유되거나 공개된 설정 파일에는 키를 두지 마세요.