사용 설명서 › Slima MCP › 시나리오 스튜디오 구조화 파일 보호
시나리오 스튜디오 구조화 파일 보호
마지막 업데이트 2026년 5월 14일 · 약 4분 소요
Slima 시나리오 스튜디오는 MCP를 통해 모든 구조화 파일을 읽기 전용으로 보호합니다 — 의도된 설계입니다.

읽기 전용 파일
| 파일 | 용도 |
|---|---|
series.json |
시리즈 메타데이터 |
season.json |
시즌 메타데이터 |
episode.json |
에피소드 메타데이터 |
*.scene |
씬 파일 (JSON) |
*.character |
인물 파일 |
*.storyline |
스토리라인 |
*.note |
씬 메모 |
*.location |
장소 |
.script_studio/planning/.initialized |
초기화 마커 |
이 중 어느 하나라도 쓰기를 시도하면 → 400 INVALID_PATH.
쓰기가 허용되는 유일한 경로
.script_studio/planning/**/*
이 안에는 자유롭게 넣을 수 있습니다:
- 개요 초안 (
outline.md) - 마인드맵 (
mindmap.md) - 리서치 노트 (
research/...) - AI가 메모하고 싶은 markdown / json / 그 어떤 형식이든
왜 이렇게 설계했나
1 · 스키마 무결성
*.scene은 정해진 스키마를 갖는 JSON입니다 (인물 배열, 장소 참조, 대사 비트). AI가 JSON 구조를 잘못 건드리면 → 씬 보드나 에디터가 깨집니다.
2 · 파일 간 참조 일관성
*.character는 여러 *.scene 파일에서 참조됩니다. 이름을 바꾸면 모든 참조도 함께 바뀌어야 합니다 — MCP는 이러한 파일 간 변경을 원자적으로 안전하게 처리할 수 없습니다.
3 · Slima UI를 거치게 하기
씬 생성, 스토리라인 재구성 같은 작업은 Slima 앱 안에 전용 UI가 있습니다 — MCP가 직접 쓰게 두면 그 UI가 제공하는 이점(참조 자동 갱신, 버전 관리 훅 등)이 사라집니다.
AI가 씬을 직접 편집하게 하고 싶다면
두 가지 길이 있습니다:
방법 1: AI는 planning에 쓰고, 여러분이 Slima UI에서 적용
AI: "**제안 씬**"을 `.script_studio/planning/new-scene-proposals.md`에 작성
여러분: Slima 시나리오 스튜디오 진입 → 씬 보드 → 새 씬 → AI 제안 적용
방법 2: Slima 내장 AI 멘토 사용
Slima의 내장 AI 멘토는 구조화 파일을 직접 쓸 수 있습니다 (앱 내부 경로이며, MCP를 거치지 않습니다).
예외적으로 수정 가능한 .scene 속성
*.scene의 일부 속성(예: description 평문 텍스트)은 patch 작업으로 수정할 수 있지만 — 이는 Slima 앱 내 UI에서만 가능하며, MCP에는 노출되지 않습니다.
관련 문서
도움이 되었습니까?