파일 조작 도구 (7종)

파일 단위로 동작하는 7개 도구 — MCP가 실제로 원고를 손대는 부분입니다.

1 · read_file

파일 하나를 읽습니다.

• book_token, path (예: Chapters/Chapter 1.md)
• 본문 + 메타데이터(타입, 마지막 수정 시각)를 돌려줍니다

2 · edit_file

파일의 일부만 교체합니다(텍스트 패턴 매칭 방식).

• path, old_text, new_text
• 정밀하게 해당 부분만 수정하며, 다른 단락은 건드리지 않습니다

가장 자주 쓰이는 도구입니다 — AI 퇴고는 거의 이걸로 합니다.

3 · write_file

파일 전체를 덮어씁니다.

• path, content
• ⚠️ 기존 내용은 전부 사라집니다
• 용도: 한 파일을 통째로 다시 쓰거나, 새 파일의 초기 내용을 채워 넣을 때

4 · create_file

새 파일을 만듭니다.

• path, content, type (manuscript / reference)
• 같은 경로에 파일이 이미 있으면 실패합니다

5 · delete_file

파일을 삭제합니다(작품별 휴지통으로 이동하며, 완전 삭제가 아닙니다).

• path
• 30일 이내라면 복원 가능합니다 — 파일과 폴더 관리 참고

6 · append_to_file

파일 끝에 내용을 이어 붙입니다.

• path, content
• "3장 이어서 써줘" 같은 흐름에 잘 맞습니다

7 · search_content

전문 검색입니다.

• book_token, query, scope (chapter / book)
• 매치된 결과를 path + 단락 + 행 번호와 함께 돌려줍니다

권한 모델

글쓰기 스튜디오 작품: 7개 도구 모두 어떤 경로에도 쓸 수 있습니다.

시나리오 스튜디오 작품: 구조화된 파일은 읽기 전용입니다 (*.scene / *.character / series.json 등). 쓰기는 .script_studio/planning/ 안에서만 허용됩니다.

함께 보기:

• 스튜디오별 MCP 동작 차이
• 시나리오 스튜디오 구조화 파일 보호

자동 버전

쓰기 계열 도구(edit_file / write_file / create_file / delete_file / append_to_file)는 변경을 적용하기 직전에 자동으로 버전을 만들어 둡니다.

함께 보기: 자동 버전 규칙

관련 문서

• 작품 관리 도구
• AI 베타 리더 도구
• 스튜디오별 MCP 동작 차이