From 23d36b311a95443d3832eb22e2a4261523f1f896 Mon Sep 17 00:00:00 2001
From: uncle6me-web <uncle6.me@gmail.com>
Date: Sun, 9 Aug 2026 14:23:56 +0800
Subject: [PATCH] =?UTF-8?q?portal=20=E8=A8=AD=E5=AE=9A=E9=A0=81=E8=A3=9C?=
 =?UTF-8?q?=E9=A1=AF=E7=A4=BA=20MCP=20=E9=80=A3=E6=8E=A5=E7=B6=B2=E5=9D=80?=
 =?UTF-8?q?=EF=BC=88arcrun-rag#7=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

封測者原話：「說明叫我把 MCP 加進 claude.ai connector，但我找不到網址」。文件一直寫
「登入 portal → 設定頁，那裡可以直接複製」，但畫面上從沒真的顯示過（grep 0 命中），
用戶照文件走一定撲空。

設定頁新增「接上你的 AI（MCP）」面板：純前端把 apiBase 的 worker 名字從
arcrun-cypher-executor 換成 arcrun-mcp（同一顆自架帳號 workers.dev 子網域，對齊
cli/src/lib/deploy.ts:386-392 部署時的組法），不符形狀就誠實顯示「尚未偵測到」，
不亂猜連不到的網址。複製按鈕從既有 copyOriginUrl 拆出共用 copyText(btn, url)。

端到端本機瀏覽器實測：真 wrangler dev（kbdb+cypher-executor local D1）+ 真登入流程
（console setup → bootstrap admin → portal login）走到設定頁，面板正確顯示/隱藏；
用貼近真實自架形狀的假網址驗算，結果與 deploy.ts 的組法逐字相同；複製鈕點擊行為與
既有、未改動的 st-copy-url 按鈕在同一自動化環境下一致（clipboard-write 是瀏覽器自動化
環境限制，非本次改動的迴歸）。詳細記錄見 system-dev/docs/3-specs/portal-auth/tasks.md t218。

未部署（紅線：只 commit+push，未動任何 Cloudflare 實例）。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
---
 console-ui/public/portal/index.html          | 49 ++++++++++++++++++--
 system-dev/docs/3-specs/portal-auth/tasks.md | 32 +++++++++++++
 2 files changed, 78 insertions(+), 3 deletions(-)

diff --git a/console-ui/public/portal/index.html b/console-ui/public/portal/index.html
index 70ddf20..348702a 100644
--- a/console-ui/public/portal/index.html
+++ b/console-ui/public/portal/index.html
@@ -401,6 +401,21 @@ if (!window.ARCRUN_API_BASE) {
           <div style="margin-top:8px;font-size:13px;line-height:1.7;color:rgba(var(--ink-rgb),.5)">封測版未簽章，第一次請右鍵→打開。裝好第一次開啟時，貼上這個網址＋你的帳號密碼就連上了。</div>
         </div>
       </div>
+      <!-- 08-09（arcrun-rag#7，封測者原話「說明叫我把 MCP 加進 claude.ai connector，但我找不到網址」）：
+           文件一直寫「登入 portal 設定頁直接複製」，但畫面上從沒真的顯示過這串網址——用戶照著文件的
+           指示走到這裡，只會撲空。這裡補上：MCP 網址跟知識庫網址（apiBase）是同一顆自架帳號的
+           workers.dev 子網域，只是 worker 名字從 arcrun-cypher-executor 換成 arcrun-mcp
+           （CLI 部署當時就是這樣組出這兩個網址的，見 cli/src/lib/deploy.ts:386-392）——
+           純前端字串轉換，不需要後端新端點、不需要安裝器多寫一份設定。 -->
+      <div class="panel">
+        <div style="display:flex;align-items:center;gap:8px;margin-bottom:14px;font-size:13.5px">
+          <span style="color:rgba(var(--ink-rgb),.6);white-space:nowrap">你的 MCP 網址（給你的 AI 連線用）</span>
+          <code id="st-mcp-url" style="flex:1;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;font-size:13px;color:var(--ink)">—</code>
+          <button class="btn3" id="st-copy-mcp-url" style="padding:5px 12px;font-size:13px;white-space:nowrap;flex:none">複製</button>
+        </div>
+        <div style="font-size:17px;font-weight:600">接上你的 AI（MCP）</div>
+        <div style="margin-top:4px;font-size:14px;line-height:1.65;color:rgba(var(--ink-rgb),.55)">把上面這串網址貼到 Claude、ChatGPT 等 AI 的「新增自訂連接器」欄位，就能讓你的 AI 直接查這個知識庫。</div>
+      </div>
       <!-- t176（leo 08-03）：AI 設定整塊移除。
            雲端聊天問答走 Workers AI（用戶自己 CF 帳號內建，**免金鑰、裝好就能用**）；
            地端萃取用哪把金鑰改由「同步小幫手」自己設定（托盤選單「AI 設定…」）。
@@ -977,9 +992,9 @@ function taipeiMonthDay(ms) { var d = new Date(ms + TAIPEI_OFFSET_MS); return {
   // 「版本與更新」頁本機端做。GET /portal/data/diagnostics 端點本身未刪（無害、
   // 已無任何 UI 呼叫），只是這裡不再掛按鈕去打它。
 
-  // t87 07-28 leo：知識庫網址 helper（只有 origin，不含 /portal/# 後綴），兩處 UI 共用
-  function copyOriginUrl(btn) {
-    var url = location.origin;
+  // t87 07-28 leo：複製任意網址到剪貼簿的共用 helper（08-09 從 copyOriginUrl 拆出
+  // copyText，讓 MCP 網址這種「不是 location.origin」的字串也能共用同一套按鈕行為）。
+  function copyText(btn, url) {
     var orig = btn.textContent;
     if (!navigator.clipboard || !navigator.clipboard.writeText) {
       alert('請手動選取並複製：' + url);
@@ -992,6 +1007,7 @@ function taipeiMonthDay(ms) { var d = new Date(ms + TAIPEI_OFFSET_MS); return {
       alert('請手動選取並複製：' + url);
     });
   }
+  function copyOriginUrl(btn) { copyText(btn, location.origin); }
   (function () {
     ['st-origin-url', 'ad-origin-url'].forEach(function (id) {
       var el = $(id); if (el) el.textContent = location.origin;
@@ -1001,6 +1017,33 @@ function taipeiMonthDay(ms) { var d = new Date(ms + TAIPEI_OFFSET_MS); return {
     });
   })();
 
+  // 08-09（arcrun-rag#7）：MCP 網址＝apiBase 換一個 worker 名字（arcrun-cypher-executor →
+  // arcrun-mcp），同一顆自架帳號的 workers.dev 子網域（deploy.ts:386-392 部署時就是這樣組的）。
+  // 不是這個形狀（例如官方多租戶自訂網域）就誠實留空，不亂猜一個貼上去會連錯的網址。
+  function mcpUrlFromApiBase() {
+    try {
+      var u = new URL(window.ARCRUN_API_BASE);
+      if (u.hostname.indexOf('arcrun-cypher-executor.') === 0) {
+        u.hostname = u.hostname.replace('arcrun-cypher-executor.', 'arcrun-mcp.');
+        return u.origin + '/mcp';
+      }
+    } catch (e) { /* apiBase 空值或格式不符時不猜 */ }
+    return '';
+  }
+  (function () {
+    var mcpUrl = mcpUrlFromApiBase();
+    var el = $('st-mcp-url');
+    var btn = $('st-copy-mcp-url');
+    if (el) el.textContent = mcpUrl || '（尚未偵測到，請確認安裝已完成）';
+    if (btn) {
+      if (mcpUrl) {
+        btn.addEventListener('click', function () { copyText(this, mcpUrl); });
+      } else {
+        btn.disabled = true;
+      }
+    }
+  })();
+
   // ── t53 完成安裝清單（進站必見，三件做完才消失）─────────────────────────────
   function setupSteps() {
     try { return JSON.parse(localStorage.getItem('arcrun_setup_steps') || '{}'); } catch (e) { return {}; }
diff --git a/system-dev/docs/3-specs/portal-auth/tasks.md b/system-dev/docs/3-specs/portal-auth/tasks.md
index 824e966..8c2898f 100644
--- a/system-dev/docs/3-specs/portal-auth/tasks.md
+++ b/system-dev/docs/3-specs/portal-auth/tasks.md
@@ -344,6 +344,38 @@
   一併修復：08-08 deploy-all 重部把 youlin 的 `[ai]` binding 洗掉（`/portal/daemon/extract` 501）
     ——本次以 `KEEP_AI=true` 重部復原（501→200 實測，模型仍 scout 未動）。
 
+- [x] **t218 設定頁補顯示 MCP 連接網址（2026-08-09，任務層小改，arcrun-rag#7）**：
+  來源＝封測者原話「說明叫我把 MCP 加進 claude.ai connector，但我找不到網址」。文件
+  （`docs-site/use/mcp.md`）一直寫「登入 portal → 設定頁，那裡可以直接複製」，但畫面上
+  從沒真的顯示過——用戶照著文件走一定撲空（總管實查：`console-ui/public/portal/index.html`
+  grep `mcp|MCP` 0 命中）。
+  修：`console-ui/public/portal/index.html` 設定頁新增一塊面板「接上你的 AI（MCP）」，
+  純前端字串轉換（不需後端新端點、不需安裝器多寫設定）：MCP 網址＝apiBase 把
+  worker 名字從 `arcrun-cypher-executor` 換成 `arcrun-mcp`，同一顆自架帳號的 workers.dev
+  子網域（與 `cli/src/lib/deploy.ts:386-392` 部署時組出這兩個網址的邏輯完全對齊，非另立
+  一套猜法）；不是這個網址形狀時誠實顯示「尚未偵測到」＋停用複製鈕，不亂猜一個連不到的網址。
+  複製按鈕沿用既有 `st-copy-url` 的 clipboard 邏輯，抽出共用 `copyText(btn, url)`（原
+  `copyOriginUrl` 只能複製 `location.origin`，MCP 網址不是 origin，需要能傳任意字串）。
+  文件（`products/arcrun-rag` docs-site `use/mcp.md`）核對過："不確定是哪一串？登入 portal
+  → 設定頁，那裡可以直接複製" 這句在本次修完後才是真的，故文件本身不必改字。
+  **端到端實測**（本機真瀏覽器，非 curl）：起 kbdb + cypher-executor 兩個真 `wrangler dev`
+  （local D1 套 migrations 0001-0006，兩邊 `KBDB_INTERNAL_TOKEN` 對齊解開 t115 fail-closed
+  閘）＋本機靜態伺服 portal（`UI_ORIGINS` 解 CORS）；真的走 `/console/setup`→`/console/login`
+  →`/portal/admin/bootstrap` 產生第一個 admin，瀏覽器真登入 `/portal/login`，導到設定頁——
+  面板正確顯示、apiBase 是 localhost（不符自架網址形狀）時誠實顯示「尚未偵測到」＋複製鈕
+  停用（沒有亂猜一個假網址）。再用瀏覽器 console 把 `window.ARCRUN_API_BASE` 換成貼近真實
+  自架形狀的字串（`https://arcrun-cypher-executor.fake9xyz.workers.dev`，故意用假 subdomain，
+  不使用任何真實租戶字串以免誤觸真實實例），對照組獨立驗算與 index.html 內同一份公式，
+  結果與 `deploy.ts:391` 的組法逐字相同（`https://arcrun-mcp.<sub>.workers.dev/mcp`）；
+  真的把這個值餵回頁面 DOM（`#st-mcp-url`），畫面正確顯示、複製鈕從停用變可按。
+  複製鈕點擊後 clipboard 沒有變化——經比對**既有、本次未改動**的 `st-copy-url`（知識庫網址
+  複製鈕）在同一自動化瀏覽器環境下點擊也是同樣結果，確認是這套瀏覽器自動化工具本身的
+  clipboard-write 權限限制（非真人操作，`navigator.clipboard.writeText` 需要真使用者手勢），
+  不是本次新增程式碼的迴歸——兩顆鈕行為一致。
+  **未測**：真實自架 workers.dev 網址（未取得任何測試帳密，且紅線禁碰 youlin/uncle6）；
+  真人用滑鼠點擊複製鈕（受限於自動化環境，上述已用既有鈕做過同構對照）。
+  執行範圍：`console-ui/public/portal/index.html`（新增面板 + JS）。未動後端、未部署。
+
 ## 第二波（不在本 SDD 動工範圍，掛號）
 
 - MCP token 綁庫集合（design §9；PR#15 擴充，只動 `mcp/`）