Chia sẻ TUI trực tiếp qua MCP

Trang này được dịch từ tài liệu tiếng Anh. Lệnh, định danh và ví dụ giữ nguyên. Runtime 7.24.4 · SDK 2.6.7. Bản tiếng Anh

Trạng thái: Thử nghiệm Phạm vi: công khai, trạng thái hiện tại Xem xét lần cuối: 2026-10-04 Chủ sở hữu: người bảo trì AX Code

TUIMCP là một bộ chuyển MCP thử nghiệm, chọn tham gia, cho TUI AX Code trên macOS và Linux. Nó cho một tác nhân bên ngoài đọc trạng thái giao diện có giới hạn và điều hướng cùng TUI bạn đang dùng. Windows không được hỗ trợ trong phiên bản này.

Khởi động một TUI với chia sẻ tường minh:

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

Thanh TUIMCP hiện đường dẫn riêng tuyệt đối endpoint.json. Hãy cấu hình máy khách MCP của bạn để khởi chạy:

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

Dùng đường dẫn mà TUI đang chạy của bạn hiện. Mỗi TUI có điểm cuối riêng; không có khám phá tự động hay chọn đích. Máy khách phải chạy dưới cùng người dùng hệ điều hành. Hãy coi tệp điểm cuối là một khả năng: nó chứa một token bí mật. Đừng commit, sao chép vào lời nhắc, hay chia sẻ nội dung của nó. Thông tin xác thực backend không bao giờ được truyền cho bộ chuyển.

Công cụ

get_view_context: trả về thực thể/thế hệ, bản sửa, tuyến, mã phiên tùy chọn, mức sẵn sàng và việc điều hướng có bị chặn hay không. Nó không trả bản ghi, bản nháp, tiêu đề phiên, đường dẫn không gian làm việc hay thông tin xác thực.
select_session: cần danh tính và bản sửa từ một ngữ cảnh mới, một mã phiên dự án và một UUID requestId duy nhất. Nó xác thực phiên qua kết nối backend đã xác thực hiện có của TUI. Một phản hồi thành công xác nhận trạng thái tuyến ứng dụng; kết xuất và việc nạp phiên vẫn có thể đang diễn ra. Mã phiên có thể lấy riêng qua các giao diện phiên AX Code thông thường.

Điều hướng bị từ chối khi còn bản nháp hoặc tệp đính kèm, một hộp thoại hoặc phê duyệt đang chờ, các phiên đang bận, backend bị ngắt, lớp phủ khởi động/thoát đang hoạt động, hoặc người dùng đã tương tác trong 1.5 giây gần nhất. Trạng thái giao diện hoặc không gian làm việc đã đổi làm mất hiệu lực các bản sửa cũ. Các công cụ này không thể gửi lời nhắc, thực thi lệnh shell, phê duyệt quyền hay bắt đầu việc của tác nhân.

Một requestId giống hệt lặp lại trả về biên nhận gốc của nó, kể cả ngữ cảnh gốc. Tái dùng nó với đối số khác là một lỗi. Sau 128 yêu cầu điều hướng, các yêu cầu mới bị từ chối với tiến trình TUI đó; quyền đọc và các biên nhận hiện có vẫn dùng được. Hãy khởi động lại với chia sẻ tường minh để đặt lại giới hạn này. Biên nhận không bị đẩy ra thành phát lại không an toàn.

deadline_exceeded nghĩa là xác thực bị hủy trước khi điều hướng. timeout_unknown hoặc outcome_unknown nghĩa là bên gọi không nhận được kết quả dứt khoát; thao tác có thể đã được áp dụng. Hãy đọc ngữ cảnh hiện tại để đối chiếu. Bộ chuyển không bao giờ tự thử lại. Thành công kết nối hoặc truyền tải tự nó không có nghĩa điều hướng đã thành công; hãy kiểm tra isError và kết quả có cấu trúc.

Thu hồi và vòng đời

Nhấp [Thu hồi] trên thanh TUIMCP hoặc chạy /tui-mcp-revoke. Thu hồi ngay lập tức rào các điều hướng đang chờ và đóng socket. Thoát cũng đóng điểm cuối; khởi động lại tạo danh tính và token mới. Một tiến trình sự cố có thể để lại một thư mục tạm riêng trơ; máy khách cũ không thể gắn vào một TUI mới qua thư mục đó.

Chia sẻ tắt theo mặc định và không được lưu bền. Kiểm tra chủ sở hữu/chế độ cục bộ bảo vệ khỏi người dùng hệ điều hành khác; TUIMCP không phải sandbox chống mã đã chạy dưới người dùng của bạn. Nếu khởi động báo đường dẫn socket quá dài, hãy dùng một gốc tạm riêng ngắn hơn qua TMPDIR và khởi động một TUI mới.