Tác nhân MCP

MCP cho phép Codex, Claude Code hoặc Antigravity CLI sử dụng các công cụ của DR-Terminal. Tác nhân có thể xem các phiên và kết nối đã lưu, mở một kết nối, đọc đầu ra terminal, gõ lệnh, truyền tệp và điều hướng trong ứng dụng. Chế độ MCP khả dụng trong thời gian dùng thử đang hoạt động và với gói Pro.

Thêm DR-Terminal vào một tác nhân

  1. Nhấp MCP trên thanh tiêu đề của DR-Terminal.
  2. Chọn Add to Codex, Add to Claude hoặc Add to Antigravity. Thao tác này tạo một mục dr-terminal ở cấp người dùng, chạy cầu nối từ gói DR-Terminal đã cài đặt; không có token hay endpoint nào được lưu trong cấu hình của máy khách. Antigravity 2.0, Antigravity IDE và agy dùng chung mục này trong ~/.gemini/config/mcp_config.json.
  3. Chọn Mở hoặc mở máy khách theo cách thông thường. Kết nối đầu tiên sẽ đưa cửa sổ DR-Terminal lên trước và yêu cầu bạn chọn Allow hoặc Từ chối.
  4. Sau khi cho phép kết nối, dán prompt đầu tiên và gửi đi.
Hiển thị các phiên DR-Terminal đang hoạt động của tôi.

CLI đã chọn phải được cài đặt và có sẵn trong PATH. Việc cài đặt được hỗ trợ từ một gói DR-Terminal đã cài; các lần chạy phát triển từ Gradle hoặc IDE cố ý không tạo mục cố định. Remove chỉ xóa mục thuộc sở hữu chính xác của DR-Terminal và sẽ hỏi xác nhận. Một mục dr-terminal khác đã tồn tại sẽ được báo là xung đột và không bao giờ bị ghi đè.

Các prompt hữu ích

Hãy dùng tên hoặc mã định danh của phiên khi có nhiều hơn một phiên đang mở. Nếu tác nhân báo rằng không có phiên nào, hãy mở một kết nối trong DR-Terminal hoặc yêu cầu tác nhân liệt kê các kết nối đã lưu trước.

Phê duyệt và chỉ báo

Việc đọc siêu dữ liệu phiên và đầu ra terminal thường không làm gián đoạn công việc của bạn. Các thao tác nhạy cảm như gõ phím, nhấn phím, truyền tệp và ngắt kết nối cần bạn phê duyệt.

Khi cần phê duyệt, chip MCP sẽ nhấp nháy theo nhịp và hộp thoại xác nhận nhận tiêu điểm bàn phím. Hãy xem lại phiên đích và nội dung sẽ gửi, rồi chọn Cho phép một lần, Cho phép trong phiên này hoặc Từ chối. Thẻ của phiên bị tác động có một dấu MCP tĩnh trong khi thao tác đang chạy; màu của chip cho biết trạng thái MCP toàn cục.

Tác nhân không bao giờ nhận được mật khẩu hay khóa riêng tư mà DR-Terminal đã lưu. Phê duyệt cho một phiên chỉ có hiệu lực khi lần chạy máy chủ MCP hiện tại còn hoạt động.

Bảo mật kết nối cục bộ

Máy chủ MCP chỉ lắng nghe trên giao diện loopback, nên nó không bị lộ ra mạng. Mỗi yêu cầu vẫn cần một token bearer được lưu trong tệp cục bộ mà chỉ chủ sở hữu truy cập được. Popover trên thanh tiêu đề không bao giờ hiển thị hay sao chép token đó.

Endpoint chỉ được hiển thị trong mục Endpoint và thao tác gần đây cho mục đích chẩn đoán. Đừng chia sẻ tệp token hay sao chép nội dung của nó vào prompt, tin nhắn trò chuyện, nhật ký hoặc ảnh chụp màn hình.

Dừng MCP

Chọn Dừng trong popover MCP để từ chối mọi phê duyệt đang chờ, ngừng tiếp nhận lời gọi công cụ và đóng các máy khách được khởi chạy bởi lần chạy MCP hiện tại. Khởi động lại MCP tạo một lần chạy mới; các phê duyệt phiên trước đó không được giữ lại.

Nhấp vào huy hiệu MCP chỉ mở popover. Nó không bao giờ khởi động máy chủ một cách ngầm định. Hãy dùng thao tác Start MCP rõ ràng để chạy thủ công; một máy khách đã đăng ký cũng có thể khởi động máy chủ thông qua luồng phê duyệt kết nối hiển thị.

Khắc phục sự cố

Không tìm thấy CLI

Cài đặt CLI Codex, Claude Code hoặc Antigravity (agy) đã chọn và đảm bảo tệp thực thi của nó có sẵn trong PATH. Khởi động lại DR-Terminal sau khi thay đổi môi trường shell, rồi chọn Kiểm tra lại.

Cổng đã được sử dụng

Một tiến trình khác đang dùng cổng MCP đã cấu hình. Hãy dừng tiến trình đó hoặc chọn cổng khác trong Cài đặt → Chế độ MCP, rồi khởi động MCP lại.

Không có phiên đang hoạt động

Trước tiên hãy mở một phiên SSH, Telnet, nối tiếp hoặc terminal cục bộ. Bạn cũng có thể yêu cầu tác nhân hiển thị các kết nối đã lưu và mở một kết nối sau khi bạn phê duyệt thao tác.

Máy khách đang chạy nhưng MCP chưa được xác nhận

Tiến trình CLI đã khởi động, nhưng DR-Terminal chưa nhận được lời gọi công cụ MCP nào. Hãy kiểm tra thẻ terminal mới xem có lỗi đăng nhập, cấu hình hay bắt tay không. Sau đó gửi lại prompt mẫu. Đang chạy mô tả tiến trình cục bộ, không phải một kết nối MCP đã được xác nhận.

Một hộp thoại phê duyệt đang chờ

Hãy quay lại DR-Terminal và xem hộp thoại đang có tiêu điểm. Tác nhân không thể tiếp tục thao tác nhạy cảm đó cho đến khi bạn cho phép hoặc từ chối. Dừng MCP sẽ từ chối yêu cầu đang chờ.

Previous
Telnet