Slima MCP 完全指南：讓 AI 直接讀寫你的書

複製、貼上、再複製、再貼上——把角色設定貼進對話框，再把第八章貼一次，只為了問 AI 一句「這兩邊有沒有矛盾」。一個下午，搬資料的時間比寫作還多。

問題很單純：AI 看不到你整本書，它只看得到你手動餵的碎片。Slima MCP 就是來解決這件事——設定一次，AI 就能直接讀寫你 Slima 上的書，不再複製貼上。

這篇從怎麼安裝開始，把每一種方法講清楚，最後示範實際怎麼用。

MCP 是什麼？ 全名 Model Context Protocol，是一套開放標準，讓 AI 工具可以直接跟外部服務交換資料。可以想成 AI 世界的 USB：只要工具支援 MCP，就能插上 Slima 讀寫你的書。

---

先選一條路

你平常怎麼用 AI	用哪種安裝
在瀏覽器／手機用 claude.ai 或 ChatGPT	⭐ 網頁連接器（一次設定、永久自動更新、免 token）
在電腦上用 Claude Desktop / Cursor / Gemini CLI	本機 npx 安裝
企業／離線環境	自架（進階）

最推薦第一種——尤其你會用手機寫作的話。

---

方法一（最推薦）：從 claude.ai 或 ChatGPT 網頁版連接

只要你是在瀏覽器或手機 app 裡跟 Claude 或 ChatGPT 對話，這是最簡單、最不會過時的方法。設定一次，之後每一次 Slima MCP 更新都自動跟上——不用打指令、不用改設定檔。

你只需要一個網址： https://mcp.slima.ai/mcp

從 claude.ai 連接（我自己最常用）

1. 登入 claude.ai。
2. 左側欄點 Customize（自訂）→ Connectors（連接器）。
3. 連接器清單右上角點 「+」→ Add custom connector（新增自訂連接器）。
4. 填兩格就好：
   • Name： Slima
   • Remote MCP server URL： https://mcp.slima.ai/mcp
   • 下面的 OAuth Client ID／Secret 留空，不用填。
5. 按 Add → 會跳轉到 slima.ai 要你授權 → 同意後回到 claude.ai。
6. 對話框旁出現 Slima 工具圖示，就完成了。

claude.ai 的網頁連接器在 Pro／Max／Team／Enterprise 方案可用。介面目前是英文，照上面的對應字找即可。

從 ChatGPT 網頁版連接

1. 登入 chatgpt.com。
2. 進 Settings → Connectors → Advanced，打開 Developer Mode（開發者模式）（2025.10 之後的版本）。
3. 回到 Connectors，點 Create → Custom MCP Server。
4. 填：
   • Name： Slima
   • Server URL： https://mcp.slima.ai/mcp
   • Authentication： OAuth
5. 按 Create，完成 OAuth 授權。

設定完，下一次對話 Slima 的工具就會自動出現。不用重開、不用重裝。

---

方法二：本機用 npx（Claude Desktop / Cursor / Gemini CLI / VS Code）

習慣用桌面版工具、想要啟動更快、或要跟其他本機 MCP server 並用，就用這種。核心都一樣：叫工具用 npx 跑 slima-mcp@0。

先認證一次（把登入資訊存在本機）：

npx slima-mcp@0 auth

瀏覽器會打開引導你用 Slima 帳號登入，存到 ~/.slima/credentials.json。或者到 Slima 設定 → API Tokens 拿一組 token，放進下面設定檔的 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_你的token" }
    }
  }
}

重開 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 用的是 servers，不是 mcpServers——這是最常打錯的地方。

為什麼是 slima-mcp@0 不是 slima-mcp？ @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，全程不用複製貼上 token，授權隨時可在 Slima 設定 撤銷。本機 token 存在 ~/.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 Beta Reader

list_personas 列出 Beta Reader 人格 · analyze_chapter 讓特定人格分析整章。

小提醒：Writing Studio 的書這些工具都能用；Script Studio（劇本）的結構檔（場景、角色、分場…）經 MCP 只能讀不能改，要改得在 Slima app 裡操作。

---

真實使用場景

場景一：開始新的寫作日

「幫我看一下這本書的結構，再讀昨天寫的最後一章。」AI 用 get_book_structure + read_file 把上下文備好，直接告訴你昨天寫到哪、接下來照大綱該寫什麼。

場景二：角色一致性檢查

「搜尋老管家在整本書出現的所有段落。」search_content 撈出來，你立刻看到他第三章說自己從不撒謊、第十章卻在隱瞞——伏筆還是手誤，至少現在抓到了。

場景三：修訂（讓 Beta Reader 讀）

「用節奏分析師的人格看第一章。」analyze_chapter 給你節奏、張力、角色弧的回饋；接著「把第三段太長的場景精簡一下」，edit_file 精準改那段，不動其他。

場景四：世界觀整理

「搜尋整本書提到魔法系統規則的段落，整理成一份設定文件存到世界觀資料夾。」search_content → read_file → create_file，散落的碎片變成一份完整參考。

場景五：田調與資料蒐集（寫實題材必看）

寫歷史、地方、職人題材，田調筆記、訪談逐字稿、地點資料常常一大堆。把資料丟進 Slima 的資料夾後，可以說：「比對我第六章的法庭描寫，跟『田調/法院流程.md』有沒有對不上的地方。」或「把訪談筆記裡關於碼頭作業的細節，整理成一份場景參考，存到資料夾。」AI 直接讀你的田調檔、跨檔查證、回填進書——考據不再靠記憶。

場景六：出門在外，用手機跟 Slima 協作

因為網頁連接器是雲端的、免本機設定，你在手機上打開 claude.ai app 就能用。通勤、排隊、咖啡廳，靈感來了就說：「讀一下第八章最後的場景，幫我想三個接下去的走向。」或「把這段對白加到『靈感.md』的最後面。」回到電腦打開 Slima，全部都同步好了。手機負責捕捉與構思，桌機負責正式寫——中間不用傳檔案。

---

常見問題

會不會被別人看到我的內容？ 不會。MCP 只存取你授權帳號的書，AI 只在你下指令時讀或改，不會自己翻、也不會外傳。

可以只讓 AI 讀、不讓它改嗎？ 可以。開頭說一句「今天只看不改」，它就只用讀取類工具（read_file、search_content）。

設定後工具沒反應？ 本機方法最常見是 JSON 格式錯（多逗號、少括號、全形引號）——先用 JSON 驗證工具檢查，再跑 npx slima-mcp@0 status 看認證。網頁連接器則確認網址是 https://mcp.slima.ai/mcp、且已完成授權。

手機上要裝 Node.js 嗎？ 不用。手機用網頁連接器（claude.ai／ChatGPT app），完全不碰指令列。

---

三分鐘，永久改變工作流

最簡單的一條路：到 claude.ai 的 Customize → Connectors，新增一個自訂連接器，網址填 https://mcp.slima.ai/mcp，授權，完成。之後不管在桌機還是手機，跟 AI 說一句「幫我看昨天寫到哪」，它就自己去翻你的書。

時間該花在寫故事上，不是複製貼上。