schema 리소스로 작품 권한 정확하게 조회하기

MCP에는 툴(tools)만 있는 것이 아닙니다 — 리소스(resources) 도 있습니다. schema 리소스는 그중에서도 핵심인데, 작품 하나의 정확한 권한 규칙을 AI에게 알려줍니다.

사용 방법

Resource URI: slima://books/{book_token}/schema

MCP를 지원하는 클라이언트는 툴을 호출할 필요 없이 리소스를 직접 읽어올 수 있습니다.

# 의사 코드 (실제 호출 방식은 클라이언트의 resource API에 따라 다름)
schema = read_resource("slima://books/bk_xxx/schema")

반환되는 내용

{
  "book_token": "bk_xxx",
  "book_type": "script",
  "writable_paths": [".script_studio/planning/**/*"],
  "readonly_paths": [
    "*.scene",
    "*.character",
    "*.storyline",
    "*.note",
    "*.location",
    "series.json",
    "season.json",
    "episode.json",
    ".script_studio/planning/.initialized"
  ],
  "structured_extensions": [".scene", ".character", ".storyline", ".note", ".location"],
  "search_excludes_structured_by_default": true
}

이 리소스가 존재하는 이유

*.scene 같은 경로에 직접 쓰기를 시도하면 어차피 400 에러로 막힙니다 — 하지만 schema를 먼저 호출하면 그 경로가 read-only라는 사실을 미리 알 수 있어서, API 호출 한 번을 헛되이 낭비하지 않아도 됩니다.

AI에게 권장하는 워크플로

1. list_books → book_token 확보
2. read_resource(slima://books/{token}/schema) → 권한 규칙 확보
3. 규칙에 맞춰 안전하게 read / write 계획 수립
4. 실제 작업 실행

MCP를 지원하는 클라이언트(Claude / Cursor)는 리소스를 자동으로 AI에게 펼쳐서 보여주기 때문에, AI가 명시적으로 호출할 필요가 없습니다.

글쓰기 스튜디오 작품의 schema

{
  "book_token": "bk_xxx",
  "book_type": "book",
  "writable_paths": ["**/*"],
  "readonly_paths": [],
  "structured_extensions": [],
  "search_excludes_structured_by_default": false
}

단순합니다 — 모든 경로가 쓰기 가능하고, 구조화된 파일도 없습니다.

관련 문서

• 스튜디오별 MCP 동작 차이
• 시나리오 스튜디오 구조화 파일 보호
• Cloudflare Worker로 셀프 호스팅