透過 MCP 分享即時 TUI

本頁譯自英文文件。指令、識別名稱與範例保持原樣。執行環境 7.24.4 · SDK 2.6.7。英文原文

狀態：實驗性範圍：公開、目前狀態上次審閱：2026-10-04 負責人：AX Code 維護者

TUIMCP 是 macOS 與 Linux 上 AX Code TUI 的實驗性、選擇加入 MCP 介接器。它讓外部 agent 讀取有界限的介面狀態，並在你正在使用的同一個 TUI 中導覽。此版本不支援 Windows。

以明確分享啟動 TUI：

ax-code --tui-mcp
# Or attach to an existing local backend:
ax-code attach http://localhost:4096 --tui-mcp

TUIMCP 列會顯示私有 endpoint.json 的絕對路徑。請把 MCP 用戶端設定為啟動：

{
  "mcpServers": {
    "ax-code-tui": {
      "command": "ax-code",
      "args": ["mcp", "tui", "--endpoint", "/absolute/path/from/the/TUI/endpoint.json"]
    }
  }
}

請使用正在執行的 TUI 所顯示的路徑。每個 TUI 有自己的端點；沒有自動探索或目標選擇。用戶端必須以同一個作業系統使用者執行。請把端點檔案視為一種能力憑證：它含有祕密權杖。不要提交、複製進提示，或分享其內容。後端憑證絕不會傳給介接器。

工具

get_view_context：回傳執行個體／世代、修訂、路由、選用的工作階段 ID、就緒狀態，以及導覽是否被阻擋。它不回傳逐字稿、草稿、工作階段標題、工作區路徑或憑證。
select_session：需要來自新脈絡的身分與修訂、專案工作階段 ID，以及唯一的 UUID requestId。它透過 TUI 既有的已驗證後端連線來驗證工作階段。成功的回應只確認已套用路由狀態；繪製與工作階段載入仍可能進行中。工作階段 ID 可另外透過一般的 AX Code 工作階段介面取得。

有草稿或附件、有待處理的模態或核准、工作階段忙碌、後端中斷連線、啟動／結束覆蓋層作用中，或使用者在過去 1.5 秒內有互動時，導覽會被拒絕。介面或工作區狀態改變會使舊修訂失效。這些工具不能送出提示、執行 shell 指令、核准權限或開始 agent 工作。

重複且相同的 requestId 會回傳原始回執，包括其原始脈絡。以不同引數重用它是錯誤。經過 128 次導覽請求後，該 TUI 行程會拒絕新請求；讀取存取與既有回執仍然可用。以明確分享重新啟動可重設此上限。回執不會被清出而變成不安全的重放。

deadline_exceeded 表示驗證在導覽前被取消。 timeout_unknown 或 outcome_unknown 表示呼叫端沒有收到確定結果；操作可能已經套用。請讀取目前脈絡來對帳。介接器絕不會自動重試。連線或傳輸本身成功並不表示導覽成功；請檢查 isError 與結構化結果。

撤銷與生命週期

在 TUIMCP 列按一下 [Revoke]，或執行 /tui-mcp-revoke。撤銷會立即圍住待處理的導覽並關閉通訊端。結束也會關閉端點；重新啟動會建立新的身分與權杖。崩潰的行程可能留下惰性的私有暫存目錄；舊用戶端無法藉此連上新的 TUI。

分享預設關閉，也不會持久保存。本機擁有者／模式檢查可防止其他作業系統使用者；TUIMCP 並不是針對已以你的使用者身分執行之程式碼的沙盒。若啟動時回報通訊端路徑過長，請透過 TMPDIR 使用較短的私有暫存根目錄，並啟動新的 TUI。