요금

개발자용 MCP — Claude Code · Claude Desktop · Cursor 안에서 바로 만들기

AI 코딩 도구에 이 스튜디오를 붙이면 "번개 효과음 만들어서 assets/sfx 에 넣어줘" 한 마디로 WAV 파일이 프로젝트 폴더에 떨어집니다. 효과음 27종과 몬스터 목소리 37종을 같은 4겹 방식으로 만들고, 토큰은 웹과 같은 계정에서 같은 값(소리 묶음 5, AI 설계 시 +3)으로 차감됩니다. 무료 토큰(가입 50 · 매일 10)도 그대로 씁니다.

1. API 키 발급 — 스튜디오 우측 상단 계정 메뉴 → API 키 → 이름을 적고 발급. 키는 발급 순간에만 보이고 계정당 5개까지, 언제든 폐기할 수 있습니다.
2. Claude Code — 터미널에서 한 줄:claude mcp add vss-sound -e VSS_API_KEY=vss_발급받은키 -- npx -y vss-sound-mcp
3. Claude Desktop · Cursor · Windsurf · Cline · Gemini CLI — 각 도구의 MCP 설정 JSON 의 mcpServers 에 추가:"vss-sound": { "command": "npx", "args": ["-y", "vss-sound-mcp"], "env": { "VSS_API_KEY": "vss_발급받은키" } } 설정 파일 위치 — Claude Desktop: claude_desktop_config.json · Cursor: ~/.cursor/mcp.json (또는 프로젝트 .cursor/mcp.json) · Windsurf: ~/.codeium/windsurf/mcp_config.json · Gemini CLI: ~/.gemini/settings.json · Cline/Roo Code: MCP 서버 패널 → 설정 편집
4. OpenAI Codex CLI — ~/.codex/config.toml 에 추가 (ChatGPT 계정으로 쓰는 터미널 에이전트):[mcp_servers.vss-sound] command = "npx" args = ["-y", "vss-sound-mcp"] env = { VSS_API_KEY = "vss_발급받은키" }
5. VS Code (GitHub Copilot 에이전트 모드) — 프로젝트의 .vscode/mcp.json:{ "servers": { "vss-sound": { "type": "stdio", "command": "npx", "args": ["-y", "vss-sound-mcp"], "env": { "VSS_API_KEY": "vss_발급받은키" } } } }
6. ChatGPT 앱·웹 — 아직 PC 에서 도는 로컬 MCP 서버를 직접 붙이지 못합니다(원격 커넥터만 지원). 같은 ChatGPT 계정으로 쓰는 Codex CLI 에 위처럼 등록해 쓰거나, 웹 스튜디오에서 만들어 저장하세요.
7. 그 밖의 도구 — MCP 표준(stdio)을 지원하면 전부 됩니다. 등록에 필요한 건 세 가지뿐: 명령 npx, 인수 -y vss-sound-mcp, 환경변수 VSS_API_KEY. Node.js 18 이상만 설치돼 있으면 됩니다.
8. 쓰기 — "큰 드래곤 포효를 sfx/monsters 폴더에 만들어줘", "검 베기 효과음 2D 게임용으로" 처럼 말하면 됩니다. 도구 5개: generate_vfx_sound · generate_monster_voice · list_vfx_types · list_monster_options · get_balance.
9. 잘 뽑는 요령 — MCP 는 웹처럼 시트를 보거나 겹을 손으로 다듬지 못하므로 이펙트마다 한 줄 설명을 꼭 같이 주세요. 화면에서 무슨 일이 일어나는지 · 재료 · 동작 · 무게를 담으면 결과가 크게 좋아집니다. 예: "돌바닥에 떨어지는 무거운 바위, 짧고 둔탁하게", "세 발 연속 저격, 날카로운 크랙과 짧은 휘파람". 길이(초)·타격 횟수(hits)·2D/3D 도 말로 지정할 수 있고, 마음에 안 들면 같은 설명을 고쳐 다시 부르면 됩니다.

출력은 44.1kHz 16bit 모노 WAV(겹별 파일도 선택 가능). Node.js 18 이상이 필요하고, 키는 vss.ai.kr 서버로만 전송됩니다. 패키지: npm · vss-sound-mcp