通过 MCP 共享实时 TUI

本页译自英文文档。命令、标识符和示例保持原样。运行时 7.24.4 · SDK 2.6.7。英文原文

状态：实验性范围：公开，当前状态最近审阅：2026-10-04 负责人：AX Code 维护者

TUIMCP 是 AX Code TUI 在 macOS 和 Linux 上的实验性、选择加入的 MCP 适配器。它让外部代理读取有界的界面状态，并导航你正在使用的同一个 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 命令、批准权限或开始代理工作。

重复且相同的 requestId 会返回其原始回执，包括其原始上下文。用不同参数复用它是错误。经过 128 次导航请求之后，该 TUI 进程会拒绝新请求；读取访问和现有回执仍然可用。用显式共享重新启动即可重置此限制。回执不会被逐出到不安全的重放中。

deadline_exceeded 表示验证在导航之前被取消。 timeout_unknown 或 outcome_unknown 表示调用方没有收到确定的结果；该操作可能已经应用。读取当前上下文来核对。适配器从不自动重试。仅有连接或传输成功并不表示导航成功；请检查 isError 和结构化结果。

撤销与生命周期

点击 TUIMCP 条中的 [撤销]，或运行 /tui-mcp-revoke。撤销会立即围住待处理的导航并关闭套接字。退出也会关闭端点；重新启动会创建新的身份和令牌。崩溃的进程可能留下一个惰性的私有临时目录；旧客户端不能通过它挂接到新的 TUI。

共享默认关闭，并且不会持久化。本地所有者/模式检查防止其他操作系统用户；TUIMCP 并不是针对已经以你的用户身份运行的代码的沙盒。如果启动报告套接字路径太长，请通过 TMPDIR 使用更短的私有临时根，并启动一个新的 TUI。