Scenaloom MCP 도구 레퍼런스

연결된 AI 앱에 Scenaloom MCP 서버가 제공하는 모든 도구와 도구마다 필요한 권한을 정리했습니다. 도구 이름과 앱이 읽는 설명은 영어로 되어 있지만, 앱은 작가의 언어로 답합니다. 앱을 연결하는 방법은 AI 앱과 Scenaloom 연결하기를 참고하세요.

도구

도구	권한	하는 일
list_projects	프로젝트 읽기	작가의 프로젝트를 최신순으로 나열하며, 검색어나 유형(대본, 소설, 시네마)으로 거를 수 있습니다.
get_project	프로젝트 읽기	프로젝트의 제목, 설명, 유형, 작가의 역할, 장면 수가 붙은 에피소드 목록, 인물과 장소와 열린 댓글의 개수를 알려 줍니다.
read_script	프로젝트 읽기	에피소드의 대본을 유형별 블록(씬 헤딩, 지문, 인물, 대사, 괄호 지문, 전환, 숏)이나 Fountain으로 읽으며, 일부 구간이나 장면 하나씩 수정에 필요한 리비전과 해시와 함께 가져옵니다.
list_scenes	프로젝트 읽기	에피소드의 장면을 순서대로 보여 주며, 씬 헤딩, 장소, 등장인물, 블록 범위, 요약이 함께 나옵니다.
list_entities	프로젝트 읽기	프로젝트의 인물, 장소, 소품을 세부 정보, 등장 장면 수, 인물 관계와 함께 보여 줍니다.
get_story_structure	프로젝트 읽기	비트, 프로젝트 개요, 에피소드 개요를 가져옵니다.
read_novel	프로젝트 읽기	소설의 장 목록을 보거나, 한 장의 본문을 최대 40,000자 단위로 수정에 필요한 리비전과 함께 읽습니다.
search_project	프로젝트 읽기	프로젝트의 대본, 소설, 인물과 장소, 댓글, 비트에서 대사, 이름, 구절을 찾습니다.
list_comments	프로젝트 읽기	프로젝트의 열린 댓글이나 해결된 댓글을 위치, 작성자, 작성한 앱과 함께 보여 줍니다.
list_generations	프로젝트 읽기	이미지, 영상, 오디오 생성 작업을 상태와 크레딧과 함께 나열합니다.
get_generation	프로젝트 읽기	생성 작업 하나의 상태, 진행률, 사용하거나 환불된 크레딧, 결과를 알려 줍니다.
propose_script_edits	대본과 소설 편집	에피소드에 수정을 최대 여섯 개(지문 넣기, 대사 고쳐 쓰기, 텍스트 바꾸기, 모두 바꾸기, 비트 추가)까지 준비해 변경 전후 미리 보기를 돌려주며, apply_script_edits 전에는 아무것도 바꾸지 않습니다.
apply_script_edits	대본과 소설 편집	작가가 승인한 제안을 적용하며, 실시간 편집과 병합되고 버전 기록에 남고 되돌릴 수 있습니다.
undo_script_edits	대본과 소설 편집	적용한 수정 묶음을 되돌리며, 나중의 수정과 충돌하면 되돌리지 않습니다.
propose_novel_edits	대본과 소설 편집	한 장에 대한 찾아 바꾸기나 덧붙일 단락을 준비해 미리 보기를 돌려주며, 찾는 구절은 장 안에 정확히 한 번만 나와야 합니다.
apply_novel_edits	대본과 소설 편집	승인된 소설 제안을 적용하며, 같은 장을 동시에 쓰는 사람의 입력과 병합됩니다.
undo_novel_edits	대본과 소설 편집	적용한 소설 수정을 장에서 되돌리며, 그 뒤에 쓴 글은 남깁니다. 수정된 부분이 다시 고쳐졌다면 되돌리지 않습니다.
update_entity	대본과 소설 편집	인물·장소·소품의 세부 정보를 바꿉니다. 읽은 뒤 누군가 항목을 바꿨다면 거절됩니다. 작가는 하루 동안 AI 패널에서 되돌릴 수 있습니다.
undo_entity_update	대본과 소설 편집	update_entity로 바꾼 내용을 되돌립니다. 그 항목이 나중에 다시 고쳐졌다면 되돌리지 않습니다.
create_project	대본과 소설 편집	작가의 요금제 한도 안에서 시나리오나 소설 프로젝트를 만듭니다.
create_episode	대본과 소설 편집	시리즈에 에피소드를 추가합니다.
add_comment	댓글 달기	대본 블록에 연결된 앱이 쓴 것으로 표시되는 메모를 남기며, 공동 작업자에게는 작가가 확인할 때만 알림이 갑니다.
resolve_comment	댓글 달기	댓글을 해결 처리하거나 다시 엽니다.
get_credits	크레딧 사용	작가의 크레딧 잔액과 요금제, 이 앱의 지출 설정과 일일 한도, 오늘 쓴 크레딧을 알려 줍니다.
quote_generation	크레딧 사용	크레딧을 쓰지 않고 이미지, 영상, 오디오 생성의 가격을 계산해, 5분 동안 유효한 일회용 견적을 돌려줍니다.
start_generation	크레딧 사용	작가가 비용을 확인한 뒤에만 견적 크레딧을 써서 생성을 시작합니다.
cancel_generation	크레딧 사용	진행 중인 생성을 취소하며, 크레딧은 크레딧 정책에 따라 환불됩니다.

읽기 도구는 아무것도 바꾸지 않습니다. 편집 도구는 작가가 승인한 제안을 거쳐서만 작업물을 바꾸며, 적용한 묶음은 모두 되돌릴 수 있습니다. 크레딧을 쓰는 도구는 start_generation 하나뿐이고, 그마저도 작가가 견적 비용을 확인한 뒤에만 씁니다.

수정이 이뤄지는 과정

앱이 read_script로 장면을 읽습니다. 각 블록의 id와 대본의 리비전이 함께 돌아옵니다.
앱이 변경을 최대 여섯 개까지 담아 propose_script_edits를 호출합니다. Scenaloom은 변경을 검사해 각각의 변경 전후 미리 보기를 돌려줍니다. 제안은 30분 동안 유지되며 에디터의 AI 패널에도 표시됩니다.
앱이 미리 보기를 보여 줍니다. 작가가 동의하면 apply_script_edits를 호출합니다. 그사이 누군가 대본을 바꿨다면 적용이 거부되고 앱은 다시 읽습니다.
결과에는 묶음 id가 나옵니다. 그 id로 undo_script_edits를 호출하면 묶음이 되돌려지며, 어느 쪽이든 이전 초고는 버전 기록에 남습니다.

소설도 read_novel, propose_novel_edits, apply_novel_edits로 같은 방식으로 작동합니다. 바꿀 구절은 장 안에 정확히 한 번만 나와야 하므로, 수정이 엉뚱한 곳에 들어갈 일이 없습니다.

생성 비용이 결제되는 과정

quote_generation은 아무것도 쓰지 않고 요청의 가격을 계산해, 5분 동안 유효하고 한 번만 쓸 수 있는 견적을 돌려줍니다.
앱은 비용과 결제 후 잔액을 알려 주고, 작가가 동의할 때만 start_generation을 호출합니다. 확인 기능을 지원하는 앱에서는 Scenaloom의 확인 화면이 직접 나타나고, 그렇지 않은 앱은 작가가 정한 일일 한도 안에서만 쓸 수 있습니다.
get_generation이 진행 상황과 결과를 알려 줍니다. 견적 뒤에 가격이 바뀌었다면 Scenaloom은 시작을 거부하며, 실패한 생성은 크레딧 정책에 따라 환불됩니다.

리소스와 프롬프트

리소스를 탐색할 수 있는 앱은 프로젝트, Fountain 형식의 에피소드, 소설의 장, 프로젝트의 스토리 바이블(인물, 장소, 소품, 관계, 비트, 개요)을 대화에 첨부할 수 있습니다. 프롬프트로는 자주 하는 작업을 바로 시작합니다. 스크립트 닥터 점검, 비트 구조 메모, 장면 고쳐 쓰기, 리딩 메모, 로그라인과 시놉시스 작성이 있습니다. 프롬프트 제목은 Scenaloom 인터페이스 언어를 따릅니다.

앱이 알려 줄 수 있는 오류

메시지	해결 방법
제안 뒤 대본이 바뀜 (The script changed after the proposal)	장면을 다시 읽고 다시 제안합니다.
권한 부족 (Insufficient scope)	앱에 필요한 권한이 없습니다. 연결된 앱에서 앱의 연결을 해제한 뒤, 다시 연결하면서 그 권한에 체크합니다.
찾을 수 없음 (Not found)	프로젝트가 삭제되었거나, 더 이상 그 프로젝트에 접근할 수 없습니다.
이 앱은 지출을 확인할 수 없음 (This app can't confirm spending)	앱에 일일 크레딧 한도를 정하거나, Scenaloom에서 직접 생성을 시작합니다.
요청 한도 초과 (Rate limited)	안내된 시간(초)만큼 기다린 뒤 다시 시도합니다.