@agent-native/core 0.79.11 → 0.79.15

package/corpus/core/docs/content/locales/zh-TW/mcp-apps.md

@@ -1,38 +1,38 @@
 ---
 title: "MCP 應用程式"
-description: "使用真實應用路由、嵌入橋和主機橋 API，在 Claude、ChatGPT 和其他兼容主機中編寫和嵌入互動式 MCP 應用 UI。"
+description: "使用真實應用路由、嵌入橋和主機橋 API，在 Claude、ChatGPT 和其他相容主機中編寫和嵌入互動式 MCP 應用 UI。"
 ---
 
 # MCP 應用程式
 
-**此頁面：Claude/ChatGPT 中的內聯 UI。** 創作 MCP 應用程式資源以及在兼容主機的聊天中呈現真實應用程式路由的嵌入橋。此頁面也是**客戶支持矩陣** ([below](#client-support)) 的單一主頁面。
+**此頁面：Claude/ChatGPT 中的行內 UI。** 創作 MCP 應用程式資源以及在相容主機的聊天中呈現真實應用程式路由的嵌入橋。此頁面也是**用戶端支援矩陣** ([below](#client-support)) 的單一主頁面。
 
 | 如果你想……                                        | 閱讀                                     |
 | ------------------------------------------------- | ---------------------------------------- |
 | 將外部代理/主機連線到您的應用                     | [External Agents](/docs/external-agents) |
 | 為您的代理提供更多工具（使用其他 MCP 伺服器）     | [MCP Clients](/docs/mcp-clients)         |
-| 建置在 Claude/ChatGPT 中渲染的內聯 UI             | **此頁面** — MCP 應用                    |
-| 較低級別的 MCP 伺服器參考（驗證、工具、自訂掛載） | [MCP Protocol](/docs/mcp-protocol)       |
+| 建置在 Claude/ChatGPT 中渲染的行內 UI             | **此頁面** — MCP 應用                    |
+| 較低階別的 MCP 伺服器參考（驗證、工具、自訂掛載） | [MCP Protocol](/docs/mcp-protocol)       |
 
-MCP 應用程式是官方的 `io.modelcontextprotocol/ui` 擴充功能，可讓兼容主機（Claude、Claude Desktop、ChatGPT、VS Code GitHub Copilot、Goose、Postman、MCPJam 和 Cursor）在聊天中渲染互動式 UI。在代理原生應用程式中，每個 MCP 應用程式都是**真正的 React 路由**，而不是單獨的普通 HTML 小部件。
+MCP 應用程式是官方的 `io.modelcontextprotocol/ui` 擴充功能，可讓相容主機（Claude、Claude Desktop、ChatGPT、VS Code GitHub Copilot、Goose、Postman、MCPJam 和 Cursor）在聊天中渲染互動式 UI。在 Agent-Native 應用程式中，每個 MCP 應用程式都是**真正的 React 路由**，而不是單獨的普通 HTML 小工具。
 
-在 Agent-Native 應用自己的聊天中，首選 [native chat renderers](/docs/native-chat-ui) 作為第一方小部件，例如表格、圖表、鍵入的結果和批準功能可供性。在 Claude、ChatGPT、Copilot、Cursor 和其他兼容主機中使用 MCP 應用程式進行外部/跨主機內聯 UI，並使用操作 `link` 作為通用深層連結回退。
+在 Agent-Native 應用自己的聊天中，首選 [native chat renderers](/docs/native-chat-ui) 作為第一方小工具，例如表格、圖表、鍵入的結果和核准功能可用性。在 Claude、ChatGPT、Copilot、Cursor 和其他相容主機中使用 MCP 應用程式進行外部/跨主機行內 UI，並使用操作 `link` 作為通用深層連結回退。
 
 ## 創作：可選的 MCP 應用 UI {#mcp-apps}
 
-對於支持 MCP 應用擴充功能的主機，操作還可以使用 `mcpApp` 通告內聯 UI 資源。這是對流程的漸進增強，外部代理應向使用者提供互動式介面而不僅僅是文本，例如檢視電子郵件草稿、編輯行事曆邀請或在生成的儀表板變體之間進行選取。
+對於支援 MCP 應用擴充功能的主機，操作還可以使用 `mcpApp` 通告行內 UI 資源。這是對流程的漸進增強，外部代理應向使用者提供互動式介面而不僅僅是文字，例如檢視電子郵件草稿、編輯行事曆邀請或在產生的儀表板變體之間進行選取。
 
-每當使用者需要 UI 時，將真正的 React 應用程式與 `embedRoute()` 或 `embedApp()` 一起使用。思維模型很簡單：操作的 `link` 目標也是 MCP 應用程式嵌入目標。將操作公開為正常操作/工具，返回與 `link` 相關的深層連結，並新增 `mcpApp.resource = embedApp(...)`，以便有能力的主機內聯載入相同的路由，而不是開啟新分頁。當兩者都應該從同一路由建置時，更喜歡 `embedRoute({ title, openLabel, path })`：它是一種方便的包裝器，可以從一次調用中返回匹配的 `link` 和 `mcpApp` 欄位，而 `embedApp(...)` 是您直接分配給 `mcpApp.resource` 的較低級別資源。
+每當使用者需要 UI 時，將真正的 React 應用程式與 `embedRoute()` 或 `embedApp()` 一起使用。思維模型很簡單：操作的 `link` 目標也是 MCP 應用程式嵌入目標。將操作公開為正常操作/工具，返回與 `link` 相關的深層連結，並新增 `mcpApp.resource = embedApp(...)`，以便有能力的主機行內載入相同的路由，而不是開啟新分頁。當兩者都應該從同一路由建置時，更喜歡 `embedRoute({ title, openLabel, path })`：它是一種方便的包裝器，可以從一次呼叫中返回匹配的 `link` 和 `mcpApp` 欄位，而 `embedApp(...)` 是您直接分配給 `mcpApp.resource` 的較低階別資源。
 
 這意味著完整的應用程式嵌入可以執行路由開啟後可以執行的任何操作：檢視或編輯電子郵件草稿、顯示過濾的收件箱/搜尋、開啟行事曆事件或事件草稿、載入擴充功能頁面、檢查完整的分析儀表板或儲存的分析、在幻燈片編輯器中繼續幻燈片或開啟設計專案/編輯器。優先選取 URL/深層連結參數和現有的 `/_agent-native/open` 導覽/應用程式狀態橋，而不是為 MCP 應用程式發明第二個狀態協議。
 
-在極少數情況下，正確的目標是渲染一個共用 React 元件而不是整個應用程式 shell 的集中應用程式路徑。 Analytics 的 `/chart` 路線就是模型：它在 URL 中采用緊湊的 `SqlPanel` 有效負載，並呈現儀表板使用的相同圖表元件。這仍然是一個應用程式嵌入，而不是一個普通的 HTML MCP 應用程式。通過正常操作 / `open_app({ path, embed: true })` 公開或調用它，保持 URL 的確定性，並讓 `embedApp()` 內聯渲染該路由。
+在極少數情況下，正確的目標是渲染一個共用 React 元件而不是整個應用程式 shell 的集中應用程式路徑。 Analytics 的 `/chart` 路由就是模型：它在 URL 中采用緊湊的 `SqlPanel` 有效負載，並呈現儀表板使用的相同圖表元件。這仍然是一個應用程式嵌入，而不是一個普通的 HTML MCP 應用程式。透過正常操作 / `open_app({ path, embed: true })` 公開或呼叫它，保持 URL 的確定性，並讓 `embedApp()` 行內渲染該路由。
 
 請勿為產品 UI 手寫一次性普通 HTML MCP 應用程式；如果操作需要自訂介面，請首先新增或重用真實的應用程式路由/元件並嵌入該路由。
 
-```an-diagram title="MCP 應用程式嵌入往返" summary="該操作的連結目標也是嵌入目標。有能力的主機內聯載入相同的簽名應用程式路由；其他人都回到深層連結。"
+```an-diagram title="MCP 應用程式嵌入往返" summary="該操作的連結目標也是嵌入目標。有能力的主機行內載入相同的簽名應用程式路由；其他人都回到深層連結。"
 {
-  "html": "<div class=\"diagram-embed\"><div class=\"diagram-card\" data-rough><strong>Action</strong><small class=\"diagram-muted\">`link` target = MCP App embed target</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\" data-rough><strong>embedApp()</strong><span class=\"diagram-pill accent\">create_embed_session</span><small class=\"diagram-muted\">mints short-lived embed session</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\" data-rough><strong>/_agent-native/embed/start</strong><small class=\"diagram-muted\">交換一次性 SQL ticket</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\" data-rough><strong>Signed app route</strong><span class=\"diagram-pill ok\">真實 React 路由</span><small class=\"diagram-muted\">short-lived browser session</small></div><div class=\"diagram-fallback\"><span class=\"diagram-pill warn\">不支持 MCP Apps</span><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box\" data-rough>&quot;Open in … &rarr;&quot; deep link</div></div></div>",
+  "html": "<div class=\"diagram-embed\"><div class=\"diagram-card\" data-rough><strong>Action</strong><small class=\"diagram-muted\">`link` target = MCP App embed target</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\" data-rough><strong>embedApp()</strong><span class=\"diagram-pill accent\">create_embed_session</span><small class=\"diagram-muted\">mints short-lived embed session</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\" data-rough><strong>/_agent-native/embed/start</strong><small class=\"diagram-muted\">交換一次性 SQL ticket</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\" data-rough><strong>Signed app route</strong><span class=\"diagram-pill ok\">真實 React 路由</span><small class=\"diagram-muted\">short-lived browser session</small></div><div class=\"diagram-fallback\"><span class=\"diagram-pill warn\">不支援 MCP Apps</span><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box\" data-rough>&quot;Open in … &rarr;&quot; deep link</div></div></div>",
 "css": ".diagram-embed{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-embed .diagram-card{display:flex;flex-direction:column;gap:6px;padding:14px 16px;min-width:140px}.diagram-embed .diagram-arrow{font-size:22px;line-height:1}.diagram-embed .diagram-fallback{display:flex;flex-direction:column;align-items:center;gap:6px;margin-inline-start:8px}"
 }
 
@@ -60,85 +60,85 @@ export default defineAction({
   "language": "ts",
   "code": "import { embedApp } from \"@agent-native/core\";\n\nexport default defineAction({\n  // ...description, schema, run, link...\n  mcpApp: {\n    resource: embedApp({\n      title: \"Review draft\",\n      description: \"Open the generated draft in the real Mail compose UI.\",\n      iframeTitle: \"Agent-Native Mail\",\n      openLabel: \"Open in Mail\",\n    }),\n  },\n});",
   "annotations": [
-    { "lines": "6", "label": "漸進增強", "note": "`mcpApp.resource` 為支持 MCP 應用擴充功能的主機宣傳內聯 UI。也保留操作的 `link` 建置器 - 僅 CLI 和較舊的主機會忽略 UI 元資料，但仍然需要深層連結。" },
+    { "lines": "6", "label": "漸進增強", "note": "`mcpApp.resource` 為支援 MCP 應用擴充功能的主機宣傳行內 UI。也保留操作的 `link` 建置器 - 僅 CLI 和較舊的主機會忽略 UI 中繼資料，但仍然需要深層連結。" },
     { "lines": "7", "label": "Embed = the link target", "note": "`embedApp()` uses the action's `link` as its launch target: it calls `create_embed_session`, exchanges a one-time SQL ticket at `/_agent-native/embed/start`, and navigates the MCP App frame to the same signed app route." },
     { "lines": "11", "label": "通用後備標籤", "note": "`openLabel` is the visible `\"Open in … →\"` text used as the deep-link escape hatch when a host does not render the inline iframe." }
   ]
 }
 ```
 
-MCP 伺服器通告擴充功能 `io.modelcontextprotocol/ui`，將 `_meta.ui.resourceUri` 和 `_meta["ui/resourceUri"]` 新增到 `tools/list`，並且還發出 ChatGPT 應用 SDK 兼容性元資料（`openai/outputTemplate`、小部件 CSP/描述/可存取性）。它通過 `resources/list`、`resources/templates/list` 和 `resources/read` 使用 MIME `text/html;profile=mcp-app` 公開 HTML。 stdio 代理從實時應用程式轉發這些資源處理程序，因此桌面和 CLI 用戶端可以看到與 HTTP 用戶端相同的資源。
+MCP 伺服器通告擴充功能 `io.modelcontextprotocol/ui`，將 `_meta.ui.resourceUri` 和 `_meta["ui/resourceUri"]` 新增到 `tools/list`，並且還發出 ChatGPT 應用 SDK 相容性中繼資料（`openai/outputTemplate`、小工具 CSP/描述/可存取性）。它透過 `resources/list`、`resources/templates/list` 和 `resources/read` 使用 MIME `text/html;profile=mcp-app` 公開 HTML。 stdio 代理從即時應用程式轉發這些資源處理常式，因此桌面和 CLI 用戶端可以看到與 HTTP 用戶端相同的資源。
 
-即使新增 `mcpApp` 也保留現有的 `link` 建置器。僅 CLI 的用戶端、較舊的主機以及任何不呈現 MCP 應用程式的主機將忽略 UI 元資料，並且仍然需要 `"Open in … →"` 連結。 `embedApp()` 使用該連結作為其啟動目標，調用僅應用程式的 `create_embed_session` 幫助程序，在 `/_agent-native/embed/start` 交換一次性 SQL 票證，並通過短暫的瀏覽器工作階段以及同來源提取的承載回退將 MCP 應用程式框架導覽到目標路由。 `open_app({ app, path, embed: true })` 是用於完整儀表板、過濾收件箱、行事曆草稿視圖、分析和擴充功能頁面等路線的通用逃生口，當完整應用程式是最清晰的審查/編輯介面時，應廣泛使用。
+即使新增 `mcpApp` 也保留現有的 `link` 建置器。僅 CLI 的用戶端、較舊的主機以及任何不呈現 MCP 應用程式的主機將忽略 UI 中繼資料，並且仍然需要 `"Open in … →"` 連結。 `embedApp()` 使用該連結作為其啟動目標，呼叫僅應用程式的 `create_embed_session` 幫助程式，在 `/_agent-native/embed/start` 交換一次性 SQL 票證，並透過短暫的瀏覽器工作階段以及同來源擷取的承載回退將 MCP 應用程式框架導覽到目標路由。 `open_app({ app, path, embed: true })` 是用於完整儀表板、過濾收件箱、行事曆草稿檢視、分析和擴充功能頁面等路由的通用逃生口，當完整應用程式是最清晰的審查/編輯介面時，應廣泛使用。
 
-`embedApp()` 在資源 CSP 中包含 MCP 請求來源，以便啟動器可以獲取並在明確請求時建置已簽名的第一方應用程式路由。 Dispatch 將授予的應用程式的確切來源新增到其 `open_app` 資源中，以便單個 Dispatch 連線器可以內聯郵件、行事曆、幻燈片和其他內容，而無需允許每個 HTTPS 來源。僅為真正嵌入第三方播放器或載入第三方資源的自訂 MCP 應用傳遞額外的框架或資源域。
+`embedApp()` 在資源 CSP 中包含 MCP 請求來源，以便啟動程式可以取得並在明確請求時建置已簽名的第一方應用程式路由。 Dispatch 將授予的應用程式的確切來源新增到其 `open_app` 資源中，以便單一 Dispatch 連線器可以行內郵件、行事曆、幻燈片和其他內容，而無需允許每個 HTTPS 來源。僅為真正嵌入第三方播放器或載入第三方資源的自訂 MCP 應用傳遞額外的框架或資源域。
 
-在這些 `embedApp()` 路由中，`sendToAgentChat()` 是嵌入感知的。自動提交的提示會以 `ui/update-model-context` 加 `ui/message` 的形式中繼到 MCP 主機，因此嵌入式應用程式中的按鈕可以有意從所選應用程式狀態繼續 Claude/ChatGPT 對話。隱藏上下文作為模型上下文發送；可見的使用者轉向僅保留應用程式的提示，這避免了圍繞內部應用程式狀態檔案路徑的可怕的主機同意。 `submit: false` 保留本機預填充/審核行為。
+在這些 `embedApp()` 路由中，`sendToAgentChat()` 是嵌入感知的。自動提交的提示會以 `ui/update-model-context` 加 `ui/message` 的形式中繼到 MCP 主機，因此嵌入式應用程式中的按鈕可以有意從所選應用程式狀態繼續 Claude/ChatGPT 對話。隱藏脈絡作為模型脈絡傳送；可見的使用者轉向僅保留應用程式的提示，這避免了圍繞內部應用程式狀態檔案路徑的可怕的主機同意。 `submit: false` 保留本機預填充/審核行為。
 
-## 一流的MCP應用橋 {#mcp-app-bridge}
+## 一流的 MCP 應用橋 {#mcp-app-bridge}
 
-MCP 應用嵌入是路線嵌入，而不是單獨的迷你產品。 `embedApp()` 從操作的 `link` 目標開始，建立一個短暫的嵌入工作階段，並啟動該簽名的應用程式路由。當主機可以直接水合路線時，標準 MCP 應用程式主機可以自行導覽 MCP 應用程式框架。
+MCP 應用嵌入是路由嵌入，而不是單獨的迷你產品。 `embedApp()` 從操作的 `link` 目標開始，建立一個短暫的嵌入工作階段，並啟動該簽名的應用程式路由。當主機可以直接水合路由時，標準 MCP 應用程式主機可以自行導覽 MCP 應用程式框架。
 
-```an-diagram title="兩條主橋路徑，一條簽名路由" summary="克勞德移植了水合路線，使用直接ui/_bridge； ChatGPT 通過 window.openai 獲取受控 iframe，並通過 postMessage 中繼主機操作。兩者都指向同一個簽名的應用程式路由。"
+```an-diagram title="兩條主橋路徑，一條簽名路由" summary="Claude 移植了水合路由，使用直接ui/_bridge； ChatGPT 透過 window.openai 取得受控 iframe，並透過 postMessage 中繼主機操作。兩者都指向同一個簽名的應用程式路由。"
 {
-  "html": "<div class=\"diagram-bridge\"><div class=\"diagram-col\"><div class=\"diagram-card\" data-rough><strong>Claude web</strong><span class=\"diagram-pill accent\">single-frame transplant</span><small class=\"diagram-muted\">在 Claude iframe 中激活已簽名的應用 HTML，然後使用直接 `ui/_` 主機橋</small></div><div class=\"diagram-card\" data-rough><strong>ChatGPT web</strong><span class=\"diagram-pill accent\">controlled route iframe</span><small class=\"diagram-muted\">`window.openai`host APIs ·`agentNative.mcpHost.*` postMessage relay</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Same signed app route<br><small class=\"diagram-muted\">普通路由 + React 元件</small></div></div>",
+  "html": "<div class=\"diagram-bridge\"><div class=\"diagram-col\"><div class=\"diagram-card\" data-rough><strong>Claude web</strong><span class=\"diagram-pill accent\">single-frame transplant</span><small class=\"diagram-muted\">在 Claude iframe 中啟用已簽名的應用 HTML，然後使用直接 `ui/_` 主機橋</small></div><div class=\"diagram-card\" data-rough><strong>ChatGPT web</strong><span class=\"diagram-pill accent\">controlled route iframe</span><small class=\"diagram-muted\">`window.openai`host APIs ·`agentNative.mcpHost.*` postMessage relay</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Same signed app route<br><small class=\"diagram-muted\">普通路由 + React 元件</small></div></div>",
 "css": ".diagram-bridge{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-bridge .diagram-col{display:flex;flex-direction:column;gap:12px}.diagram-bridge .diagram-card{display:flex;flex-direction:column;gap:6px;padding:14px 16px;max-width:300px}.diagram-bridge .diagram-arrow{font-size:22px;line-height:1}.diagram-bridge .diagram-box{padding:16px 18px;text-align:center}"
 }
 
 ```
 
-Claude Web 使用單框架移植路徑：資源檔案獲取已簽名的應用程式 HTML 並將其水合到 Claude 的 MCP 應用程式 iframe 中，因為 Claude 無法可靠地允許應用程式擁有的子 iframe 或外部框架導覽。 ChatGPT Web 獲得受控路由 iframe，因為它的 Apps 橋為我們提供了穩定的 `window.openai` 主機 API 和有界高度控制。所有路徑都指向相同的簽名應用程式路由並渲染正常路由和 React 元件。設計嵌入式路由，以便使用相同簽名的 URL 重新載入可以重建相同的視圖。
+Claude Web 使用單框架移植路徑：資源檔案取得已簽名的應用程式 HTML 並將其水合到 Claude 的 MCP 應用程式 iframe 中，因為 Claude 無法可靠地允許應用程式擁有的子 iframe 或外部框架導覽。 ChatGPT Web 獲得受控路由 iframe，因為它的 Apps 橋為我們提供了穩定的 `window.openai` 主機 API 和有界高度控制。所有路徑都指向相同的簽名應用程式路由並渲染正常路由和 React 元件。設計嵌入式路由，以便使用相同簽名的 URL 重新載入可以重建相同的檢視。
 
-對於同一應用程式 `open_app({ embed: true })`，框架在原始工具調用期間建立嵌入啟動票證，並將簽名的啟動 URL 存儲在隱藏的工具元資料中。定制actions可以返回`embedStartUrl`相同的快速路徑； MCP 層將票證 URL 從模型可見的 `structuredContent` 和正常的開放連結元資料中剝離。當不存在嵌入啟動 URL 時，資源將回退到僅應用程式的 `create_embed_session` 幫助程序。這使得正式環境主機能夠在直接路由上限制 iframe 發起的工具調用，而不會將一次性應用程式工作階段 URL 泄漏到紀錄中。如果使用者在一次性啟動票過期後重新開啟舊聊天，啟動路由將返回一個小刷新頁面並將 `agentNative.embedSessionExpired` 發布到包裝器； `embedApp()` 清除陳舊的開始 URL，並在仍具有原始應用程式路由的情況下通過 `create_embed_session` 鑄造新票。
+對於同一應用程式 `open_app({ embed: true })`，框架在原始工具呼叫期間建立嵌入啟動票證，並將簽名的啟動 URL 儲存在隱藏的工具中繼資料中。定制actions可以返回`embedStartUrl`相同的快速路徑； MCP 層將票證 URL 從模型可見的 `structuredContent` 和正常的開放連結中繼資料中剝離。當不存在嵌入啟動 URL 時，資源將回退到僅應用程式的 `create_embed_session` 幫助程式。這使得正式環境主機能夠在直接路由上限制 iframe 發起的工具呼叫，而不會將一次性應用程式工作階段 URL 泄漏到紀錄中。如果使用者在一次性啟動票過期後重新開啟舊聊天，啟動路由將返回一個小重新整理頁面並將 `agentNative.embedSessionExpired` 發布到包裝器； `embedApp()` 清除陳舊的開始 URL，並在仍具有原始應用程式路由的情況下透過 `create_embed_session` 鑄造新票。
 
-ChatGPT通過`window.openai`獲得專用的兼容路徑：啟動檔案直接讀取`toolInput`、`toolOutput`和`toolResponseMetadata`，然後通過`window.openai.callTool(...)`調用`create_embed_session`。標準 MCP 應用程式主機使用 `ui/*` JSON-RPC 橋接器。直接水合路由可以通過主橋助手調用`ui/update-model-context`、`ui/message`、`ui/open-link`和`ui/request-display-mode`。 Claude的移植路線在水合後使用相同的直接`ui/*`主橋。當使用 ChatGPT 或顯式診斷 iframe 路徑時，包裝器通過 `agentNative.mcpHost.*` postMessage 請求中繼同一主機 actions。保持兩條路徑的結果形狀相同：返回集中的 `link` 和簡潔的結構化內容。
+ChatGPT 透過`window.openai`獲得專用的相容路徑：啟動檔案直接讀取`toolInput`、`toolOutput`和`toolResponseMetadata`，然後透過`window.openai.callTool(...)`呼叫`create_embed_session`。標準 MCP 應用程式主機使用 `ui/*` JSON-RPC 橋接器。直接水合路由可以透過主橋助手呼叫`ui/update-model-context`、`ui/message`、`ui/open-link`和`ui/request-display-mode`。 Claude 的移植路由在水合後使用相同的直接`ui/*`主橋。當使用 ChatGPT 或顯式診斷 iframe 路徑時，包裝器透過 `agentNative.mcpHost.*` postMessage 請求中繼同一主機 actions。保持兩條路徑的結果形狀相同：返回集中的 `link` 和簡潔的結構化內容。
 
-請勿將標準 `_meta.ui.domain` 設定為應用程式 URL。 MCP Apps 將該欄位視為特定於主機的欄位：Claude 驗證 `{hash}.claudemcpcontent.com` 樣式的沙箱域，而 ChatGPT 使用自己的 `openai/widgetDomain` 元資料。除非您故意發出特定於主機的值，否則請省略 `ui.domain`；主機將選取預設沙箱來源。
+請勿將標準 `_meta.ui.domain` 設定為應用程式 URL。 MCP Apps 將該欄位視為特定於主機的欄位：Claude 驗證 `{hash}.claudemcpcontent.com` 樣式的沙箱域，而 ChatGPT 使用自己的 `openai/widgetDomain` 中繼資料。除非您故意發出特定於主機的值，否則請省略 `ui.domain`；主機將選取預設沙箱來源。
 
 擴充功能頁面將其沙箱保留在 MCP 聊天嵌入中，而無需導覽第二個路由 iframe。正常應用程式使用會將 `/_agent-native/extensions/:id/render` 呈現為沙盒子 iframe。在 MCP 聊天橋模式下，框架在路由 iframe 內呈現與沙箱 `srcDoc` 相同的擴充功能檔案，避免主機 `frame-ancestors` / `X-Frame-Options` 故障，同時保留 `sandbox="allow-scripts allow-forms"`。
 
-資源 shell 擁有外部主機大小。 `embedApp({ height })`預設為`560px`，將外殼夾到`320-900px`，並為小工具列保留`44px`，因此路線視口為`height - 44px`。保持嵌入式應用程式路由內部可滾動，並讓啟動器報告有界的固有高度而不是完整的檔案高度；否則主機自動調整大小可以將一個普通的應用頁面變成一個很高的聊天神器。更改的 shell 僅影響新的 MCP App 資源和新的工具調用。舊的 ChatGPT/Claude 對話框架可以保留以前的資源行為，因此在判斷修複之前使用新的內聯渲染驗證大小。
+資源 shell 擁有外部主機大小。 `embedApp({ height })`預設為`560px`，將外殼夾到`320-900px`，並為小工具列保留`44px`，因此路由視口為`height - 44px`。保持嵌入式應用程式路由內部可滾動，並讓啟動程式報告有界的固有高度而不是完整的檔案高度；否則主機自動調整大小可以將一個普通的應用頁面變成一個很高的聊天產物。更改的 shell 僅影響新的 MCP App 資源和新的工具呼叫。舊的 ChatGPT/Claude 對話框架可以保留以前的資源行為，因此在判斷修復之前使用新的行內渲染驗證大小。
 
 ### 嵌入模式 {#embed-modes}
 
-Claude預設使用單幀移植路徑。在偵錯主機模塊載入行為時，您還可以在具有 `embedMode: "transplant"` 或 `frame: "transplant"` 的其他主機中強制使用它。您可以使用 `embedMode: "iframe"`、`renderMode: "iframe"`、`nested: true` 或 `frame: "iframe"` 強制嵌套診斷 iframe。如果 iframe 被阻止，`embedApp()` 會將其替換為開放應用後備：使用者可以重試內聯、通過主機開啟新建立的嵌入工作階段，或使用可見路由 URL。保持動作的 `link` 目標本身有用，因為它仍然是通用逃生艙口。
+Claude 預設使用單幀移植路徑。在偵錯主機模組載入行為時，您還可以在具有 `embedMode: "transplant"` 或 `frame: "transplant"` 的其他主機中強制使用它。您可以使用 `embedMode: "iframe"`、`renderMode: "iframe"`、`nested: true` 或 `frame: "iframe"` 強制嵌套診斷 iframe。如果 iframe 被阻止，`embedApp()` 會將其替換為開放應用後備：使用者可以重試行內、透過主機開啟新建立的嵌入工作階段，或使用可見路由 URL。保持動作的 `link` 目標本身有用，因為它仍然是通用逃生艙口。
 
-通過 ngrok 測試 Claude 時，請使用正式環境版本（`npx @agent-native/core@latest build` 然後 `npx @agent-native/core@latest start`）或已部署的預覽/正式環境 URL。 Claude的單幀移植路徑適用於正式環境資產塊；原始 Vite 開發模塊（例如 `/app/root.tsx`）可以受到應用程式驗證的保護，並且無法從 Claude 資源來源進行動態匯入。
+透過 ngrok 測試 Claude 時，請使用正式環境版本（`npx @agent-native/core@latest build` 然後 `npx @agent-native/core@latest start`）或已部署的預覽/正式環境 URL。 Claude 的單幀移植路徑適用於正式環境資產塊；原始 Vite 開發模組（例如 `/app/root.tsx`）可以受到應用程式驗證的保護，並且無法從 Claude 資源來源進行動態匯入。
 
-## 主橋API {#host-bridge}
+## 主橋 API {#host-bridge}
 
 主橋故意很小：
 
 | 模式                  | 訊息型別                              | 使用它                            |
 | --------------------- | ------------------------------------- | --------------------------------- |
-| 直接主機路由          | `ui/update-model-context`             | 宿主模型的隱藏上下文              |
+| 直接主機路由          | `ui/update-model-context`             | 主機模型的隱藏脈絡                |
 | 直接主機路由          | `ui/message`                          | 將可見使用者轉入主機              |
-| 直接主機路由          | `ui/open-link`                        | 通過主機開啟外部或應用程式URL     |
+| 直接主機路由          | `ui/open-link`                        | 透過主機開啟外部或應用程式 URL    |
 | 直接主機路由          | `ui/request-display-mode`             | 請求`inline`、`fullscreen`或`pip` |
-| Claude移植            | `ui/*`                                | 水合後相同的直接主橋              |
+| Claude 移植           | `ui/*`                                | 水合後相同的直接主橋              |
 | ChatGPT / iframe 路由 | `agentNative.mcpHostContext`          | 主題、區域設定、主機平台、維度    |
 | ChatGPT / iframe 路由 | `agentNative.embeddedAppReady`        | 確認路由iframe載入                |
 | ChatGPT / iframe 路由 | `agentNative.mcpHost.*` / `.response` | 主機請求的包裝中繼                |
 
 嵌入式路由可以使用 `@agent-native/core/client` 中的 `updateMcpAppModelContext()`、`openMcpAppHostLink()`、`requestMcpAppDisplayMode()`、`getMcpAppHostContext()` 和 `useMcpAppHostContext()`。 `sendToAgentChat()` 使用完整應用程式嵌入中的相同路徑來自動提交提示。
 
-顯示模式是盡力而為。應用內 `McpAppRenderer` 目前報告內聯 Web 主機上下文和僅內聯顯示模式；外部主機可能會接受較大的顯示請求、忽略它們或回複不支持模式的錯誤。始終保持內聯路由可用。
+顯示模式是盡力而為。應用內 `McpAppRenderer` 目前報告行內 Web 主機脈絡和僅行內顯示模式；外部主機可能會接受較大的顯示請求、忽略它們或回覆不支援模式的錯誤。始終保持行內路由可用。
 
-## 用戶端支持和快取 {#client-support}
+## 用戶端支援和快取 {#client-support}
 
-目前MCP Apps官方用戶端列表包括Claude、Claude Desktop、VS Code GitHub Copilot、Goose、Postman、MCPJam、ChatGPT、Cursor；主機支持仍然因計畫、發布渠道和用戶端版本而異，因此請檢查 [MCP extension support matrix](https://modelcontextprotocol.io/extensions/client-matrix)。 ChatGPT 自訂 MCP 應用程式可通過 ChatGPT Web 上的商業和企業/教育工作區的開發人員模式使用；請參閱 OpenAI 的 [developer mode and MCP apps](https://help.openai.com/en/articles/12584461-developer-mode-and-full-mcp-apps-in-chatgpt-beta) 注釋。
+目前 MCP Apps 官方用戶端清單包括 Claude、Claude Desktop、VS Code GitHub Copilot、Goose、Postman、MCPJam、ChatGPT、Cursor；主機支援仍然因計畫、發布管道和用戶端版本而異，因此請檢查 [MCP extension support matrix](https://modelcontextprotocol.io/extensions/client-matrix)。 ChatGPT 自訂 MCP 應用程式可透過 ChatGPT Web 上的商業和企業/教育工作區的開發人員模式使用；請參閱 OpenAI 的 [developer mode and MCP apps](https://help.openai.com/en/articles/12584461-developer-mode-and-full-mcp-apps-in-chatgpt-beta) 註解。
 
-Claude Code、Codex 和其他 CLI/程式碼編輯器用戶端在支持 MCP 應用程式時仍會收到相同的資源和元資料，但將它們視為連結輸出主機，除非您已在該確切表面中驗證了內聯 iframe 渲染。當主機選取不渲染 iframe 時，深層連結仍然是可靠的後備方案。實際上，每個代理本機應用程式都應使用以下兩種方式編寫：用於在有能力的主機中進行內聯審核/編輯的 MCP 應用程式，以及用於通用往返返回完整應用程式的 `link` 應用程式。
+Claude Code、Codex 和其他 CLI/程式碼編輯器用戶端在支援 MCP 應用程式時仍會收到相同的資源和中繼資料，但將它們視為連結輸出主機，除非您已在該確切表面中驗證了行內 iframe 渲染。當主機選取不渲染 iframe 時，深層連結仍然是可靠的後備方案。實際上，每個 Agent-Native 應用程式都應使用以下兩種方式編寫：用於在有能力的主機中進行行內審核/編輯的 MCP 應用程式，以及用於通用往返返回完整應用程式的 `link` 應用程式。
 
-Claude 和 ChatGPT 可以快取現有自訂連線器的工具和資源元資料。更改MCP App元資料後，使用新的工具調用進行驗證；如果主機仍使用舊描述符，請重新連線 Claude 連線器或重新掃描/檢查 ChatGPT 連線器，以便刷新目錄。如果部署後 Claude 在工具描述符上紀錄了有關 `_meta.ui.csp` 或 `_meta.ui.permissions` 的警告，則該連線器正在使用過時的元資料：刪除/重新連線 Claude 連線器並開始新的聊天。
+Claude 和 ChatGPT 可以快取現有自訂連線器的工具和資源中繼資料。更改 MCP App 中繼資料後，使用新的工具呼叫進行驗證；如果主機仍使用舊描述符，請重新連線 Claude 連線器或重新掃描/檢查 ChatGPT 連線器，以便重新整理目錄。如果部署後 Claude 在工具描述符上紀錄了有關 `_meta.ui.csp` 或 `_meta.ui.permissions` 的警告，則該連線器正在使用過時的中繼資料：刪除/重新連線 Claude 連線器並開始新的聊天。
 
 ## 測試 {#testing}
 
-使用`embedApp()`和`McpAppRenderer`週圍的輕量級夾具測試MCP應用程式；它們涵蓋 CSP、主機上下文、應用程式啟動和橋接訊息行為，而無需真正的外部主機。驗證 ChatGPT 或 Claude Web 時，在 shell 更改後觸發新的工具調用並測量可見的 iframe。同一對話中先前渲染的幀可能仍會顯示快取的高度或啟動行為。
+使用`embedApp()`和`McpAppRenderer`週圍的輕量級夾具測試 MCP 應用程式；它們涵蓋 CSP、主機脈絡、應用程式啟動和橋接訊息行為，而無需真正的外部主機。驗證 ChatGPT 或 Claude Web 時，在 shell 更改後觸發新的工具呼叫並測量可見的 iframe。同一對話中先前渲染的幀可能仍會顯示快取的高度或啟動行為。
 
 ## 相關 {#related}
 
-- [External Agents](/docs/external-agents) — 將 Claude、ChatGPT、Codex 和 Cursor 連線到託管應用程式； MCP 應用程式兼容性矩陣；目錄層；深層連結。
+- [External Agents](/docs/external-agents) — 將 Claude、ChatGPT、Codex 和 Cursor 連線到託管應用程式； MCP 應用程式相容性矩陣；目錄層；深層連結。
 - [MCP Protocol](/docs/mcp-protocol) — 自動安裝的 MCP 伺服器、驗證、工具和 `ask-agent`。
 - [Actions](/docs/actions) — `defineAction`，`link` 建置者，`publicAgent`。
 

package/corpus/core/docs/content/locales/zh-TW/mcp-clients.md

@@ -1,79 +1,79 @@
 ---
-title: "MCP用戶端"
-description: "將您的代理本機應用程式連線到本機 MCP 伺服器（claude-in-chrome、檔案系統、Playwright等），以便代理獲得其工具。"
+title: "MCP 用戶端"
+description: "將您的 Agent-Native 應用程式連線到本機 MCP 伺服器（claude-in-chrome、檔案系統、Playwright等），以便代理獲得其工具。"
 ---
 
-# MCP用戶端
+# MCP 用戶端
 
-**此頁面：為您的代理提供更多工具。** 將代理本機應用程式指向 MCP 伺服器（本機或遠端），以便他們的工具顯示在代理聊天中。這是 _client_ 方向，[MCP Protocol](/docs/mcp-protocol) 的鏡像（這使您的應用成為 MCP _server_）。
+**此頁面：為您的代理提供更多工具。** 將 Agent-Native 應用程式指向 MCP 伺服器（本機或遠端），以便他們的工具顯示在代理聊天中。這是 _client_ 方向，[MCP Protocol](/docs/mcp-protocol) 的鏡像（這使您的應用成為 MCP _server_）。
 
 | 如果你想……                                        | 閱讀                                     |
 | ------------------------------------------------- | ---------------------------------------- |
 | 將外部代理/主機連線到您的應用                     | [External Agents](/docs/external-agents) |
 | 為您的代理提供更多工具（使用其他 MCP 伺服器）     | **此頁面** — MCP 用戶端                  |
-| 建置在 Claude/ChatGPT 中渲染的內聯 UI             | [MCP Apps](/docs/mcp-apps)               |
-| 較低級別的 MCP 伺服器參考（驗證、工具、自訂掛載） | [MCP Protocol](/docs/mcp-protocol)       |
+| 建置在 Claude/ChatGPT 中渲染的行內 UI             | [MCP Apps](/docs/mcp-apps)               |
+| 較低階別的 MCP 伺服器參考（驗證、工具、自訂掛載） | [MCP Protocol](/docs/mcp-protocol)       |
 
-通過一個設定檔案，工作區中的每個代理本機應用都可以存取計算機上的 MCP 伺服器提供的工具：用於瀏覽器自動化的 `claude-in-chrome`、用於讀取檔案的 `@modelcontextprotocol/server-filesystem`、用於瀏覽器測試的 `@playwright/mcp` 以及任何使用 MCP 的其他工具。
+透過一個設定檔案，工作區中的每個 Agent-Native 應用都可以存取電腦上的 MCP 伺服器提供的工具：用於瀏覽器自動化的 `claude-in-chrome`、用於讀取檔案的 `@modelcontextprotocol/server-filesystem`、用於瀏覽器測試的 `@playwright/mcp` 以及任何使用 MCP 的其他工具。
 
 您還可以 [connect remote (HTTP) MCP servers at runtime](#remote-via-ui)（個人使用者或整個組織），而無需編輯設定檔案。
 
-每個來源都會解析為一個執行時 **MCP 管理器**，並且它學習的每個工具都會以防碰撞 `mcp__<server-id>__<tool>` 前綴登入到代理的工具註冊表中 - 可通過 `tool-search` 進行意圖搜尋。
+每個來源都會解析為一個執行時 **MCP 管理器**，並且它學習的每個工具都會以防碰撞 `mcp__<server-id>__<tool>` 前綴登入到代理的工具註冊表中 - 可透過 `tool-search` 進行意圖搜尋。
 
-```an-diagram title="用戶端方向：多種來源，一種工具註冊表" summary="設定檔案、環境和執行時 UI 全部合並到 MCP 管理器中；它的工具與您的應用程式的操作一起顯示為前綴並且可通過工具搜尋。這是伺服器方向的鏡像。"
+```an-diagram title="用戶端方向：多種來源，一種工具註冊表" summary="設定檔案、環境和執行時 UI 全部合併到 MCP 管理器中；它的工具與您的應用程式的操作一起顯示為前綴並且可透過工具搜尋。這是伺服器方向的鏡像。"
 {
-  "html": "<div class=\"mcp-merge\"><div class=\"diagram-col sources\"><div class=\"diagram-box\" data-rough>Workspace <code>mcp.config.json</code><br><small class=\"diagram-muted\">跨應用共用</small></div><div class=\"diagram-box\" data-rough>應用根 <code>mcp.config.json</code><br><small class=\"diagram-muted\">每個應用覆蓋</small></div><div class=\"diagram-box\" data-rough><code>MCP_SERVERS</code> env<br><small class=\"diagram-muted\">CI / 正式環境</small></div><div class=\"diagram-box\" data-rough>通過設定介面遠端設定<br><small class=\"diagram-muted\">personal &amp; org scope</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill accent\">MCP 管理器</span><small class=\"diagram-muted\">merge &middot; hot-reload</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col out\"><div class=\"diagram-node\">Agent 工具 registry<br><small class=\"diagram-muted\"><code>mcp__&lt;server-id&gt;__&lt;tool&gt;</code></small></div><div class=\"diagram-node\"><code>tool-search</code><br><small class=\"diagram-muted\">按意圖發現</small></div></div></div>",
+  "html": "<div class=\"mcp-merge\"><div class=\"diagram-col sources\"><div class=\"diagram-box\" data-rough>Workspace <code>mcp.config.json</code><br><small class=\"diagram-muted\">跨應用共用</small></div><div class=\"diagram-box\" data-rough>應用根 <code>mcp.config.json</code><br><small class=\"diagram-muted\">每個應用覆蓋</small></div><div class=\"diagram-box\" data-rough><code>MCP_SERVERS</code> env<br><small class=\"diagram-muted\">CI / 正式環境</small></div><div class=\"diagram-box\" data-rough>透過設定介面遠端設定<br><small class=\"diagram-muted\">personal &amp; org scope</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill accent\">MCP 管理器</span><small class=\"diagram-muted\">merge &middot; hot-reload</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col out\"><div class=\"diagram-node\">Agent 工具 registry<br><small class=\"diagram-muted\"><code>mcp__&lt;server-id&gt;__&lt;tool&gt;</code></small></div><div class=\"diagram-node\"><code>tool-search</code><br><small class=\"diagram-muted\">按意圖發現</small></div></div></div>",
   "css": ".mcp-merge{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.mcp-merge .diagram-col{display:flex;flex-direction:column;gap:8px}.mcp-merge .center{display:flex;flex-direction:column;align-items:center;gap:4px}.mcp-merge .diagram-arrow{font-size:22px;line-height:1}.mcp-merge code{font-size:.85em}"
 }
 ```
 
 > 相反的方向 - 使 _your_ 應用程式成為其他主機使用的 MCP 伺服器 - 位於 [MCP Protocol](/docs/mcp-protocol) 和 [External Agents](/docs/external-agents) 中。
 
-## 內置瀏覽器和計算機使用功能 {#built-in-capabilities}
+## 內建瀏覽器和電腦使用功能 {#built-in-capabilities}
 
-Agent-native 包括常見 stdio MCP 伺服器的本機開發切換。
+Agent-Native 包括常見 stdio MCP 伺服器的本機開發切換。
 預設情況下它們處於關閉狀態，並且只能針對每個使用者或每個組織啟用
 當應用程式在本機執行時。跳過正式環境和託管無伺服器執行時
-即使舊設定行存在，這些內置函數和工作區資源
+即使舊設定行存在，這些內建函式和工作區資源
 樹不會將它們顯示為預設的 `mcp-servers/*.json` 資源。
 
 | 能力             | 伺服器 ID         | 指令                                                                    |
 | ---------------- | ----------------- | ----------------------------------------------------------------------- |
 | Chrome 開發工具  | `chrome-devtools` | `npx -y chrome-devtools-mcp@latest --autoConnect --no-usage-statistics` |
 | Playwright瀏覽器 | `playwright`      | `npx -y @playwright/mcp@latest`                                         |
-| 計算機使用       | `computer-use`    | `npx -y computer-use-mcp@latest`                                        |
+| 電腦使用         | `computer-use`    | `npx -y computer-use-mcp@latest`                                        |
 
 一次只能在一個範圍內啟用一種瀏覽器功能。啟用 Chrome DevTools 會停用同一使用者或組織的 Playwright，啟用 Playwright 會停用 Chrome DevTools。
 
-計算機使用僅限 macOS。在其他平台上，它被列為不可用，並且即使舊設定行包含它也會被跳過。
+電腦使用僅限 macOS。在其他平台上，它被列為不可用，並且即使舊設定行包含它也會被跳過。
 
-Chrome DevTools 預設使用 `--autoConnect`。它附加到符合條件的正在執行的 Chrome 執行個體；它不會為您建立獨立的瀏覽器設定檔案或登入使用者的常規設定檔案。它需要啟用遠端偵錯的 Chrome 144+。當部署需要特定的偵錯端點時，可以稍後新增手動 `browser-url` 設定。
+Chrome DevTools 預設使用 `--autoConnect`。它附加到符合條件的正在執行的 Chrome 執行個體；它不會為您建立獨立的瀏覽器設定檔案或登入使用者的一般設定檔案。它需要啟用遠端偵錯的 Chrome 144+。當部署需要特定的偵錯端點時，可以稍後新增手動 `browser-url` 設定。
 
-內置程序保留在框架的 `settings` 表中，位於用於個人切換的 `u:<email>:mcp-builtin-capabilities` 和用於團隊切換的 `o:<orgId>:mcp-builtin-capabilities` 下。啟用後，它們會合並到執行時 MCP 管理器中，其範圍可見性格式與遠端伺服器相同，例如 `mcp__user_<emailhash>_playwright__*` 或 `mcp__org_<orgId>_chrome-devtools__*`。
+內建程式保留在框架的 `settings` 表中，位於用於個人切換的 `u:<email>:mcp-builtin-capabilities` 和用於團隊切換的 `o:<orgId>:mcp-builtin-capabilities` 下。啟用後，它們會合併到執行時 MCP 管理器中，其範圍可見性格式與遠端伺服器相同，例如 `mcp__user_<emailhash>_playwright__*` 或 `mcp__org_<orgId>_chrome-devtools__*`。
 
 ### 面向使用者的設定說明
 
-對敏感的內置程序使用簡潔、明確的設定副本：
+對敏感的內建程式使用簡潔、明確的設定副本：
 
 - **Chrome DevTools** 附加到正在執行的 Chrome 偵錯目標。告訴使用者
   它用於瀏覽器測試和登入驗證，並且它
   可能需要在工具出現之前啟用 Chrome 遠端偵錯。
 - **Playwright** 啟動一個獨立的瀏覽器。推薦它用於確定性
-  當不需要使用者的實時 Chrome 個人資料時進行品質檢查。
-- **計算機使用**可以操作本機應用程式。預設關閉，解釋一下
+  當不需要使用者的即時 Chrome 個人資料時進行品質檢查。
+- **電腦使用**可以操作本機應用程式。預設關閉，解釋一下
   macOS 螢幕錄製和輔助功能提示，並在拍攝前詢問
   敏感的 actions，例如購買、財務變化或帳戶更改。
 
-### 內置端點
+### 內建端點
 
-| 方法 | 路線                         | 目的                                                                  |
+| 方法 | 路由                         | 目的                                                                  |
 | ---- | ---------------------------- | --------------------------------------------------------------------- |
-| GET  | `/_agent-native/mcp/builtin` | 列出內置功能、啟用的範圍、合並的 ID 和實時狀態。                      |
+| GET  | `/_agent-native/mcp/builtin` | 列出內建功能、啟用的範圍、合併的 ID 和即時狀態。                      |
 | POST | `/_agent-native/mcp/builtin` | 更新範圍。主體：`{ scope, enabledIds }` 或 `{ scope, id, enabled }`。 |
 
-## 新增本機MCP伺服器 {#adding-a-server}
+## 新增本機 MCP 伺服器 {#adding-a-server}
 
-在您的工作區根目錄（或單個應用程式根目錄 - 當兩者都存在時，工作區根目錄獲勝）建立 `mcp.config.json`：
+在您的工作區根目錄（或單一應用程式根目錄 - 當兩者都存在時，工作區根目錄獲勝）建立 `mcp.config.json`：
 
 ```jsonc
 {
@@ -100,17 +100,17 @@ Chrome DevTools 預設使用 `--autoConnect`。它附加到符合條件的正在
 }
 ```
 
-形狀很小：由伺服器 ID 鍵入的 `servers` 對應，其中每個條目都是 stdio 啟動器（`command` + `args` + 可選的 `env`）或遠端 `{ "type": "http", "url", "headers" }` 條目。
+形狀很小：由伺服器 ID 鍵入的 `servers` 對應，其中每個條目都是 stdio 啟動程式（`command` + `args` + 可選的 `env`）或遠端 `{ "type": "http", "url", "headers" }` 條目。
 
-```an-annotated-code title="mcp.config.json，帶注釋"
+```an-annotated-code title="mcp.config.json，帶註解"
 {
   "filename": "mcp.config.json",
   "language": "jsonc",
   "code": "{\n  \"$schema\": \"https://agent-native.com/schema/mcp.config.json\",\n  \"servers\": {\n    \"claude-in-chrome\": {\n      \"command\": \"claude-in-chrome-mcp\",\n      \"args\": [],\n      \"env\": { \"LOG_LEVEL\": \"info\" }\n    },\n    \"filesystem\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@modelcontextprotocol/server-filesystem@latest\", \"/Users/me/projects\"]\n    }\n  }\n}",
   "annotations": [
     { "lines": "3", "label": "伺服器ID", "note": "鍵成為工具前綴：該伺服器的工具在代理的註冊表中顯示為 `mcp__claude-in-chrome__*`，因此它們不會與範本的操作發生衝突。" },
-    { "lines": "4-6", "label": "stdio launcher", "note": "`command` + `args` 生成本機二進制檔案。 Stdio 伺服器旨在用於**本機開發**- 它們在邊缘執行時中是無操作的。" },
-    { "lines": "6", "label": "進程環境", "note": "Optional `env` is passed to the spawned process. Keep secrets out of committed config; prefer `MCP_SERVERS` or the settings UI for tokens." }
+    { "lines": "4-6", "label": "stdio launcher", "note": "`command` + `args` 生成本機二進制檔案。 Stdio 伺服器旨在用於**本機開發**- 它們在邊緣執行時中是無操作的。" },
+    { "lines": "6", "label": "行程環境", "note": "Optional `env` is passed to the spawned process. Keep secrets out of committed config; prefer `MCP_SERVERS` or the settings UI for tokens." }
   ]
 }
 ```
@@ -124,13 +124,13 @@ Chrome DevTools 預設使用 `--autoConnect`。它附加到符合條件的正在
 [mcp-client] connected to filesystem: 4 tools
 ```
 
-這些工具在代理的工具註冊表中註冊，前綴為 `mcp__<server-id>__<tool-name>`，因此它們不會與範本的 actions 發生衝突。它們也包含在 `tool-search` 中，因此代理可以通過意圖發現新連線的 MCP 功能，而不需要預先提供確切的前綴名稱。
+這些工具在代理的工具註冊表中註冊，前綴為 `mcp__<server-id>__<tool-name>`，因此它們不會與範本的 actions 發生衝突。它們也包含在 `tool-search` 中，因此代理可以透過意圖發現新連線的 MCP 功能，而不需要預先提供確切的前綴名稱。
 
 ## 設定優先級 {#precedence}
 
 MCP 設定按此順序解析，第一個匹配獲勝：
 
-1. **工作空間根 `mcp.config.json`** — 通過 `package.json` 中的 `agent-native.workspaceCore` 檢測到。在工作區中的每個應用程式之間共用。
+1. **工作空間根 `mcp.config.json`** — 透過 `package.json` 中的 `agent-native.workspaceCore` 偵測到。在工作區中的每個應用程式之間共用。
 2. **應用程式根 `mcp.config.json`** — 如果您不希望每個應用程式中都提供 MCP 伺服器，則按應用程式覆蓋。
 3. **`MCP_SERVERS` env var** — 具有相同形狀的 JSON 字串，適用於檔案沒有意義的 CI/正式環境。
 
@@ -144,51 +144,51 @@ MCP_SERVERS='{"servers":{"zapier":{"type":"http","url":"https://mcp.example.com/
 ```
 
 `MCP_SERVERS` 被解析為 JSON，因此 `${...}` 預留位置不會擴充功能
-在字串內。如果您將權杖存儲在另一個秘密中，請先將其展開
+在字串內。如果您將權杖儲存在另一個秘密中，請先將其展開
 寫入最終的 JSON 值。
 
 Stdio MCP 伺服器生成本機二進制檔案，用於本機開發。
-MCP 工具僅在 Node 執行時激活 - Cloudflare Workers 和其他邊缘
+MCP 工具僅在 Node 執行時啟用 - Cloudflare Workers 和其他邊緣
 目標默默地跳過 MCP 並繼續應用程式的其餘部分工作
 通常。
 
-## 自動檢測：`claude-in-chrome` {#autodetect}
+## 自動偵測：`claude-in-chrome` {#autodetect}
 
 如果您**沒有** `mcp.config.json` 並且 `claude-in-chrome-mcp` 二進制檔案位於 `PATH`（或眾所週知的安裝位置 `~/.claude-in-chrome/bin/claude-in-chrome-mcp`）上，則本機代理會將其自動註冊為預設 MCP 伺服器。將 `AGENT_NATIVE_DISABLE_MCP_AUTODETECT=1` 設定為選取退出。
 
-這意味著安裝了 claude-in-chrome 擴充功能的使用者無需更改設定即可獲得對他們開啟的每個代理本機應用程式的瀏覽器控制。
+這意味著安裝了 claude-in-chrome 擴充功能的使用者無需更改設定即可獲得對他們開啟的每個 Agent-Native 應用程式的瀏覽器控制。
 
-## 通過設定 UI 遠端 MCP 伺服器 {#remote-via-ui}
+## 透過設定 UI 遠端 MCP 伺服器 {#remote-via-ui}
 
-MCP（模型上下文協議）伺服器為您的代理提供新的能力 - 例如連線到 Zapier、Cloudflare、Composio 或您公司的內部工具。連線後，代理可以像使用內置工具一樣使用這些工具。
+MCP（模型脈絡協議）伺服器為您的代理提供新的能力 - 例如連線到 Zapier、Cloudflare、Composio 或您公司的內部工具。連線後，代理可以像使用內建工具一樣使用這些工具。
 
-### 如何連線遠端MCP伺服器
+### 如何連線遠端 MCP 伺服器
 
 1. **伺服器名稱** - 供您自己參考的簡短標籤（例如“zapier”、“slack-tools”）。
 2. **URL** — MCP 伺服器提供者為您提供的 HTTPS 端點（例如 `https://mcp.zapier.com/s/abc123/mcp`）。這通常可以在提供者的儀表板或整合檔案中找到。
-3. **描述**（可選）- 關於此伺服器功能的注釋。
-4. **標頭** — 伺服器所需的驗證憑證，每行一個。大多數伺服器需要 `Authorization` 標頭。範例：`Authorization: Bearer sk-your-key-here`。提供者的檔案會告訴您在此處放置什么內容。
+3. **描述**（可選）- 關於此伺服器功能的註解。
+4. **標頭** — 伺服器所需的驗證憑證，每行一個。大多數伺服器需要 `Authorization` 標頭。範例：`Authorization: Bearer sk-your-key-here`。提供者的檔案會告訴您在此處放置什麼內容。
 
 點選“**測試**”以在儲存之前驗證連線。如果成功，您將看到可用工具的數量。點選“**連線**”進行新增。
 
 ### 個人與組織範圍
 
-支持兩個範圍：
+支援兩個範圍：
 
-- **個人** — 只有登入使用者才能獲得工具。存儲為使用者範圍設定。
-- **團隊** — 活躍組織中的每個人都可以獲得工具。所有者和管理員可以新增；成員只能看到該列表。存儲為組織範圍設定。
+- **個人** — 只有登入使用者才能獲得工具。儲存為使用者範圍設定。
+- **團隊** — 活躍組織中的每個人都可以獲得工具。所有者和管理員可以新增；成員只能看到該清單。儲存為組織範圍設定。
 
-在正在執行的 MCP 管理器中新增和刪除熱重載 — 無需重新啟動進程，也無需重新啟動伺服器。新的 `mcp__<scope>-<name>__*` 工具將在下一條訊息中向客服人員顯示，並且可通過 `tool-search` 進行搜尋。
+在正在執行的 MCP 管理器中新增和刪除熱重載 — 無需重新啟動行程，也無需重新啟動伺服器。新的 `mcp__<scope>-<name>__*` 工具將在下一條訊息中向代理顯示，並且可透過 `tool-search` 進行搜尋。
 
-HTTPS URL 在任何地方都被接受； plain `http://` 在開發過程中僅允許用於 `localhost`。可選的驗證作為不記名權杖在每個請求上通過 `Authorization: Bearer …` 發送。
+HTTPS URL 在任何地方都被接受； plain `http://` 在開發過程中僅允許用於 `localhost`。可選的驗證作為不記名權杖在每個請求上透過 `Authorization: Bearer …` 傳送。
 
-在底層，這些伺服器以 `u:<email>:mcp-servers-remote`（個人）或 `o:<orgId>:mcp-servers-remote`（團隊）鍵儲存在框架的 `settings` 表中，並在啟動時與 `mcp.config.json` 合並。
+在底層，這些伺服器以 `u:<email>:mcp-servers-remote`（個人）或 `o:<orgId>:mcp-servers-remote`（團隊）鍵儲存在框架的 `settings` 表中，並在啟動時與 `mcp.config.json` 合併。
 
-### HTTP端點
+### HTTP 端點
 
-| 方法   | 路線                                                  | 目的                                                               |
+| 方法   | 路由                                                  | 目的                                                               |
 | ------ | ----------------------------------------------------- | ------------------------------------------------------------------ |
-| GET    | `/_agent-native/mcp/servers`                          | 列出目前使用者的個人+組織伺服器的實時狀態。                        |
+| GET    | `/_agent-native/mcp/servers`                          | 列出目前使用者的個人+組織伺服器的即時狀態。                        |
 | POST   | `/_agent-native/mcp/servers`                          | 新增伺服器。身體：`{ scope, name, url, headers?, description? }`。 |
 | DELETE | `/_agent-native/mcp/servers/:id?scope=user\|org`      | Remove a server and reconfigure the manager.                       |
 | POST   | `/_agent-native/mcp/servers/:id/test?scope=user\|org` | Dry-run the existing server's connect + list-tools.                |
@@ -196,13 +196,13 @@ HTTPS URL 在任何地方都被接受； plain `http://` 在開發過程中僅
 
 Stdio 伺服器在 Node 執行時之外仍然是無操作的，但遠端 HTTP MCP 伺服器可以在任何具有 `fetch` 的環境中工作 - 包括桌面正式環境版本。
 
-## 通過集線器共用 MCP 伺服器 {#hub}
+## 透過集線器共用 MCP 伺服器 {#hub}
 
-如果您的工作區執行多個代理本機應用程式（例如調度+郵件+剪輯），您可以將**一個**應用程式設定為中心，並讓其他應用程式自動拉取其組織範圍的MCP伺服器。沒有每個應用程式複製貼上 URL 和不記名權杖。請參閱 [Multi-App Workspace](/docs/multi-app-workspace) 了解使用 Dispatch 工作區 MCP 資源的規範方法。
+如果您的工作區執行多個 Agent-Native 應用程式（例如調度+郵件+剪輯），您可以將**一個**應用程式設定為中心，並讓其他應用程式自動拉取其組織範圍的 MCP 伺服器。沒有每個應用程式複製貼上 URL 和不記名權杖。請參閱 [Multi-App Workspace](/docs/multi-app-workspace) 了解使用 Dispatch 工作區 MCP 資源的規範方法。
 
 Dispatch 是傳統的中心 - 它已經跨應用進行協調。
 
-```an-diagram title="中心模型：一個應用程式為組織範圍的 MCP 伺服器提供服務" summary="Dispatch 擁有組織範圍 MCP 伺服器；消費者應用程式將它們拉取並合並為 mcp__hub_<orgId>_<name>__*。僅共用組織範圍的行 - 個人憑證保持不變。"
+```an-diagram title="中心模型：一個應用程式為組織範圍的 MCP 伺服器提供服務" summary="Dispatch 擁有組織範圍 MCP 伺服器；消費者應用程式將它們拉取並合併為 mcp__hub_<orgId>_<name>__*。僅共用組織範圍的行 - 個人憑證保持不變。"
 {
   "html": "<div class=\"mcp-hub\"><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill accent\">Dispatch hub</span><small class=\"diagram-muted\">組織範圍 MCP 伺服器</small><small class=\"diagram-muted\"><code>GET /mcp/hub/servers</code></small></div><div class=\"diagram-col arrows\"><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div></div><div class=\"diagram-col consumers\"><div class=\"diagram-box\" data-rough>Mail<br><small class=\"diagram-muted\"><code>mcp__hub_&lt;orgId&gt;_&lt;name&gt;__*</code></small></div><div class=\"diagram-box\" data-rough>Clips<br><small class=\"diagram-muted\">約每 60 秒 pull + merge</small></div></div></div><p class=\"diagram-muted note\">Bearer-gated by <code>AGENT_NATIVE_MCP_HUB_TOKEN</code>. Personal (user-scope) servers are never re-exposed.</p>",
   "css": ".mcp-hub{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.mcp-hub .center{display:flex;flex-direction:column;align-items:center;gap:4px}.mcp-hub .diagram-col{display:flex;flex-direction:column;gap:10px}.mcp-hub .arrows .diagram-arrow{font-size:22px;line-height:1}.mcp-hub .note{margin:8px 0 0;font-size:.85em}.mcp-hub code{font-size:.85em}"
@@ -227,12 +227,12 @@ Dispatch 是傳統的中心 - 它已經跨應用進行協調。
 將其儲存在 `mcp-servers/<name>.json` 下，型別為 `mcp-server`。所有應用
 資源由每個工作區應用程式載入；選定的資源僅載入
 具有有效調度授權的應用程式。從應用程式解析秘密預留位置
-秘密存儲，因此將原始不記名權杖放入 Dispatch Vault 並引用它們
-使用 `${keys.NAME}`，而不是將它們存儲在資源主體中。
+秘密儲存，因此將原始不記名權杖放入 Dispatch Vault 並引用它們
+使用 `${keys.NAME}`，而不是將它們儲存在資源主體中。
 
-應用程式大約每分鐘刷新一次合並的 MCP 設定，因此是中央資源
+應用程式大約每分鐘重新整理一次合併的 MCP 設定，因此是中央資源
 編輯、授予更改和刪除無需部署即可生效。設定
-`AGENT_NATIVE_MCP_CONFIG_REFRESH_MS=0` 停用後台刷新，或
+`AGENT_NATIVE_MCP_CONFIG_REFRESH_MS=0` 停用背景重新整理，或
 將其設定為至少 `5000` 毫秒的值以調整間隔。
 
 下面的舊集線器模式對於粗略的“共用每個組織範圍 MCP”仍然有用
@@ -247,7 +247,7 @@ Dispatch 是傳統的中心 - 它已經跨應用進行協調。
 AGENT_NATIVE_MCP_HUB_TOKEN=<a-long-random-secret>
 ```
 
-Dispatch 現在掛載 `GET /_agent-native/mcp/hub/servers`，它返回存儲在其 `settings` 表中的每個組織範圍 MCP 伺服器，以及完整的 URL + 標頭，並通過權杖進行驗證。
+Dispatch 現在掛載 `GET /_agent-native/mcp/hub/servers`，它返回儲存在其 `settings` 表中的每個組織範圍 MCP 伺服器，以及完整的 URL + 標頭，並透過權杖進行驗證。
 
 ### 2。將消費應用程式指向中心
 
@@ -258,9 +258,9 @@ AGENT_NATIVE_MCP_HUB_URL=https://dispatch.acme.com
 AGENT_NATIVE_MCP_HUB_TOKEN=<the-same-secret>
 ```
 
-啟動時，每個消費者都會拉取集線器的伺服器列表並將其合並到自己的 MCP 管理器中。這些工具對代理來說顯示為 `mcp__hub_<orgId>_<name>__*` — 與消費者自己的本機 `mcp__org_…` 不同，因此不會發生衝突。
+啟動時，每個消費者都會拉取集線器的伺服器清單並將其合併到自己的 MCP 管理器中。這些工具對代理來說顯示為 `mcp__hub_<orgId>_<name>__*` — 與消費者自己的本機 `mcp__org_…` 不同，因此不會發生衝突。
 
-### 3。分享什么內容
+### 3。分享什麼內容
 
 僅共用**組織範圍**伺服器。使用者範圍（個人）伺服器由新增它們的使用者保留 - 中心絕不會跨應用程式重新公開個人憑證。
 
@@ -268,16 +268,16 @@ AGENT_NATIVE_MCP_HUB_TOKEN=<the-same-secret>
 
 ### 4。熱重載與重啟
 
-本機 UI 通過 `McpClientManager.reconfigure()` 在每個應用程式中新增熱重載 - 無需重新啟動。集線器來源的伺服器由工作區資源路徑使用的相同定期後台刷新（大約 60 秒，可通過 `AGENT_NATIVE_MCP_CONFIG_REFRESH_MS` 調整或停用）來獲取，因此在 Dispatch 中所做的更改會在大約一分鐘內傳播到所有消費者應用程式，而無需重新啟動。此外，消費者應用程式中的任何本機突變都會立即觸發該應用程式的重新設定。
+本機 UI 透過 `McpClientManager.reconfigure()` 在每個應用程式中新增熱重載 - 無需重新啟動。集線器來源的伺服器由工作區資源路徑使用的相同定期背景重新整理（大約 60 秒，可透過 `AGENT_NATIVE_MCP_CONFIG_REFRESH_MS` 調整或停用）來取得，因此在 Dispatch 中所做的更改會在大約一分鐘內傳播到所有消費者應用程式，而無需重新啟動。此外，消費者應用程式中的任何本機突變都會立即觸發該應用程式的重新設定。
 
 ### 端點摘要
 
-| 方法 | 路線                             | 目的                                                                                               |
+| 方法 | 路由                             | 目的                                                                                               |
 | ---- | -------------------------------- | -------------------------------------------------------------------------------------------------- |
 | GET  | `/_agent-native/mcp/hub/servers` | 為所有組織範圍的伺服器提供完整的信用（不記名門控，僅在設定 `AGENT_NATIVE_MCP_HUB_TOKEN` 時安裝）。 |
-| GET  | `/_agent-native/mcp/hub/status`  | 返回設定UI卡的`{ serving, consuming, hubUrl }`。                                                   |
+| GET  | `/_agent-native/mcp/hub/status`  | 返回設定 UI 卡的`{ serving, consuming, hubUrl }`。                                                 |
 
-## 狀態路線 {#status-route}
+## 狀態路由 {#status-route}
 
 每個應用程式都公開 `GET /_agent-native/mcp/status` 用於工具和入門：
 
@@ -313,7 +313,7 @@ AGENT_NATIVE_MCP_HUB_TOKEN=<the-same-secret>
 }
 ```
 
-使用它來建置“檢測到 claude-in-chrome - 您的代理現在可以驅動 Chrome”入門提示，或偵錯 MCP 連線問題。
+使用它來建置“偵測到 claude-in-chrome - 您的代理現在可以驅動 Chrome”入門提示，或偵錯 MCP 連線問題。
 
 ## 故障模式 {#failures}
 
@@ -321,10 +321,10 @@ AGENT_NATIVE_MCP_HUB_TOKEN=<the-same-secret>
 
 - 設定錯誤的 `command` → 伺服器被跳過，其錯誤出現在 `errors.<server-id>` 下的 `/mcp/status` 中，而其他所有伺服器繼續工作。
 - `node_modules` 中缺少 MCP SDK → 所有 MCP 功能都會被跳過並出現警告；代理聊天可以使用零 MCP 工具繼續工作。
-- 在邊缘執行時中執行 → MCP 用戶端是無操作的。
+- 在邊緣執行時中執行 → MCP 用戶端是無操作的。
 
-代理本機將始終啟動；損壞的 MCP 設定僅意味著工具更少。
+Agent-Native 將始終啟動；損壞的 MCP 設定僅意味著工具更少。
 
 ## 安全 {#security}
 
-MCP 工具在您的計算機上執行，具有生成的進程具有的任何權限。像對待您願意讓代理驅動的任何其他可執行檔案列表一樣對待 `mcp.config.json`。來自 MCP 伺服器的工具出現在代理的工具使用循環中，就像您範本自己的 actions 一樣，因此請確保您信任您設定的每個伺服器。
+MCP 工具在您的電腦上執行，具有產生的行程具有的任何權限。像對待您願意讓代理驅動的任何其他可執行檔案清單一樣對待 `mcp.config.json`。來自 MCP 伺服器的工具出現在代理的工具使用迴圈中，就像您範本自己的 actions 一樣，因此請確保您信任您設定的每個伺服器。