사용 설명서Slima MCP › 시나리오 스튜디오 구조화 파일 보호

시나리오 스튜디오 구조화 파일 보호

마지막 업데이트 2026년 5월 14일 · 약 4분 소요

Slima 시나리오 스튜디오는 MCP를 통해 모든 구조화 파일을 읽기 전용으로 보호합니다 — 의도된 설계입니다.

Slima 스튜디오 선택 화면 — 글쓰기 스튜디오 / 시나리오 스튜디오 / AI 베타 리더 세 가지 스튜디오 카드

읽기 전용 파일

파일 용도
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에는 노출되지 않습니다.

관련 문서

도움이 되었습니까?