Tài liệu

Bắt đầu nhanh + mô tả chức năng của từng phần, từng thiết bị (đang tiếp tục cập nhật)

MCP / Tích hợp AI

SSH Everywhere tích hợp sẵn giao diện MCP (Model Context Protocol) chuẩn, cho phép trợ lý AI của bạn (WorkBuddy / Claude / Cursor…) dùng ngôn ngữ tự nhiên giúp bạn quản lý toàn bộ máy chủ đứng tên bạn.

> Hiểu trong một câu: MCP là "cổng USB" để AI gọi các công cụ bên ngoài. Qua MCP, SSH Everywhere tự biến mình thành "đôi tay giúp AI vận hành máy chủ" — bạn chỉ nói tiếng người với AI, AI thao tác máy chủ thông qua SSH Everywhere, suốt quá trình không chạm mật khẩu, không chạm dòng lệnh.

---

Nguyên lý hoạt động

Bạn (ngôn ngữ tự nhiên) → AI Agent → SSH Everywhere (máy nhảy · ủy thác thông tin đăng nhập) → Cụm máy chủ
  • Mật khẩu máy chủ chỉ tồn tại trong bảng điều khiển, trợ lý AI chỉ nhận một Token, không thể chạm tới mật khẩu.
  • Mọi máy chủ đứng tên bạn (máy chủ đám mây, thiết bị mạng nội bộ, máy Android), AI đều có thể thao tác thống nhất qua SSH Everywhere với vai trò máy nhảy.

---

Tích hợp trong 3 bước

Bước 1: Cài đặt bảng điều khiển

Script cài đặt sẽ tự động cài sẵn dịch vụ MCP, không cần cấu hình thêm:

curl -fsSL https://ssheverywhere.com/install.sh | bash

Bước 2: Sao chép địa chỉ tích hợp

Đăng nhập bảng điều khiển, nhấn「🤖 Tích hợp MCP / AI」trong menu bắt đầu, bạn sẽ thấy:

  • Địa chỉ tích hợp (URL đầy đủ kèm token)
  • Token tích hợp (Token)
  • Cấu hình dựng sẵn cho từng trợ lý AI

Sao chép một cú nhấp là xong, không phải điền tay, không phải hỏi ai.

Bước 3: Dán vào trợ lý AI

Dán địa chỉ vào WorkBuddy (hoặc trợ lý AI khác hỗ trợ MCP) rồi lưu lại. Thấy dấu hiệu kết nối thành công màu xanh là hoàn tất.

---

6 công cụ vận hành chính

Sau khi tích hợp, trợ lý AI có thể giúp bạn làm những việc sau:

Công cụCông dụng
list_serversLiệt kê toàn bộ máy chủ
run_commandThực thi lệnh trên máy chủ
list_filesLiệt kê thư mục
read_fileĐọc nội dung tệp
write_fileGhi / sửa tệp
get_system_infoXem CPU / bộ nhớ / ổ đĩa

---

Ví dụ sử dụng

Sau khi cấu hình xong, chỉ cần nói tiếng người với trợ lý AI:

  • "Giúp tôi xem tôi có mấy máy chủ"
  • "Chạy thử df -h trên máy chủ blog"
  • "Đọc cấu hình nginx của máy chủ vận hành"
  • "Xem trong /var/log của thiết bị NAT kia có gì"

Trợ lý AI sẽ tự động gọi công cụ tương ứng, thay bạn thực thi trên máy chủ đích, rồi tổng hợp kết quả thành ngôn ngữ tự nhiên và báo lại cho bạn.

---

Cấu hình từng trợ lý AI

WorkBuddy (Tencent)

Thanh bên → Plugin → Máy chủ MCP → Cấu hình MCP, chọn loại HTTP, dán địa chỉ tích hợp đã sao chép trên bảng điều khiển, lưu lại là xong.

Claude Desktop

Sửa tệp claude_desktop_config.json, dán cấu hình đã sao chép trên bảng điều khiển:

{
  "mcpServers": {
    "ssh-everywhere": {
      "type": "http",
      "url": "http://<address-copied-from-panel>"
    }
  }
}

Cursor

Settings → MCP → Add new MCP server, chọn loại HTTP, dán địa chỉ tích hợp.

Các trợ lý AI khác

Bất kỳ công cụ nào đã triển khai MCP (Streamable HTTP) đều có thể tích hợp, cách làm tương tự: thêm một máy chủ MCP loại HTTP, điền địa chỉ đã sao chép trên bảng điều khiển.

---

Lưu ý bảo mật

  • Ủy thác thông tin đăng nhập: mật khẩu máy chủ chỉ tồn tại trong bảng điều khiển, trợ lý AI chỉ nhận Token, từ đầu tới cuối không thể chạm tới mật khẩu.
  • Token hai lớp: Agent → MCP dùng "token MCP", MCP → bảng điều khiển dùng "token API", hai lớp tách biệt.
  • Token tương đương quyền quản trị: đừng để lộ địa chỉ tích hợp / token, cũng đừng chụp màn hình rồi chia sẻ ra ngoài.