CetriX Connect

Ghép một máy tính với tài khoản CetriX Connect để sử dụng qua MCP. Mỗi máy có danh tính riêng và endpoint riêng; đăng nhập và xác nhận trên trình duyệt trước khi kết nối được cấp quyền.

Bắt đầu

Cài Node.js 24 trở lên, mở PowerShell hoặc terminal trên máy cần ghép, rồi chạy:

npx --yes [email protected] remote

Lệnh tự tải agent, lấy tên PC và tạo thư mục CetriX Workspace trong thư mục người dùng (ví dụ C:\Users\Admin\CetriX Workspace). Không phải nhập tên hay đường dẫn trong terminal. Lần đầu, trình duyệt mở CetriX Connect để đăng nhập, đối chiếu mã ghép và xác nhận tên máy, thư mục, quyền truy cập.

Mặc định chỉ được đọc file trong thư mục này. Quyền ghi file và chạy lệnh cần được bật rõ ràng. Khi bật chạy lệnh, tiến trình sử dụng quyền của tài khoản hệ điều hành hiện tại và không bị cách ly trong thư mục dữ liệu.

Giữ terminal mở để máy duy trì kết nối. Nhấn Ctrl+C để dừng. Gói này không cài dịch vụ chạy nền hoặc tự khởi động cùng máy tính.

Chạy lại máy đã ghép

Chạy lại chính lệnh ban đầu để dùng danh tính đã lưu, không cần ghép lại:

npx --yes [email protected] remote

Danh tính được lưu ngoài thư mục tải tạm của npm. Trên Windows, khóa được bảo vệ bằng DPAPI của người dùng hiện tại; trên macOS/Linux, file chỉ cho phép chủ sở hữu truy cập. Không gửi file danh tính cho người khác và không chuyển nó sang tài khoản Windows khác. Xóa cache npm không xóa danh tính đã lưu.

Để dùng thư mục có sẵn khác, mở Tùy chọn kết nối trên dashboard rồi sao chép lệnh mới, hoặc thêm --root "D:\DuAn". Có thể đổi tên bằng --name "PC 01". Thay đổi cấu hình kết nối cần xác nhận lại trên trình duyệt; không tự mở rộng quyền của máy đã ghép. Khi dùng cấu hình tùy chỉnh, chạy lại cùng lệnh đó.

Danh tính cũ từ bộ ZIP hoặc agent 0.3.0 vẫn dùng được bằng lệnh chỉ định rõ:

npx --yes [email protected] run --config "duong-dan-danh-tinh.json"

Nếu dùng máy chủ CetriX khác, xem các tùy chọn:

npx --yes [email protected] --help

Máy dùng kết nối HTTPS/WebSocket đi ra, không cần mở cổng đi vào. Agent Linux cần lệnh ps (gói procps trên Debian/Ubuntu) để sử dụng công cụ quản lý tiến trình.

Kết nối trợ lý

Mở CetriX Connect, chọn đúng máy rồi sao chép endpoint MCP của máy đó. Cấp quyền OAuth cho đúng tài khoản và đúng máy khi thêm endpoint vào ứng dụng hỗ trợ MCP.

Gói npm này chỉ chứa agent; không chứa máy chủ, cơ sở dữ liệu, tài khoản hay khóa thiết bị. Mã CetriX được bảo lưu bản quyền; font và các dependency sử dụng giấy phép riêng đi kèm.