Lantide Data

外部 AI Agent 與 MCP Server

13. 外部 AI Agent 與 MCP Server

Lantide Data 也可以作為本機 MCP Server,讓你慣用的外部 AI Agent(例如 Cursor、Codex、Claude 或其他支援 Streamable HTTP MCP 的客戶端)直接使用 Lantide 的資料環境與分析工作面。

外部 Agent 不是取代 Lantide 的 GUI:它在自己的對話中和你協作;Lantide 則保存可檢視的 Plan、Report、SQL / evidence、審批、Save History、audit,以及 Agent 實際呼叫 MCP 的活動紀錄。這能讓「Agent 說它做了什麼」與「Lantide 實際留下什麼」彼此對照。

不要和 §4.6 的 MCP Sources 混淆。 MCP Sources 是 Lantide 作為 MCP client 接入外部資料或 API;本節的 MCP Server 則是 Lantide 作為 MCP server 供外部 AI Agent 連入。

13.1 何時適合使用

選擇外部 Agent 整合,通常是因為你已在某個外部 Agent 中工作,但希望分析不只停留在聊天紀錄:

  • 想讓 Agent 對本機資料進行分析,同時把 Plan、Report 和正式證據留在 Lantide。
  • 想在 Claude / Codex 中維持原本的工作方式,但能在 Lantide 審閱執行、成果與活動軌跡。
  • 想讓高信任 Agent 協助整理工作區、專案、文件別名或知識,仍保留 GUI、audit 與可追溯 artifact。

若你只需要在 Lantide 內完成分析,直接使用內建 AI 助手即可;不必建立 MCP connection。

13.2 開啟 Agent Integration

  1. 在主畫面右上角點擊 Server Cog 圖示,開啟 Agent Integration。預設會開啟 Persistent connections 分頁。
  2. 開啟頂端的 Enable MCP server。這是全域開關,同時控制 Quick 與 Persistent connections。
  3. Persistent connections 建立常用連線,或切到 Quick connection 建立僅綁定目前工作區的一次性連線。

Codex 一鍵配對: 若你從支援的 Codex 本機流程開啟 Agent Integration,Lantide 可先帶入「配對 Codex」請求。請在 GUI 檢查 scope、access mode、expiry、exposure 與設定檔目的地後,按 Approve & Connect;只有核准後才建立 credential 並合併 Codex 的本機 MCP 設定。此流程不會把 bearer credential 顯示在聊天、deep link、命令列或剪貼簿。若設定寫入失敗,才改用一次性的 connection kit。

關閉全域開關會立刻停止所有可連入的 MCP endpoint,並 unexpose Quick 與 Persistent connections;已保存的 Persistent profile 設定不會被刪除。日後重新開啟全域開關時,仍有效且設定為 exposed 的 Persistent connections 會恢復可用。

安全提示: Lantide 的 MCP host 只綁定在本機 127.0.0.1。連線設定包含 bearer credential,請只貼到你信任的本機 MCP client 設定中;不要貼到公開聊天室、issue 或遠端主機。外部 Agent 不能自行向 Lantide 要求或重建你的 credential。

13.3 Quick connection:針對目前工作區的一次性連線

Quick connection 適合一次分析、臨時使用外部 Agent,或你只想將目前工作區交給它。

  1. 切換到要使用的工作區。
  2. Quick connection 分頁選擇 Access mode。
  3. 點擊 Expose host。Lantide 會在同一步建立新的 connection credential。
  4. 點擊連線設定旁的 Copy 圖示。複製內容是完整的 mcpServers["lantide-quick-<workspace>"] JSON entry;請將這個 named server 合併到外部 Agent 既有的 MCP 設定,不要用整份複製內容覆蓋原設定檔。
  5. 回到外部 Agent,重新載入 MCP 或開始新對話,讓它 initialize。

Quick connection 的 credential 只透過 Copy 內容交付;離開這個畫面後不會再次顯示。若遺失設定,請 Unexpose 後再 Expose,取得新的設定。同一 workspace 重新 Expose 時會沿用同一個 lantide-quick-<workspace> server key,並以新 credential 更新該 entry。Quick connection 是 workspace-scoped,切換工作區不會讓同一份 config 自動改指向新的工作區。

13.4 Persistent connection:可跨重啟使用的連線

Persistent connection 適合經常使用同一外部 Agent,或希望關閉 Lantide 視窗後仍能保留已授權的本機 host。

  1. 切到 Persistent connections,點擊 Create connection。目前建立畫面的預設值為 All workspaces + Admin;這是表單預設,不代表所有情境都應選 Admin。第一次評估或低信任的唯讀探索可先選 Observe;需要 Plan 審閱與正式證據、且一次只專注一個工作區的分析可選 Execute(All workspaces 或 Single workspace 皆可)。
  2. 輸入可辨識的 Alias,例如「我的 Codex 分析連線」。Lantide 會將 alias 正規化為 copied config 的 lantide-<alias> server key;正規化後的名稱不可與未封存的 Persistent connection 重複。若 alias 不含可用的英數字元,server key 會自動帶上 profile 短 id 以保持唯一。
  3. 選擇 Access mode 與 Connection scope:
  • Single workspace:選擇一個必填工作區;連上後自動綁定該工作區。Access mode 可選 Observe / Execute / Admin。
  • All workspaces:可搭配 Observe / Execute / Admin。每次連線從未綁定狀態開始,由 Agent 先探索再明確選擇要工作的工作區。Execute 為單線雙開(同一連線任何時刻只有一個 selected writer);若要多工作區同時寫入,請另開 Admin 單開(Single workspace)連線。
  1. 選擇 expiry(1 / 3 / 7 / 30 / 180 / 365 天或 Permanent),並決定是否立即 Expose。
  2. 建立後複製顯示一次的 JSON config。請將其中的 named server 合併到 MCP client 既有的 mcpServers,不要覆蓋整份設定檔。

Persistent config 使用安裝層級穩定的本機 URL;在正常重啟 Lantide 後,已 exposed 且未到期、未 revoked 的 profile 可用同一份 config 重新 initialize。token 只在建立或 Rotate 後顯示一次,profile 清單不會回顯 token。

操作 作用 對既有外部設定的影響
開關 Expose / Unexpose 暫停或恢復這個 profile 的 endpoint Unexpose 後舊設定無法連入;再次 Expose 可繼續使用同一 token
Rotate 產生新 token 你必須將新的 JSON config 更新到 MCP client;舊 token 立即失效
Revoke 永久撤銷 profile 無法再次開啟;請建立新的 connection
Remove / Archive(已 revoked) 從日常清單隱藏已撤銷項目 不影響既有 audit 或活動紀錄
Change local MCP port 遷移持久 endpoint 的本機 port token 不變,但所有已複製的 Persistent config 都必須更新 URL

如果 stable port 被其他程式佔用,Persistent connections 會顯示 warning,可能包含可辨識的 PID / process name。釋放 port 後可按 Retry,不必重啟 Lantide;Retry 不會改變 URL。只有你主動使用 Change local MCP port 才會變更 URL。

13.5 Access mode:這是 connection 的能力上限,不是分析階段

Access mode 在建立 connection 或 Quick connection 時由你選擇。它是外部 Agent 能做到什麼的能力上限,不會因 Plan 從 planning 變成 executing 而自動切換。

Mode 可以做什麼 適合情境
Observe 唯讀 workspace 脈絡與 artifacts,不進行寫入 先理解環境、陪同檢視、低風險探索
Execute 建立或修訂分析 artifacts,並以 Plan、review、formal evidence 與 Report 契約完成正式執行 需要清楚口徑、Plan review 與可追溯分析的工作
Admin Execute + 高信任的本機設定與組織操作,例如 workspace / project / knowledge / alias,以及已 stage 的結果交付 你已信任 Agent、希望它主動整理 Lantide 環境或完成授權的本機操作

新建 Quick / Persistent connection 只提供以上三種模式。Draft 已停用,不再提供為新連線選項,外部 Agent 也不應推薦 Draft。

Plan 的 Approve & Execute 只會核准該 Plan 的執行範圍與證據脈絡,不會把 connection 從 Observe / Execute / Admin 自動升降級。相反地,外部 Agent 也不能自行透過 MCP 提高 access mode 或開啟全域 MCP server。

13.6 三種推薦工作法:不是新的 mode

Access mode 是硬性能力邊界;以下是 Lantide 建議外部 Agent 依任務與你的偏好採用的工作法。外部 Agent 連上後會讀取 playbook,應向你說明目前連線的 scope、能力與推薦做法。

工作法 適用連線 你如何使用 Lantide 扮演的角色
Execute 雙開 Execute 同時開著外部 Agent 對話與 Lantide;在 GUI 審閱 Plan、點 Approve & Execute、查看 evidence / Report 嚴謹分析的審閱與可追溯工作面
Admin 雙開 Admin(預設推薦) 外部 Agent 主導高信任工作,你同步在 GUI 看 artifact、External MCP Activity、Save History 與 audit 高信任工作的預設共同觀察面
Admin 單開(進階) Admin;且你選擇之後回看,並清楚回看時要檢查 artifacts/Activity/audit 主要待在外部 Agent;當下需審閱的說明寫在外部對話;必要時關閉 Lantide 視窗,完成後再回來核對成果 背景沉澱面:產物品質應與雙開對等;不是省略流程

這三者不是設定頁中的第三個 mode,也不會限制你改變工作方式。Admin 連線時外部 Agent 通常先推薦雙開;若你只說「少打擾」或不確定,它應先問你要即時看 Lantide還是之後回看——僅低打擾偏好不足以改推單開。單開是進階工作法:不代表可以省略 Lantide 的分析記錄方式;當下審閱在外部對話,回看時在 Lantide 看到的產物與 Activity/audit 應與雙開同等完整。若你不確定,直接告訴外部 Agent 你的目標與偏好,或問:「這個連線現在能做什麼?我應該怎麼用 Lantide?」

13.6.1 Playbook 資源與 Plan/chat 面分工

外部 Agent initialize 後可讀取 MCP playbook 資源(例如 external_agent_playbookrecommended_next_steps),作為產品導覽與下一步建議的權威來源,而非僅依賴 client 內建提示。

概念 說明
Plan 面(Lantide GUI) Plan/Report/SQL tab/Approve & Execute/Activity 等正式 artifact 與審批以 Lantide 為準;外部 chat 中的 Plan 草稿不取代 GUI 上的 Plan 狀態
Chat 面(外部 client) 當下討論、口徑澄清、Admin 單開的當場確認可在外部對話完成;但正式 SQL evidence 仍須寫入 Lantide Steps
HTML 報告 外部 Agent 產 HTML 前應讀 shared_skills.html_report_design;契約失敗或內容偏薄時依 skill recovery 擴寫(見 §10.5.3

Copy onboarding prompt(Agent Integration 頂部)會引導外部 Agent:先 tools/list;首次列表是本次 session 的精簡固定工具目錄,核心能力可直接呼叫,長尾能力則用 search_capabilities 搜尋。若是 All workspaces,必要時先 select_workspace(或 Admin 的 create_workspace_and_select)→ 不需重新載入工具,直接呼叫 get_analysis_context,依回傳的 playbook version、required skills 與 next action 恢復工作。尚未選定工作區時,workspace-bound 工具會回 WORKSPACE_SELECTION_REQUIRED,這不是權限失敗。你無須手動維護 client 內的長篇 system prompt。

長尾能力的固定用法: Agent 先把使用者意圖改寫成簡潔英文的「動作 + 對象」,一次只搜尋一個動作,例如 edit CSS styles of an existing HTML report,不要只搜 testreportaddanalysis。搜尋本身永遠不執行能力;side_effect 篩選的是「目標能力」而非搜尋動作,因此一般探索維持 any,只有明確要排除某類能力時才縮小。domain 是 optional single enum filter,不是啟用工具組;確定分類時可填一個,不確定就省略,filtered search 無結果時移除 domain、改寫英文後重試一次。多步工作應拆成多次搜尋,不傳多個 domain。接著檢查回傳的 capability_iddescriptor_digestinput_schemaside_effectinvocationinvocation=direct 時直接呼叫核心工具;readinvoke_read_capabilitywriteinvoke_write_capability。後兩者必須原樣帶回 id/digest,並只把原工具參數放進 arguments。若收到 CAPABILITY_DESCRIPTOR_STALE,重新搜尋後再呼叫,不能猜 digest。read/write invoker 不會提高 Access mode,也不會跳過原工具的 confirmation、Activity、evidence 或 audit。

External MCP 不使用、也看不到內建 Agent 的 activate_analysisactivate_html_editing 或其他 activate_*。Execute/Admin 要做統計分析時,直接以 domain=statistics 搜尋 t-test、比例檢定、相關性、回歸、時間序列、預測、趨勢、分群、異常偵測或描述統計能力,再依 descriptor 走 write invoker;執行前仍須確認精確方法、欄位、filter 與方法參數。HTML 建立、CSS 與 custom JavaScript 也直接以 domain=html 分別搜尋,不需 activation。

13.6.2 外部 Agent 何時建立工作區、專案或切換 Focus

概念 用途 外部 Agent 應如何判斷
Workspace 資料、連線、權限與安全邊界 能安全完成工作就沿用;只有你明確要求、或資料/連線/安全邊界不同時才新建。
Project 可持續追蹤的一個分析議題 同一業務問題的追問應沿用;需要留下 Plan、Report 或持續迭代時才建立。一次性探索不必硬建。
Focus project GUI 與 Agent 目前的導覽上下文 要讀寫該專案的 artifacts、或你要在 GUI 看它時才切換;它不會改變 workspace、權限或外部 connection scope。
Plan 正式分析的執行契約 需要審閱範圍、formal evidence 或可追溯 Report 時建立;不是每次探索都必須建立。

外部 Agent 應先讀取既有 project、artifacts 和目前 focus,再向你說明組織決策。它不應因為新聊天、暫時沒有 activity,或只是偏好整齊就大量建立 workspace / project。

13.7 在 GUI 審閱外部 Agent 的工作

Header 顯示的是後端確認的 active session,不是「已 Expose」的設定狀態:

  • Observe session: 頂端顯示藍色 External session observing。Observe 是唯讀連線,不取得 writer ownership,內建 Lantide Agent 仍可使用。
  • Execute / Admin writer session: 頂端顯示綠色 External agent mode enabled。這表示目前工作區由外部 writer session 操作,內建 Lantide Agent 會暫停,避免兩個 Agent 同時修改同一分析脈絡。
  • Exposed waiting: endpoint/profile 已可接受連線,但尚無 active session;Header 不會把它顯示成 connected。請到 Agent Integration 查看 exposed、recovery 或 conflict 等設定狀態。

側邊欄工作區列只在該工作區有 active external session 時顯示 MCP 狀態圖示:Observe 使用藍點,Execute / Admin 使用綠點。它是目前工作的快速提示;完整連線設定、等待與錯誤處理仍以 Agent Integration 為準。

  • 點擊 Header 膠囊或 AI 面板中的 Manage 可開啟 Agent Integration。
  • 膠囊右側的 link-off 圖示是「中斷目前 session」。它會結束當前外部 MCP 對話並要求 client 重新 initialize,但不會 unexpose Quick connection、也不會 revoke Persistent profile 或 token。
  • 若要真正停止 Quick connection,請在 Quick 分頁按 End external agent mode / Unexpose;若要停止 Persistent connection,請關閉該 profile 的 Expose 開關。

右側面板的 External MCP Activity 是觀測與核對面板,讓你確認 Agent 實際呼叫了什麼、改了哪些內容,以及在安全條件成立時回退單筆內容變更:

  • 每個外部連線建立 logical session;標題顯示 profile alias(或 Quick connection)、工作區與 Active / Ended 狀態。Activity history 可保留已結束的工作,但不代表 session 仍 active
  • 卡片依時間由上往下新增,記錄 initialize、resource read、tool call、policy / review 結果與 connection end。點卡片可展開經過遮蔽的安全摘要。
  • 每個成功的 content mutation 各自形成一張 Activity 卡;系統不依時間猜測外部對話回合,也不把多個 tool call 冒充成一個 operation。卡片會標示事件當下的工作區名稱;下方常駐顯示受影響的 SQL、Plan、Report、Reference(含外部文件匯入建立/替換)或 HTML artifact,以及綠色 +N/紅色 -N 行數。點檔名可開啟 artifact;若它屬於另一個工作區,系統會先要求切換(適用 SQL/Markdown/HTML 等資源),而不會建立錯誤的空白分頁。
  • 支援安全回退的變更右側顯示 Undo 圖示。確認 Revert 後,系統只回退該筆 content mutation;回退前會驗證目前內容仍等於當時記錄的 after hash。若後續已有人工或其他 Agent 修改,會以 content conflict 阻擋,不提供 force revert。
  • 新建檔案的 Revert 會清空內容但保留檔案。Plan lifecycle、execution completion、lineage、export、workspace / connection mutation、knowledge governance 等具副作用的操作不支援由 Activity 回退。成功回退後,原 Activity 仍保留並顯示已 reverted,系統另追加回退活動與 audit;不會刪掉原歷史。
  • History(標題右側時鐘圖示)可切換過往 session;藍點只代表該 session 有你尚未看過的非 session-end活動(斷線/重啟結束本身不計),不代表連線仍 active。藍點緊貼 profile 名稱尾端。列表頂部可選 Mark all as read 一次清除所有藍點。Ended session 可 Archive(從列表隱藏,但保留紀錄直到保留期限到期)。
  • 右側圖示列的 External MCP activity icon 在面板收起時,若有尚未看過的 attention 活動會顯示紅點;打開 Activity 面板後紅點隱藏(未讀改由 History 藍點提示)。
  • 活動內容會遮蔽 bearer credential、token 與不應顯示在觀測面板的敏感內容。Activity 不是外部 Agent 的聊天紀錄,也不保存變更正文;Undo 所需的受限 before/after snapshot 另行保存在本機。
  • 標題列 History 左側的齒輪圖示開啟 Activity retention and privacy
    • 從下拉選單設定 Max events per sessionEnded session retention;儲存後立即清除過舊 session 並壓縮事件數量。
    • Clear archived history (N) 只刪除已 Archive 的歷史;Clear ended history (N) 刪除全部 ended history(含已 Archive 者)。括號顯示各自會刪除的 session 數量,兩者都會同步刪除相關 Undo snapshots,且不會清除 active session。
    • 上述清理不影響 business audit、artifacts 或 knowledge。設定變更與 Clear 會寫入本機 host-level admin audit,不會把敏感正文寫進 Activity 事件。

外部 Agent 可開啟、focus 或刷新相關 Plan / Report / SQL tab。你仍應以 Lantide 中實際出現的 artifact、Plan steps、Report、Save History、Activity 與 audit 作為成果依據,而不是只依賴 Agent 在外部聊天中的口述。

13.8 Plan、審批、證據與 Admin 操作

Execute connection 的分析流程通常是:Agent 建立或修訂 Plan → 請求 GUI review → 你在既有 Plan 工具列按 Approve & Execute → Agent 取得該 Plan 的執行範圍 → 在範圍內連續執行正式查詢與產出 Report。你不需要為 Plan 中每一筆正式 SQL 重複確認。

Admin 單開(進階)的 Plan 核准例外: 若你主要在外部 Agent 對話中審閱 Plan,且已明確表示同意執行,外部 Agent(僅 Admin connection)可呼叫 claim_plan_approved,將 Plan 推進為 Executing 並建立 scoped execution grant——效果等同 GUI Approve & Execute,但當下不必打開 Lantide Plan 工具列。此路徑須帶最新 Plan digest 與你的確認摘要;Execute connection 不可用。Claim 之後的正式 SQL 仍須帶 execution_plan_ref 才會寫入 Plan Steps;若你正在看 Lantide GUI,仍應優先使用 Approve & Execute

三層區分(避免混淆):

層次 意思
Admin mutation 直通 workspace/project 設定、knowledge patch、alias 等可在 Admin connection 直接執行(仍留 warning 與 audit)
Admin 單開 Plan lifecycle 當下審閱在外部對話時,可用 claim_plan_approved 推進 Plan → Executing(須你的明確確認)
Execute 雙開 正式分析仍須在 GUI 按 Approve & Execute 或經 review 流程;Execute connection 不能 claim

正式 evidence 會被留在 Plan 的 execution progress。未關聯 Plan 的探索查詢可以存在,但不應被當成 Report 的關鍵數字。若 Report 產出後需要補充資料,Agent 可以將 post-execution action 連到 Report,使 Lantide 顯示這是正式步驟之外的補充證據;修改 Report 時也能連回對應 evidence。

Admin 操作依 connection mode 具有不同確認方式:

  • Execute connection,Admin 級操作會出現在頂端的 Pending Admin approvals 通知(例如新增/重綁 Additional folder、Cloud folder,或建立/重綁 SQL Server 連線)。卡片由舊到新排列,逾時未處理會自清單移除(約 5 分鐘);已過期的請求無法再核准。
  • 你可逐筆 ApproveReject,或 Approve all。多數操作核准後後端才會套用變更;若該操作需要帳密等密文(例如新建 SQL Server/Cloud folder),Approve 會開啟 Connections 並預填非密文字段,你須在表單補齊憑證後才算完成——此期間操作仍屬未完成。Approve all 遇到第一筆需補憑證的請求時會暫停批次,其餘卡片維持 pending。
  • Admin connection,Lantide 不會為每筆 Admin 操作要求 GUI confirmation。外部 Agent 仍會收到安全 warning,並應先在自己的對話中取得你的同意;所有操作仍留下 audit 與 Activity。

對於 result export,Agent 會先 stage 完整結果並確認 staging 已完成,才送出 review 或 direct-save。Execute 通常由你在 GUI 核准或按 Save;Admin direct-save 會以已確認、不可被 Agent 任意換掉的 destination 寫入,並留下 warning / audit。你可在右側 Save History 查看 PreparingReady to saveSaved、失敗或過期等狀態;手動 Results 匯出仍是原本的本機檔案選擇流程。

13.9 All workspaces 的選擇與切換

All workspaces profile(Observe / Execute / Admin)在每次外部 Agent initialize 後都從 unbound 開始,不會暗中沿用上次的工作區。它可以先用安全的摘要讀取來比較所有工作區與專案;真正要讀深層資料或進行寫入前,必須明確選擇一個工作區。

建議順序(Agent 與你驗收時可對照):

  1. Initialize 後呼叫一次 tools/list → 這就是本次 session 的精簡固定工具目錄;完整 mode-allowed 能力仍可經 search_capabilities + read/write invoker 觸達,選擇或切換工作區後不會改變。
  2. 用 discovery 工具比較工作區後,呼叫 select_workspace(僅 Admin 亦可 create_workspace_and_select)綁定一個工作區。
  3. 尚未綁定時,其他 workspace-bound 工具會回 WORKSPACE_SELECTION_REQUIRED。綁定成功後不需再 call tools/list;直接呼叫 get_analysis_context,必要時再讀 playbook/current_staterecommended_next_steps,然後進行專案、Plan、Report 或查詢工作。

Observe(All workspaces)

  • 選擇工作區後可做唯讀探索;不會取得 writer ownership,也不會切換 Lantide GUI 的目前工作區。
  • 可與既有 Execute / Admin writer session 並存;不會因為目標工作區已被占用而要求 eviction。
  • 不可建立新工作區(create_workspace_and_select 僅 Admin 可用)。

Execute(All workspaces)— 單線雙開

  • 同一連線任何時刻只有一個 selected writer workspace;成功選擇後預設會切換 Lantide GUI 的目前工作區(activate_gui 預設為 true)。僅在你明確要求不要打斷畫面時,Agent 才應傳 activate_gui=false(仍會綁定 session/ownership;後續 tool 仍可能切換 process connector)。
  • 切換工作區會撤銷舊工作區的 execution grants,並使該 session 的 pending review 全部失效;Agent 必須重新建立 context。回到舊工作區後,需你在 GUI 按 Continue 或重新送審,不會自動恢復授權。
  • 不可建立新工作區;正式核准請用 GUI Approve/Continue(claim_plan_approved 僅 Admin)。
  • 若要多工作區同時寫入,請另開其他 Admin Single workspace 連線,不要把同一條 Execute All workspaces 連線當成並行多寫入。

Admin(All workspaces)

  • 成功選擇或建立工作區後,同一 MCP session 綁定該工作區;預設會同步切換目前 active workspace 並刷新側邊欄(activate_gui 預設 true)。僅在你明確要求不打斷畫面時才應傳 activate_gui=false
  • 同一 profile 同一時間只可持有一個 Admin writer workspace;切換同樣會清掉舊綁定的 grants/pending reviews。
  • 若目標工作區已被另一條 writer connection 使用,Agent 會看到佔用資訊。它必須先在外部對話取得你的同意,並以指定 session 重新送出切換;系統不會靜默搶占。被你同意 eviction 的 session 會結束,但該 profile 的 expose / token 設定仍保留。

若你目前使用的是 Single workspace 連線,卻需要改去另一個既有工作區,請到 Agent Integration 建立或改用 All workspaces profile,不要請 Agent 用建立新工作區來冒充切換。

13.10 關閉視窗、重新開啟與明確退出

如果存在已 exposed 的 Persistent connection,或已 exposed 的 Quick connection,關閉 Lantide 的視窗不一定等於停止 host:Lantide 可保留 backend 與 MCP listener 在背景,讓已授權的外部 Agent 不被意外中斷,同時銷毀 renderer 以減少前端資源使用。

  • macOS: 可從 Dock 重新開啟視窗。
  • Windows: 若有需要保留的 connection,視窗可收合至系統匣;首次在沒有保留條件時關閉,會詢問你要直接退出或保留在系統匣,並可記住選擇。
  • 若有未儲存內容,會先顯示確認:Close window and discard 或 Cancel。
  • Quit Lantide、app update、crash 或系統終止會停止 backend / listener;外部 client 的後續請求會 fail closed。下次啟動後,僅有效且設定為 exposed 的 Persistent profile 會恢復,client 必須重新 initialize。

13.11 常見問題與安全檢查

為什麼外部 Agent 連不上?

先確認全域 Enable MCP server 已開啟、對應 Quick / Persistent connection 是 exposed、token 未過期/未 revoked。Persistent listener 顯示 port collision 時,先釋放佔用程式後按 Retry;不要自行把 config 改成另一個 port。若你主動 Change local MCP port,必須更新外部 client 裡保存的 URL。

為什麼外部 Agent 需要重新 initialize?

這是預期的安全語意:app restart、Rotate、Revoke、Unexpose、global disable、明確 Disconnect session 或 workspace eviction 都會讓舊 session 失效。重新 initialize 會建立新的 MCP session;這不等於你需要重新建立 profile 或取得新 token(Rotate / Revoke 除外)。

為什麼內建 AI 面板不能輸入?

只有目前工作區存在 active Execute / Admin writer session 時,內建 Agent 才會暫停以避免互相衝突。Active Observe session 不會阻擋內建 Agent。若 Header 顯示綠色 external writer 狀態,請讓外部 Agent 完成、使用 link-off 中斷 session,或結束 / unexpose 外部 connection,再使用內建 Agent。

All-workspaces 連上後,Agent 說工具很少/做不了分析?

工具較少是精簡 catalog 的預期行為,不代表能力被刪除。若仍是 unbound,請先確認 Agent 已 select_workspace(或 Admin 建立並綁定),綁定後直接呼叫 get_analysis_context不需再 tools/list。要找未直接列出的能力時用 search_capabilities,再依回傳的 invocation 使用 read/write invoker。這不是 Observe/Admin 權限被降級。見 §13.9

我的舊 Activity 卡片還在,代表 Agent 還連著嗎?

不代表。Activity history 是可追溯紀錄;請看 session 的 Active / Ended 燈號。你可 archive 已結束 session,隱藏它的日常列表項目,不會刪除 underlying audit。

為什麼 connection 已 Expose,Header 卻沒有 external session?

Expose 只表示 endpoint/profile 已可接受外部 client,可能仍處於 exposed waiting。等 client 重新載入 MCP 並成功 initialize 後,Header 才會顯示 active Observe 或 writer session。若長時間沒有建立 session,請到 Agent Integration 檢查全域開關、profile expiry/revocation、port 狀態與 client config。

遇到 recovery 或 writer conflict 時該做什麼?

持續性問題會留在 Agent Integration、Header 或相關狀態面,不只靠短暫 Toast。依畫面提供的主要 action 使用 RetryDisconnect sessionUnexposeRotate credentialSelect workspaceResolve conflict。Workspace conflict 會先顯示阻擋的 writer session;只有你在外部對話明確同意後,Agent 才能指定該 session 重新嘗試,系統不會靜默驅逐或停用對方的 profile。診斷細節可保留 error code 供回報,但不需要手動修改 sidecar 或猜測 raw MCP 狀態。

可以把 Persistent config 給同事或遠端服務嗎?

不建議。它是本機 loopback endpoint 與本機 bearer credential;它的設計目標是你自己電腦上的可信 MCP client,而不是遠端共享 API。若要讓別人使用,請在對方的 Lantide 安裝上建立自己的 connection。

Beta 提示: MCP Server 功能目前仍處於產品 Beta 收束階段。若遇到連線、recovery 或 client compatibility 問題,請保留不含 credential 的錯誤碼、Activity 截圖與重現步驟,再依 §21 回報。