스타일룸 MCP 연결 방법, AI 도구에서 말로 스타일샷 만들기
스타일룸 MCP는 Claude, Cursor, VS Code 같은 AI 도구에서 말로 스타일룸을 쓰게 해 주는 연결 도구입니다. 토큰을 발급해 설정 파일에 한 번 넣으면 대화창에서 배경을 찾고 크레딧을 확인하고 스타일샷을 만들 수 있습니다. MCP(Model Context Protocol)는 AI 에이전트가 외부 서비스를 도구처럼 쓰도록 이어 주는 표준 연결 규격입니다.
연결하면 무엇을 할 수 있나
크레딧이 쓰이는 생성 기능은 두 가지이고 나머지는 조회와 보조 기능입니다.
| 구분 | 기능 | 크레딧 |
|---|---|---|
| 생성 | 저장된 피팅샷으로 스타일샷 만들기 | 차감 |
| 생성 | 사진 10~30장으로 뮤직 클립(릴스) 만들기 | 차감 |
| 찾기 | 배경 태그 검색, 추천 배경, 저장된 피팅샷 보기 | 없음 |
| 확인 | 크레딧 잔액, 예상 크레딧 계산, 작업 진행 상태, 결과 썸네일 | 없음 |
대화창에서는 이렇게 시킬 수 있습니다.
- "내 크레딧 얼마나 남았어?"
- "저장된 피팅샷 보여 줘."
- "이 니트로 카페 배경 스타일샷 만들면 크레딧이 얼마나 들어?"
시작 전에 준비할 것
- 스타일룸 계정 — 토큰을 발급받을 계정이 필요합니다.
- Node.js 16 이상 — 연결 도구를 실행하는 데 씁니다.
- MCP를 지원하는 AI 도구 — Claude Desktop, Claude Code, Cursor, VS Code 등
- 저장된 피팅샷 — MCP의 스타일샷은 저장된 피팅샷을 바탕으로 만듭니다. 옷을 올려 피팅샷을 만드는 단계는 스타일룸 웹에서 먼저 해 둡니다.
연결 3단계

1. 토큰 발급
스타일룸에 로그인한 뒤 연동 페이지에서 새 토큰을 발급합니다. 활성 토큰은 계정당 1개이고 토큰 값은 발급 직후 한 번만 보이므로 바로 복사해 둡니다.
2. AI 도구에 설정
Claude Desktop
설정 파일을 열어 mcpServers에 아래 블록을 넣습니다. 파일이 없으면 새로 만듭니다.
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"style-room": {
"command": "npx",
"args": ["-y", "@style-room/mcp@latest"],
"env": {
"STYLE_ROOM_API_KEY": "<여기에_본인_토큰>"
}
}
}
}
저장한 뒤 앱을 완전히 종료했다가 다시 켭니다. 창만 닫으면 적용되지 않을 수 있으니 macOS는 Cmd+Q, Windows는 Alt+F4를 씁니다.
Claude Code
claude mcp add style-room -e STYLE_ROOM_API_KEY=<본인_토큰> -- npx -y @style-room/mcp@latest
Cursor
Settings → MCP → Add new MCP Server에서 command에 npx -y @style-room/mcp@latest를 넣고 환경 변수 STYLE_ROOM_API_KEY에 토큰을 넣습니다.
VS Code
code --add-mcp '{"name":"style-room","command":"npx","args":["-y","@style-room/mcp@latest"],"env":{"STYLE_ROOM_API_KEY":"<본인_토큰>"}}'
그 밖의 MCP 지원 도구는 위 Claude Desktop 블록을 해당 도구의 mcpServers 자리에 넣으면 됩니다.
3. 동작 확인
다시 켠 AI 도구의 대화창에 아래 문장을 입력합니다.
get_capabilities 호출해서 지금 몇 개 툴 로드됐는지 알려줘
응답에 toolCount: 22와 authenticated: true가 보이면 연결된 것입니다.
문제가 생기면
| 증상 | 확인할 것 |
|---|---|
| 도구 목록에 안 나타남 | 설정 파일의 JSON 문법 오류, 앱을 완전히 종료한 뒤 다시 켰는지 |
authenticated: false |
STYLE_ROOM_API_KEY가 비어 있거나 오탈자 |
| 401 오류 | 토큰 만료 또는 회수 — 연동 페이지에서 재발급 |
| 설치 후에도 구 버전 | npm cache clean --force 실행 후 다시 시작 |
쓸 때 알아 둘 점
- 토큰은 비밀번호처럼 다룹니다. 설정 파일을 공유하거나 저장소에 올리지 않습니다.
- 생성 요청이 서버 오류로 끝나도 바로 다시 시키지 않습니다. 작업이 이미 접수됐을 수 있어 크레딧이 두 번 차감될 위험이 있습니다. 5분쯤 뒤 작업 내역을 확인하고 판단합니다.
- 원본 대조는 사람이 봅니다. 로고와 기장은 AI가 틀리기 쉬운 자리라 발행 전 확인이 필요합니다.
더 많은 물량을 돌리려면
MCP는 개인 사용자가 대화로 작업할 때 잘 맞습니다. 팀 단위로 사진 정리부터 검수·납품까지 맡기려면 스타일룸 AI MD를, 자사 시스템과 REST API로 연결하려면 엔터프라이즈를 참고하세요. 패션 커머스에서 MCP가 왜 중요해지는지는 기술 리포트 Vol.2에 정리했습니다.
자주 묻는 질문
스타일룸 MCP는 무엇인가요? Claude, Cursor, VS Code 같은 AI 도구에서 말로 스타일룸을 쓰게 해 주는 연결 도구입니다. 토큰을 설정 파일에 넣으면 대화창에서 스타일샷과 뮤직 클립을 만들고 크레딧과 작업 상태를 확인할 수 있습니다.
MCP로 무엇을 만들 수 있나요? 크레딧이 쓰이는 생성 기능은 스타일샷과 뮤직 클립(릴스) 두 가지입니다. 스타일샷은 저장된 피팅샷을 바탕으로 만들고 뮤직 클립은 사진 10~30장으로 만듭니다.
개발자가 아니어도 연결할 수 있나요? 가능합니다. 연동 페이지의 안내문을 Claude Code나 Cursor 같은 AI 도구에 붙여 넣으면 AI가 설정 파일을 찾아 설치를 도와줍니다. 토큰 값은 본인이 직접 입력합니다.
토큰을 잃어버리면 어떻게 하나요? 토큰 값은 발급 직후 한 번만 보입니다. 잃어버렸다면 연동 페이지에서 새로 발급합니다.
연결이 안 되면 어디부터 보나요? 설정 파일의 JSON 문법과 토큰 값을 먼저 보고 앱을 완전히 종료한 뒤 다시 켰는지 확인합니다.
최종 업데이트 2026-11-06 · 연결 방법은 스타일룸 연동 페이지 기준