Slima MCP 완전 가이드 | AI가 당신의 책을 읽고 쓰게

복사. 붙여넣기. 다시 복사. 다시 붙여넣기 — 인물 설정을 대화창에 붙이고, 8장을 또 붙입니다. 그저 “이 둘이 서로 모순되나?“를 묻기 위해서요. 오후 한나절, 글보다 자료 나르는 데 시간을 더 씁니다.

문제는 간단합니다. AI가 당신의 책 전체를 보지 못한다는 것. 손으로 떠먹여 준 조각만 봅니다. Slima MCP가 바로 이걸 해결합니다 — 한 번만 설정하면 AI가 Slima에 있는 당신의 책을 직접 읽고 씁니다. 복사·붙여넣기는 끝입니다.

이 글은 설치 방법부터 시작해 각 방식을 분명히 짚고, 마지막에 실제 활용법을 보여 드립니다.

MCP가 무엇인가요? Model Context Protocol의 약자로, AI 도구가 외부 서비스와 데이터를 직접 주고받게 하는 개방형 표준입니다. AI 세계의 USB라고 보시면 됩니다 — MCP를 지원하는 도구라면 Slima에 꽂아 당신의 책을 읽고 쓸 수 있습니다.

먼저 길을 고르십시오

평소 AI를 어떻게 쓰나요	어떤 설치
브라우저·휴대폰에서 claude.ai 또는 ChatGPT	⭐ 웹 커넥터(한 번 설정, 영구 자동 업데이트, 토큰 불필요)
컴퓨터에서 Claude Desktop / Cursor / Gemini CLI	로컬 `npx` 설치
기업·오프라인 환경	셀프 호스팅(고급)

첫 번째가 가장 쉽습니다 — 특히 휴대폰으로도 글을 쓴다면요.

방법 1(가장 추천): claude.ai 또는 ChatGPT 웹에서 연결

브라우저나 휴대폰 앱에서 Claude 또는 ChatGPT와 대화한다면 이게 가장 간단하고 가장 안 낡는 방법입니다. 한 번 설정하면 이후 모든 Slima MCP 업데이트가 자동으로 따라옵니다 — 명령어도, 설정 파일도 없습니다.

필요한 건 주소 하나입니다: https://mcp.slima.ai/mcp

claude.ai에서 연결(제가 제일 자주 쓰는 방법)

claude.ai에 로그인합니다.
왼쪽 사이드바에서 Customize → Connectors를 엽니다.
커넥터 목록 오른쪽 위에서 ”+” → Add custom connector를 누릅니다.
두 칸만 채웁니다:
- Name: Slima
- Remote MCP server URL: https://mcp.slima.ai/mcp
- 아래 OAuth Client ID / Secret은 비워 둡니다.
Add를 누르면 → slima.ai로 이동해 승인하고 → claude.ai로 돌아옵니다.
대화창 옆에 Slima 도구 아이콘이 나타나면 끝입니다.

웹 커넥터는 claude.ai의 Pro / Max / Team / Enterprise 요금제에서 쓸 수 있습니다. 인터페이스는 영어로 표시되니 위 단어를 그대로 찾으시면 됩니다.

ChatGPT 웹에서 연결

chatgpt.com에 로그인합니다.
Settings → Connectors → Advanced에서 **Developer Mode(개발자 모드)**를 켭니다(2025.10 이후).
다시 Connectors에서 Create → Custom MCP Server를 누릅니다.
채웁니다:
- Name: Slima
- Server URL: https://mcp.slima.ai/mcp
- Authentication: OAuth
Create를 누르고 OAuth 승인을 마칩니다.

설정이 끝나면 다음 대화부터 Slima 도구가 자동으로 나타납니다. 재시작도, 재설치도 없습니다.

방법 2: 로컬에서 npx로(Claude Desktop / Cursor / Gemini CLI / VS Code)

데스크톱 도구가 익숙하거나, 더 빠른 시작을 원하거나, 다른 로컬 MCP 서버와 함께 돌려야 한다면 이 방식입니다. 핵심은 어디서나 같습니다 — 도구가 npx로 slima-mcp@0을 실행하게 하는 것.

먼저 한 번 인증합니다(로그인 정보를 로컬에 저장):

npx slima-mcp@0 auth

브라우저가 열려 Slima 계정 로그인을 안내하고 ~/.slima/credentials.json에 저장합니다. 또는 Slima 설정 → API Tokens에서 토큰을 받아 아래 설정의 SLIMA_API_TOKEN에 넣어도 됩니다.

Claude Desktop

claude_desktop_config.json을 편집합니다(macOS는 ~/Library/Application Support/Claude/, Windows는 %APPDATA%\Claude\):

{
  "mcpServers": {
    "slima": {
      "command": "npx",
      "args": ["-y", "slima-mcp@0"],
      "env": { "SLIMA_API_TOKEN": "slima_여기에_토큰" }
    }
  }
}

Claude Desktop을 재시작하고 대화창 옆에 도구 아이콘이 보이면 연결된 것입니다. (이미 auth를 돌렸다면 env 부분은 생략해도 됩니다.)

Cursor

프로젝트 루트에 .cursor/mcp.json을 만들고 위 Claude Desktop과 같은 내용을 넣습니다. Cursor가 자동으로 감지해 필요할 때 실행합니다.

Gemini CLI

한 줄입니다:

gemini mcp add slima --command "npx -y slima-mcp@0"

VS Code

.vscode/mcp.json을 만듭니다:

{
  "servers": {
    "slima": {
      "command": "npx",
      "args": ["-y", "slima-mcp@0"]
    }
  }
}

⚠️ VS Code는 mcpServers가 아니라 **servers**를 씁니다 — 가장 흔한 실수입니다.

왜 slima-mcp가 아니라 slima-mcp@0인가요? @0은 현재 메이저 버전에 고정합니다. npx는 새 0.x 릴리스를 계속 자동으로 받아 오지만(기능·수정 모두 반영), 호환성을 깨는 1.0이 나와도 설정을 안 바꾼 당신에게 몰래 올라가지 않습니다.

전역 설치를 원하면? npm install -g slima-mcp도 됩니다. 다만 가끔 npm install -g slima-mcp@latest로 업데이트해, 로컬 버전이 Slima 백엔드가 제공하는 도구와 어긋나지 않게 하십시오.

인증과 보안

npx slima-mcp@0 auth — 브라우저로 로그인(추천)
npx slima-mcp@0 status — 현재 인증 상태 확인
npx slima-mcp@0 logout — 저장된 로그인 정보 제거

웹 커넥터는 OAuth를 씁니다 — 토큰을 복사·붙여넣지 않으며, 권한은 Slima 설정에서 언제든 철회할 수 있습니다. 로컬 토큰은 ~/.slima/credentials.json에 보호된 권한으로 저장됩니다. Slima MCP는 당신이 승인한 계정의 책만 건드리고, AI는 당신이 시킬 때만 읽거나 씁니다.

열다섯 개 도구, 세 묶음

책 관리

create_book 새 책 · list_books 전체 목록 · get_book 책 정보 · get_book_structure 책 전체 파일 트리(AI에게 전체 그림을 줘 이후 작업이 더 정확) · get_writing_stats 집필 통계.

파일 작업

read_file / get_chapter 파일 읽기(가장 많이 씀) · write_file 파일 덮어쓰기 · edit_file 정밀 검색·치환 · create_file 새 파일 · delete_file 삭제 · append_to_file 끝에 추가 · search_content 모든 파일 전문 검색(일관성 유지의 결정타).

AI 베타 리더

list_personas 베타 리더 페르소나 목록 · analyze_chapter 특정 페르소나로 한 장 분석.

참고: 이 도구들은 글쓰기 스튜디오 책에서 모두 동작합니다. 시나리오 스튜디오(시나리오)의 구조 파일(신·인물·스토리라인…)은 MCP로는 읽기 전용이며, 편집은 Slima 앱에서 하십시오.

실제 활용 장면

1. 집필을 시작하는 날

“이 책의 구조를 보여 주고, 어제 쓴 마지막 장을 읽어 줘.” AI가 get_book_structure + read_file로 맥락을 챙겨, 어디까지 썼고 개요상 다음에 무엇이 오는지 바로 알려 줍니다.

2. 인물 일관성 점검

“늙은 집사가 등장하는 모든 대목을 찾아 줘.” search_content가 끌어모아 주고, 그가 3장에선 거짓말을 안 한다더니 10장에선 뭔가 숨기는 걸 바로 발견합니다. 복선이든 실수든, 적어도 지금 잡았습니다.

3. 퇴고(베타 리더에게 읽히기)

“페이싱 분석가 페르소나로 1장을 봐 줘.” analyze_chapter가 속도·긴장·인물 곡선을 짚어 주고, 이어서 “세 번째 문단의 너무 긴 장면을 줄여 줘”라고 하면 edit_file이 그 부분만 정확히 손봅니다.

4. 세계관 정리

“마법 체계 규칙을 언급한 모든 대목을 찾아 세계관 폴더에 설정 문서 하나로 정리해 줘.” search_content → read_file → create_file로 흩어진 조각이 하나의 기준 문서가 됩니다.

5. 자료 조사가 많은 작품(필드 리서치)

역사·지역·직업 소재는 취재 노트, 인터뷰 녹취, 장소 자료가 잔뜩 쌓입니다. Slima 폴더에 넣어 두고 이렇게 말하십시오. “6장 법정 묘사를 ‘자료/법원절차.md’와 대조해서 어긋나는 곳이 있는지 봐 줘.” 또는 “인터뷰 노트에서 부두 작업 관련 디테일을 장면 참고용으로 정리해 폴더에 저장해 줘.” AI가 자료 파일을 직접 읽고, 교차 확인하고, 사실을 책에 되돌려 넣습니다 — 고증을 기억에 기대지 않아도 됩니다.

6. 밖에서, 휴대폰으로 Slima와 협업

웹 커넥터는 클라우드 기반이라 로컬 설정이 없어, 휴대폰의 claude.ai 앱에서 그대로 쓸 수 있습니다. 출퇴근길, 줄을 선 채로, 카페에서 — 영감이 떠오르면 그냥 말하십시오. “8장 마지막 장면을 읽고, 이어질 전개를 세 가지 제안해 줘.” 또는 “이 대사를 ‘아이디어.md’ 끝에 추가해 줘.” 책상으로 돌아와 Slima를 열면 전부 동기화돼 있습니다. 휴대폰은 포착과 구상, 데스크톱은 본격 집필 — 사이에 파일을 주고받지 않습니다.

자주 묻는 질문

남이 내 내용을 볼 수 있나요? 아니요. MCP는 당신이 승인한 계정의 책만 건드리고, AI는 시킬 때만 읽거나 쓰며, 무엇도 외부로 보내지 않습니다.

읽기만 시키고 수정은 막을 수 있나요? 네. 처음에 “오늘은 읽기만”이라고 말하면 읽기 도구(read_file, search_content)만 씁니다.

설정 후 도구가 반응이 없어요. 로컬 방식은 십중팔구 JSON 오타(쉼표 과다, 중괄호 누락, 전각 따옴표)입니다 — 파일을 검증한 뒤 npx slima-mcp@0 status로 인증을 확인하십시오. 웹 커넥터는 주소가 https://mcp.slima.ai/mcp인지, 승인을 마쳤는지 확인하십시오.

휴대폰에 Node.js를 깔아야 하나요? 아니요. 모바일에서는 웹 커넥터(claude.ai / ChatGPT 앱)를 쓰며, 명령줄은 전혀 건드리지 않습니다.

3분, 영구히 더 나은 작업 흐름

가장 짧은 길: claude.ai에서 Customize → Connectors로 가서 주소 https://mcp.slima.ai/mcp로 커스텀 커넥터를 추가하고 승인하면 끝입니다. 이후로는 — 데스크톱이든 휴대폰이든 — AI에게 “어제 어디까지 썼는지 보여 줘” 한마디면 알아서 당신의 책을 펼쳐 봅니다.

시간은 이야기에 써야 합니다. 복사·붙여넣기가 아니라.

이어서 읽기

이어 읽을 관련 글.

아카데미

최고의 배움은 완성된 한 페이지.

막힐 때 읽고, 나머지 시간엔 쓰십시오. 프로젝트를 무료로 시작하십시오.

무료로 쓰기 시작하기 허브로 돌아가기

Slima MCP 완전 가이드: AI가 당신의 책을 직접 읽고 쓰게