# Meshy MCP 서버 및 AI 코딩 에이전트 설정

> URL: https://help.meshy.ai/ko/articles/16102957-meshy-mcp-server-and-ai-coding-agent-setup
> Language: ko
> Last updated: 2026-09-09T10:17:28Z

## 개요

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 키를 공유해도 안전한가요?

신뢰하는 클라이언트라면 동일한 키를 재사용할 수 있지만, 공유되거나 공개된 설정 파일에 노출되지 않도록 주의하세요.