Agent 流程
從 OpenSlideX 設定 Agent
從本機 Workspace 產生 MCP 設定，再讓 Agent 只處理你選定範圍內的簡報。
終端機
$ open-slidex mcp --workspace ~/Presentations --print-config codex六個 MCP 工具
MCP 是本機檔案與驗證邊界，而不是另一個雲端簡報服務。先讀取最新 revision；每一個會寫入的動作都必須帶著它。
| 工具 | 主要輸入 | 用途 |
|---|---|---|
open_slidex_workspace選擇 Workspace 簡報 | list / select + presentationId | 列出簡報，或在呼叫特定簡報工具前選取一份簡報。 |
open_slidex_read讀取來源與資源 | intent, sourceFormat, slideIndex, componentPath, resourcePath… | 讀取 canonical TSX、單一本機元件、MDX、HTML、skills 或 knowledge 資源。 |
open_slidex_source_import讀取 PPTX 來源 | action, filePath, expectedRevision | 檢查受限於專案根目錄的 PPTX；import-media 會寫入擷取出的 WebP 素材。 |
open_slidex_media匯入來源或媒體 | action, expectedRevision, filePath, query, providerAssetId | 接收暫存來源、搜尋／匯入可信媒體，或匯入本機圖片。 |
open_slidex_review唯讀品質檢查 | scope, slideIndex | 執行結構驗證與已 render 的視覺 QA，不會修改簡報。 |
open_slidex_edit安全編輯簡報 | expectedRevision, target, source, slideIndex… | 取代完整 TSX 簡報、單一 Slide 或受控 HTML，並執行 QA。 |
從 Workspace Settings 完成設定
OpenSlideX 的 Workspace Settings 能為 Codex、Claude Code 與 Claude Desktop 產生使用者層級 MCP 設定。選擇 client、加入產生的設定後，重新啟動該 client，它就能載入本機 OpenSlideX server。
Workspace scope 讓 Agent 在你開放的簡報中選擇；固定 project scope 則只限於一個專案。OpenSlideX 會產生設定，但不會偵測、啟動或控制 client。
小而可檢查的工具範圍
本機 MCP server 提供六個流程工具：選取 Workspace、漸進式讀取、匯入 PPTX 來源、處理媒體、唯讀審查，以及具 revision 保護的編輯。編輯前重新讀取並使用回傳的 revision，讓變更始終能對應回本機簡報。