# AI 連線（Claude Code、Codex、LM Studio 等）

> 讓你 Mac 上的 Claude Code、Codex、LM Studio 或其他支援 MCP 的 AI App 讀取你的專案、新增卡片，並在專案裡建立 HTML 頁面。

Source: https://writermorph.com/zh-hant/help/ai-connections/

WriterMorph 本身沒有 AI。你可以讓 Mac 上的 AI App 在 WriterMorph 中打開的專案裡工作：**Claude Code**、**Codex**、**LM Studio**，或任何支援 MCP 的 AI App，不論品牌。它處理的卡片和你處理的一樣：它可以起草新卡片、填寫卡片屬性、撰寫與修訂文字、重新整理活頁夾、把 HTML 頁面建成分頁、搜尋專案並加以編譯。

AI 連線是 Mac 版 WriterMorph 的功能，iPad App 不包含這項功能。

這項連線**預設為關閉**，WriterMorph 關閉時什麼都不會執行。

## 開啟
1. 打開「**設定**」（⌘,）並選擇「**AI 連線**」。
2. 開啟「**開啟 AI 連線**」。
3. 在「**AI App 可能做什麼**」下，如果你只想讓助理讀取，就讓「**允許變更**」保持關閉。開啟它，才能讓助理新增與編輯卡片和分頁。
4. 「**允許刪除**」是另外的開關。刪除的卡片與分頁會進入垃圾桶。

窗格頂端的標章會顯示狀態：「**關閉**」、「**開啟 · 等待 App**」，或是「**已連接：**」加上已連接 App 的名稱，例如 Claude Code 或 LM Studio。

## 連接你的 AI App（僅需一次）
WriterMorph 可以搭配你 Mac 上任何能使用 MCP 伺服器的 AI App，不論品牌。請在下方選擇你用的 App。每個 App 都需要 WriterMorph 的位址和你的私密金鑰；若是 Claude Code 和 Codex，WriterMorph 會替你把兩者放進一道設定指令，若是 LM Studio，則放進一個點一下就能用的連結。

### Claude Code（Anthropic）或 Codex（OpenAI）
1. 如果 Mac 上還沒有這個 App，先安裝它。它使用你自己的 Claude 或 ChatGPT 帳號。
2. 在「**設定 › AI 連線**」的「**連接 App（僅需一次）**」下，選擇「**Claude Code**」或「**Codex**」，然後點選「**拷貝並開啟終端機**」。
3. 在終端機視窗中點一下，按 ⌘V，再按 Return。
4. 輸入 `claude`（或 `codex`）並按 Return。然後用平常的話提出要求，例如：「列出我開啟的 WriterMorph 專案中的分頁。」

步驟下方的那一列會變成綠色，並顯示 App 已連線。要在終端機中確認，請執行 `claude mcp list`（或 `codex mcp list`）。

### LM Studio：本機 AI，資料不會離開你的 Mac
1. 安裝 LM Studio（0.3.17 或以上版本），並下載一個能使用工具的模型。
2. 在「**設定 › AI 連線**」的「**連接 App（僅需一次）**」下，選擇「**LM Studio**」，然後點選「**加入 LM Studio**」。LM Studio 會打開，WriterMorph 已準備好可以加入。如果它詢問，請點選「**Install**」。
3. 開始新的聊天，選擇模型，然後用平常的話提出要求。

如果想手動加入 WriterMorph，請打開 LM Studio 右側邊欄的「**Program**」分頁，然後選擇「**Install › Edit mcp.json**」。用你自己的金鑰加入 WriterMorph，然後儲存：

```json
{
  "mcpServers": {
    "writermorph": {
      "url": "http://127.0.0.1:47821/mcp",
      "headers": { "Authorization": "Bearer YOUR-KEY" }
    }
  }
}
```

如果檔案中已經列有其他伺服器，只要把 `"writermorph"` 這一段加到 `"mcpServers"` 裡面。

### 其他 AI App，不論品牌
任何能透過 HTTP 連接 MCP 伺服器的 App 都可以，例如 Msty Studio、Cherry Studio、Jan 或 Cline。在「**設定 › AI 連線**」的「**連接 App（僅需一次）**」下選擇「**其他 App**」，WriterMorph 會顯示它的位址和你的金鑰，各附一個拷貝按鈕。然後在該 App 的 MCP 設定中（有時叫做 Tools 或 Connectors）加入一個伺服器：

- **類型：** HTTP（Streamable HTTP）
- **名稱：** writermorph
- **位址（URL）：** `http://127.0.0.1:47821/mcp`
- **標頭：** `Authorization`，值為 `Bearer YOUR-KEY`

如果 App 要求 JSON，請點選「**拷貝 JSON**」：這和 LM Studio 用的是同一個項目。然後選擇能使用工具的模型，用平常的話提出要求。

### 例如 Grok
Grok（xAI）的連接方式和其他 App 一樣。使用 Grok 有三種方式：

- **Grok Build**：xAI 的終端機 App。從 [xAI 的 Grok Build 頁面](https://docs.x.ai/build/overview)安裝並登入。然後在終端機中執行一次這道指令，把 YOUR-KEY 換成你自己的金鑰：
  ```
  grok mcp add --transport http writermorph http://127.0.0.1:47821/mcp --header "Authorization: Bearer YOUR-KEY"
  ```
  輸入 `grok`，按 Return，然後用平常的話提出要求。
- **在桌面聊天 App 中使用 Grok**，例如 Msty Studio、Cherry Studio、Jan 或 Cline。先在該 App 中加入你的 xAI API 金鑰，再依照「[其他 AI App](#other-ai-apps-any-brand)」的說明，把 WriterMorph 加為 MCP 伺服器。
- **grok.com、Grok App 和 Grok Bot** 在 xAI 的雲端執行。它們無法連到 WriterMorph，因為 WriterMorph 只接受來自你自己 Mac 的連線。

### 在哪裡找到你的金鑰
在「**設定 › AI 連線**」中點選「**顯示指令**」，再點選「**顯示金鑰**」。`Bearer` 後面那一長串文字就是你的金鑰。它的作用就像密碼：請不要分享，也不要張貼到網路上。

### 如果 App 連不上了
這通常發生在「**建立新金鑰…**」之後：App 裡還是舊的金鑰。請用新金鑰重新設定：

- **Claude Code：** 在終端機中執行 `claude mcp remove --scope user writermorph`。然後再點選一次「**拷貝並開啟終端機**」，按 ⌘V，再按 Return。
- **Codex：** 再點選一次「**拷貝並開啟終端機**」。這道指令會取代舊的設定。
- **Grok Build：** 執行 `grok mcp remove writermorph`，然後用新金鑰執行上面的 `grok mcp add` 指令。
- **LM Studio 和其他 App：** 在它們的設定中替換金鑰。

AI App 會在工作階段開始時連線，所以之後請開始新的工作階段。在 Claude Code 中，你也可以輸入 `/mcp`，選擇「**writermorph**」，再選「**Reconnect**」。

### 中斷 App 的連線
在「**已連接的 App**」下，點選該 App 旁邊的「**中斷連線…**」。WriterMorph 會拷貝移除指令並打開終端機：按 ⌘V，再按 Return，然後點選「**完成**」。LM Studio 和其他 App 則請在該 App 的 MCP 設定中移除 writermorph 伺服器，然後點選「**從列表移除**」。要一次暫停所有 App，請改為關閉 AI 連線。

## 使用中的服務
當 AI 連線或某項 Labs 功能開啟時，頂端列與主畫面上會顯示一個小小的「**使用中的服務**」指示器：一個彩色圓點加上已連線的 App，以及有多少項 Labs 功能已開啟。

點選它會打開「**使用中的服務**」視窗。你可以在那裡開啟或關閉 AI 連線、更改「**允許變更**」與「**允許刪除**」、查看已連接的 App 與「**AI App 做了什麼**」（自 WriterMorph 打開以來最近的 40 個動作），並開啟或關閉各項 Labs 功能。

## 可以要求的事
**規劃與屬性**

- 「把這個前提規劃成三幕式小說：各幕、六個場景、角色與地點。」
- 「為第二幕的每個場景填入視角、節拍、張力與地點。」
- 「把第 5 章的四個小節都標為草稿，並把每個目標設為 900 字。」
- 「為每個場景加上故事日期與時間，並標出倒敘。」
- 「把這份文件的各節變成第 3 章之下的卡片。」
- 「為每張沒有摘要的卡片寫兩行摘要。」

**專案裡的頁面**

- 「用這份文件做一個分頁式的 HTML 頁面，並在新分頁中打開。」
- 「做一份角色檔案：角色陣容、誰和誰共享場景、逐場景圖表與每個人的弧線。」
- 「為我的文獻回顧繪製地圖：依主題與年份整理資料來源、各自被引用的地方，以及我還沒引用過的內容。」
- 「建立一份故事設定集，附角色、地點與時序的分頁。」
- 「把第 2 章變成附閃卡與自我測驗的讀書頁面。」
- 「用表 4.1 做一個結果儀表板。」

**資料庫、資料表等等**

- 「做一個資料庫『資料來源』，欄位有作者、年份、網址與狀態，並加入這份清單中的書。」
- 「為每個角色加上連到『陣營』資料庫的陣營關聯。」
- 「把 Mara 的物品放進資料表：品項、數量與她找到的地方。」
- 「把博物館的網頁附加到港口卡片。」
- 「把第三幕的卡片移到名為『草稿』的規劃。」

要自己查看與編輯資料庫，請開啟「**設定 › Labs › 資料庫**」。請參閱[資料庫與資料卡](https://writermorph.com/zh-hant/help/databases/)。

## HTML 頁面
當你要求做一個頁面、報告或儀表板時，助理會在專案中建立一個新的 **HTML 分頁**。這些頁面：

- 會跟隨 WriterMorph 的淺色或深色設定，
- 在標頭中有縮放與全寬控制項，
- 會記住它們內部的分頁與縮放，
- 儲存在 `.wmorph` 專案檔案裡，所以會隨專案一起移動。

HTML 分頁會在即時頁面旁邊顯示原始碼，你可以編輯原始碼。

你也可以要求做一個和 WriterMorph 範本風格相同的 [Live Page](https://writermorph.com/zh-hant/help/live-pages/)，例如讀書會的追蹤器，或補助申請的儀表板。WriterMorph 會給助理一項 **Live Page Designer** 技能：它會從 48 個內建範本中最接近的一個開始，讀取它的原始碼，並為你的要求打造一個外觀與控制項相同的頁面。

## 安全性
- 這項連線只接受來自你自己 Mac 的要求，而且需要私密金鑰。「安全性」下的「**建立新金鑰…**」會取代金鑰；舊的設定指令就會失效。
- 助理的更動可以用 ⌘Z 還原。
- 「**最近活動**」會列出助理做了什麼。
- 助理傳送給它自己服務的內容，受該供應商的條款約束。WriterMorph 本身不會傳送任何東西。

## 回到 AI 編輯之前
在助理更動 HTML 頁面、筆記或文件之前，WriterMorph 會先保留它原本樣子的拷貝。

- 對於 HTML 頁面，請在分頁標頭中選擇「**檔案 ▾ › 還原 AI 編輯之前 ▸**」並挑選一個版本。
- 對於筆記或文件，請點選它標頭中的時鐘按鈕。

還原時也會保留目前內容的拷貝，所以你還能再改變主意。規劃中的卡片更動，則一如往常以「**編輯 › 還原**」復原。
