diff --git a/README.md b/README.md
index 69d2342..167b582 100644
--- a/README.md
+++ b/README.md
@@ -175,6 +175,19 @@ wrangler secret put ENCRYPTION_KEY --name arcrun-auth-service-account
 - **幫客戶接案**：在客戶資料夾放一份 `.arcrun.yaml`（含該客戶的 cypher URL / api_key）→ 只在這個資料夾樹生效，離開自動切回全域。`.arcrun.yaml` 含憑證，`init` 會自動幫你加進 `.gitignore`。
 - **不確定現在用哪個帳號？** `acr config --where` 會逐欄告訴你每個值來自哪一層。
 
+### 讓 AI（Claude Code）連到對的 arcrun
+
+arcrun 有一個 **MCP server**（`arcrun/mcp/`），讓 Claude Code 能直接呼叫 arcrun 的工作流/零件功能。
+跟 CLI 一樣是「薄殼」——連哪個帳號由同一份設定決定（env > 專案 `.arcrun.yaml` > 全域）。
+
+```bash
+acr mcp-setup     # 依你的設定，在當前資料夾寫 .mcp.json（Claude Code 會讀它）
+```
+
+- `acr init` 會自動順帶跑這步。
+- **接案切帳號**：在客戶資料夾設好 `.arcrun.yaml` 的 `mcp_url`（或 `ARCRUN_MCP_URL` env），重跑 `acr mcp-setup` → Claude Code 在該資料夾就連客戶那台 MCP。
+- 沒設 `mcp_url` → 連平台預設（`mcp.arcrun.dev`）。
+
 ---
 
 ## 裝好之後：開始用
@@ -278,6 +291,8 @@ acr auth-recipe list               列出支援的第三方服務認證
 acr auth-recipe scaffold <service> 取得 credentials.yaml 範本 + workflow 範例
 acr list                           列出已部署的 workflow
 acr logs <name>                    查看執行記錄
+acr mcp-setup                      在當前資料夾寫 .mcp.json，讓 Claude Code 連對的 arcrun MCP
+acr config --where                 顯示目前生效設定與來源層（避免在錯資料夾用錯帳號）
 acr update                         self-hosted：拉新版零件/引擎並重新部署到你的 CF
 ```
 
diff --git a/llms.txt b/llms.txt
index ed1e4a1..e74a4d0 100644
--- a/llms.txt
+++ b/llms.txt
@@ -34,10 +34,10 @@ npm i -g arcrun && acr install-harness
    用白話照抄式引導，**不要對使用者講 KV / Worker / R2 / zone 等術語**（他多半聽不懂，也不需要懂）：
    - 帳號代碼（Account ID）：登入 https://dash.cloudflare.com 右側欄複製。
    - 金鑰（API Token）：https://dash.cloudflare.com/profile/api-tokens → Create Custom Token →
-     照抄勾三組權限（Account/Workers Scripts/Edit、Account/Workers KV Storage/Edit、Account/Workers R2 Storage/Edit）
-     → 複製產生的 token。
+     照抄勾**兩組**權限（Account/Workers Scripts/Edit、Account/Workers KV Storage/Edit）
+     → 複製產生的 token。（不需要 R2、不需要綁信用卡——只用 Workers + KV 免費額度。）
    - 叫使用者把這兩串貼給你。
-4. `acr init --self-hosted`（你幫跑，貼使用者的兩串）—— 自動建資源、部署、seed。
+4. `acr init --self-hosted`（你幫跑，貼使用者的兩串）—— 自動建資源、部署、seed、寫 .mcp.json（MCP 連線）。
 5. 跑完照提示 `wrangler secret put ENCRYPTION_KEY`（CLI 會印確切指令）。
 6. 把使用者需求拆成 workflow → `acr push`。完成給客觀證據（HTTP 2xx / trace）。
 
diff --git a/mcp/GUIDE.md b/mcp/GUIDE.md
index 57355e9..4ad0d18 100644
--- a/mcp/GUIDE.md
+++ b/mcp/GUIDE.md
@@ -1,7 +1,10 @@
-# u6u 開發指南
+# Arcrun MCP 開發指南
 
-> u6u 是 **AI 優先（AI-First）** 的工作流自動化平台。
-> 跟 AI 描述你的意圖，u6u 幫你把它變成可重複執行、不需要 AI 的自動化工作流。
+> Arcrun 是 **AI 優先（AI-First）** 的工作流自動化平台。
+> 跟 AI 描述你的意圖，Arcrun 幫你把它變成可重複執行、不需要 AI 的自動化工作流。
+>
+> 註：本指南部分工具仍以舊 `u6u_` 前綴記載（registry/component 管理那組）；現役 workflow 工具是
+> `arcrun_*`（見 `mcp/src/tools/`）。連線設定見 `mcp/README.md`（用 `acr mcp-setup`）。
 
 ---
 
diff --git a/mcp/README.md b/mcp/README.md
index 00919d6..ac99203 100644
--- a/mcp/README.md
+++ b/mcp/README.md
@@ -5,51 +5,41 @@
 
 Arcrun 是反過來的 n8n。n8n 從手寫程式開始，Arcrun 從 AI 描述開始——你說「去抓銀行匯率，用 Telegram 通知我」，AI 把它拆成三元組，Arcrun 查零件庫、組裝、執行。第一次需要 AI，之後自動跑，不再花 Token。
 
-本 repo 是 Arcrun 的 **MCP Server**，讓 Claude Desktop、Cursor 等 AI client 能直接呼叫 Arcrun 的工作流與零件管理功能。
+本目錄是 Arcrun 的 **MCP Server**（已併入 arcrun 主庫 `arcrun/mcp/`），讓 Claude Code 等 AI client 直接呼叫 Arcrun 的工作流與零件功能。它是「薄殼」——連哪台 cypher / 哪個帳號由設定決定，與 CLI 共用同一份身份來源。
 
 ---
 
 ## 快速上手
 
-### 取得 API Key
+### 最簡單：用 CLI 產生連線設定（推薦）
 
-API Key 是由邀請者提供，格式為 `pk_live_...`。
+```bash
+acr mcp-setup
+```
 
-### 連線設定
+`acr mcp-setup` 依你的 arcrun 設定（env > 專案 `.arcrun.yaml` > 全域）在當前資料夾寫 `.mcp.json`，
+Claude Code 進此資料夾就連對的 MCP。`acr init` 也會自動順帶跑這步。
 
-#### Claude Desktop
+- 沒設 `mcp_url` → 連平台預設 `https://mcp.arcrun.dev`。
+- 自架 / 接案：在 `.arcrun.yaml` 設 `mcp_url`（或 `ARCRUN_MCP_URL` env）指向自己 / 客戶的 MCP，再 `acr mcp-setup`。
 
-編輯 `~/Library/Application Support/Claude/claude_desktop_config.json`（macOS）：
+### 手動設定（Claude Desktop / Cursor）
+
+`.mcp.json` / client MCP 設定內容（remote HTTP MCP）：
 
 ```json
 {
   "mcpServers": {
     "arcrun": {
       "type": "http",
-      "url": "https://mcp.finally.click/mcp",
-      "headers": {
-        "Authorization": "Bearer pk_live_YOUR_API_KEY"
-      }
+      "url": "https://mcp.arcrun.dev"
     }
   }
 }
 ```
 
-#### Cursor
-
-在 Cursor 的 MCP 設定中新增：
-
-```json
-{
-  "arcrun": {
-    "type": "http",
-    "url": "https://mcp.finally.click/mcp",
-    "headers": {
-      "Authorization": "Bearer pk_live_YOUR_API_KEY"
-    }
-  }
-}
-```
+> 平台託管的 MCP 需要 arcrun API Key 授權；自架的 MCP 綁你自己的 cypher。
+> 連線 URL 以 `acr mcp-setup` 產出的為準。
 
 > 使用 `type: http`（Streamable HTTP transport）。舊版 SSE 格式（`type: sse`）已不支援。
 
@@ -185,7 +175,7 @@ u6u_deploy_workflow(yaml_content="...")
 
 ## Inspector 測試界面
 
-開啟 [https://mcp.finally.click/inspector](https://mcp.finally.click/inspector) 即可在瀏覽器中互動式測試所有 MCP tools。
+開啟 `https://mcp.arcrun.dev/inspector`（或自架 MCP 的 `/inspector`）即可在瀏覽器中互動式測試所有 MCP tools。
 
 ---