개요
Meshy MCP(Model Context Protocol) 서버를 사용하면 Cursor, Claude Code 같은 AI 코딩 에이전트가 코딩 환경에서 직접 Meshy의 3D 생성 도구를 호출할 수 있으며, 웹 기반 Meshy Agent와는 별개로 작동합니다.
Meshy Agent와 Meshy MCP 비교
웹 기반 Meshy Agent는 meshy.ai 내에서 실행되며 브라우저에서 채팅 스타일 인터페이스를 통해 에셋을 생성할 수 있게 해줍니다. 반면 Meshy MCP 서버는 동일한 기반 생성 도구를 MCP 호환 클라이언트(예: AI 코딩 어시스턴트)에 노출하여, 개발 환경을 벗어나지 않고도 3D 모델을 요청할 수 있습니다.
설치
클라이언트의 MCP 설정(예: Cursor 또는 Claude Code의 MCP 설정 파일)에 Meshy MCP 서버를 추가하고, 해당 클라이언트의 문서에 안내된 대로 Meshy MCP 서버 명령 또는 엔드포인트를 지정하세요.
API 키 추가
Meshy 계정 설정에서 API 키를 생성하고 MCP 서버 설정(일반적으로 환경 변수)에 설정하세요. 이 키는 MCP 서버의 요청을 계정의 크레딧 잔액과 연동해 인증합니다.
지원 클라이언트
Model Context Protocol을 지원하는 모든 클라이언트는 Cursor와 Claude Code를 포함하여 Meshy MCP 서버에 연결할 수 있습니다. 설정 단계는 클라이언트마다 약간씩 다르므로, 정확한 파일 위치와 문법은 사용 중인 클라이언트의 MCP 설정 문서를 참조하세요.
크레딧 및 보안
MCP 서버를 통해 실행된 생성 작업은 웹 앱이나 API와 마찬가지로 연결된 Meshy 계정의 크레딧을 소비합니다. API 키는 비밀 정보로 취급하세요. 키에 접근할 수 있는 사람은 누구나 계정의 크레딧 잔액으로 생성 작업을 실행할 수 있으므로, 소스 컨트롤이나 공유 설정 파일에 커밋하지 않도록 주의하세요.
FAQ
1. MCP 서버는 브라우저의 Meshy Agent와 같은가요?
아니요. Meshy Agent는 meshy.ai에서 제공되는 브라우저 기반 채팅 인터페이스이며, MCP 서버는 Meshy의 도구를 Cursor나 Claude Code 같은 외부 AI 코딩 클라이언트에 노출합니다.
2. 코딩 에이전트가 Meshy MCP 서버를 감지하지 못하는 이유는 무엇인가요?
MCP 설정 파일의 문법과 서버 항목이 올바른 명령 또는 엔드포인트를 가리키는지 다시 확인한 후, 클라이언트를 재시작하세요.
3. MCP를 통해 실행한 생성 작업도 웹 계정과 동일한 크레딧을 사용하나요?
네, API 키와 동일한 계정 잔액에서 차감됩니다.
4. 여러 코딩 도구에서 API 키를 공유해도 안전한가요?
신뢰하는 클라이언트라면 동일한 키를 재사용할 수 있지만, 공유되거나 공개된 설정 파일에 노출되지 않도록 주의하세요.