DrayMCP Server trên router DrayTek sử dụng DrayOS 5 cho phép kết nối router với các ứng dụng AI thông qua giao thức MCP (Model Context Protocol).

Thông qua các công cụ MCP được cung cấp, AI có thể tương tác với router để truy xuất thông tin, kiểm tra và hỗ trợ cấu hình, giám sát thiết bị. Tính năng này giúp đơn giản hóa công việc vận hành và nâng cao hiệu quả quản trị mạng.

A. Cấu hình trên router

1. Kích hoạt MCP

Vào System Maintenance >> Management, tại tab Service Control:

  • MCP Server: chọn Enable.
  • MCP HTTP / MCP HTTPS: nhập cổng truy cập dịch vụ tương ứng (mặc định là 3456 và 3457). Bật quyền truy cập từ LAN hoặc WAN theo nhu cầu.
  • Nhấn Apply để lưu cấu hình.
Kích hoạt MCP Server

Hình 1. Kích hoạt MCP Server

2. Cấu hình MCP token

Vào System Maintenance >> MCP Access Token, nhấn +Add.

Thêm MCP Access Token

Hình 2. Thêm MCP Access Token

  • Name: đặt tên token.
  • Server Status: chọn Enable.
  • Role: chọn quyền của tài khoản. Để quản lý toàn bộ router, chọn Administrator.
  • Nhấn Apply.
Thiết lập thông tin và quyền của token

Hình 3. Thiết lập thông tin và quyền của token

Khi hộp thoại pop-up xuất hiện, nhấn biểu tượng Copy để sao chép và lưu lại token, sau đó nhấn Close. Sau khi tạo thành công, token được hiển thị trong danh sách như hình dưới đây.

Danh sách MCP token

Hình 4. Danh sách MCP token

Lưu ý: Mỗi router có thể tạo tối đa 8 token và có thể kích hoạt riêng từng token. Bảo mật token như mật khẩu; chỉ cấp quyền cần thiết. Ưu tiên HTTPS hoặc kết nối qua VPN khi quản trị từ xa, tránh mở dịch vụ MCP trực tiếp ra Internet nếu không cần thiết.

B. Cấu hình trên máy tính (client)

1. Tạo Gemini API key

Truy cập Google AI Studio và đăng nhập bằng tài khoản Google dùng cho Gemini.

Nhấn Create API key.

Tạo API key trong Google AI Studio

Hình 5. Tạo API key trong Google AI Studio

  • Name Your Key: đặt tên API key.
  • Choose an imported Project: chọn Default Gemini Project (nếu có).
  • Nhấn Create Key.
Đặt tên và chọn project cho API key

Hình 6. Đặt tên và chọn project cho API key

Nhấn Copy Key để sao chép và lưu lại API key ở nơi an toàn.

Sao chép API key

Hình 7. Sao chép API key

2. Cài đặt Gemini CLI

Cài đặt Node.js nếu máy tính chưa có. Sau đó mở PowerShell hoặc Command Prompt (CMD) và chạy lệnh:

npm install -g @google/gemini-cli
Cài đặt Gemini CLI

Hình 8. Cài đặt Gemini CLI

3. Kết nối Gemini API

Mở PowerShell hoặc CMD trên máy tính đã cài Gemini CLI và chạy lệnh:

gemini

Chọn tin cậy thư mục đang sử dụng (chỉ khi đó là thư mục bạn tin tưởng) và nhấn Enter.

Xác nhận mức độ tin cậy của thư mục

Hình 9. Xác nhận mức độ tin cậy của thư mục

Chọn Use Gemini API Key và nhấn Enter.

Chọn phương thức xác thực bằng API key

Hình 10. Chọn phương thức xác thực bằng API key

Dán API key đã lấy ở bước 1 và nhấn Enter.

Nhập Gemini API key

Hình 11. Nhập Gemini API key

Khi nhận được thông báo Authenticated, Gemini CLI đã xác thực thành công.

Xác thực Gemini CLI thành công

Hình 12. Xác thực Gemini CLI thành công

4. Kết nối Gemini CLI với router DrayTek

Mở PowerShell và chạy lệnh sau để chỉnh sửa tệp cấu hình Gemini CLI:

notepad $HOME\.gemini\settings.json

Nếu sử dụng CMD, chạy lệnh:

notepad "%USERPROFILE%\.gemini\settings.json"

Tham khảo cấu hình JSON dưới đây. Thay IP_Router bằng địa chỉ IP của router và Token bằng MCP token đã tạo ở phần A. Nếu tệp đã có các thiết lập khác, hãy sao lưu và bổ sung phần mcpServers thay vì ghi đè toàn bộ tệp.

{
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  },
  "mcpServers": {
    "draytek-router": {
      "url": "http://IP_Router:3456/mcp",
      "headers": {
        "Authorization": "Bearer Token"
      }
    }
  }
}
Cấu hình MCP Server trong settings.json

Hình 13. Cấu hình MCP Server trong settings.json

5. Khởi chạy và kiểm tra kết nối

Mở PowerShell hoặc CMD, chạy lệnh gemini. Trong Gemini CLI, nhập lệnh sau để kiểm tra trạng thái MCP Server:

/mcp
Kiểm tra trạng thái MCP Server

Hình 14. Kiểm tra trạng thái MCP Server

Khi kết nối thành công, bạn có thể gửi yêu cầu bằng tiếng Việt hoặc tiếng Anh mà không cần nhớ cú pháp lệnh router phức tạp. Để lựa chọn model AI phù hợp với nhu cầu, nhập lệnh /model rồi chọn Manual (nếu phiên bản đang sử dụng hỗ trợ tùy chọn này).

Chọn model AI

Hình 15. Chọn model AI

Lựa chọn model theo nhu cầu

Hình 16. Lựa chọn model theo nhu cầu

C. Một số ví dụ sử dụng DrayMCP

Ví dụ 1: Kiểm tra địa chỉ IP WAN

Tại khung chat, nhập yêu cầu:

show wan ip
Gửi yêu cầu kiểm tra địa chỉ IP WAN

Hình 17. Gửi yêu cầu kiểm tra địa chỉ IP WAN

Khi hệ thống yêu cầu cấp quyền, chọn quyền phù hợp rồi nhấn Enter. Trong hình minh họa, tùy chọn Allow all server tools for this session cho phép sử dụng tất cả công cụ của server trong phiên hiện tại; chỉ chọn khi bạn tin cậy server và hiểu phạm vi quyền được cấp.

Xác nhận cấp quyền sử dụng công cụ MCP

Hình 18. Xác nhận cấp quyền sử dụng công cụ MCP

Kết quả thu được:

Kết quả kiểm tra WAN IP

Hình 19. Kết quả kiểm tra WAN IP

Ví dụ 2: Đổi tên router

Nhập yêu cầu để xem thông tin tên router hiện tại:

show mDNs
Gửi yêu cầu kiểm tra tên router

Hình 20. Gửi yêu cầu kiểm tra tên router

Kết quả thu được:

Thông tin trước khi đổi tên router

Hình 21. Thông tin trước khi đổi tên router

Nhập yêu cầu đổi tên router:

đổi router name thành test_MCP
Gửi yêu cầu đổi tên router

Hình 22. Gửi yêu cầu đổi tên router

Kết quả thu được:

Kết quả sau khi đổi tên router

Hình 23. Kết quả sau khi đổi tên router

Ví dụ 3: Kiểm tra trạng thái Telnet Server

Nhập yêu cầu:

kiểm tra trạng thái telnet
Gửi yêu cầu kiểm tra Telnet Server

Hình 24. Gửi yêu cầu kiểm tra Telnet Server

Kết quả thu được:

Trạng thái Telnet Server

Hình 25. Trạng thái Telnet Server

Ví dụ 4: Tạo thêm lớp mạng LAN

Nhập yêu cầu:

tạo thêm lớp mạng lan 192.168.105.1/24
Gửi yêu cầu tạo lớp mạng LAN

Hình 26. Gửi yêu cầu tạo lớp mạng LAN

Kết quả thu được trong Gemini CLI:

Kết quả tạo lớp mạng LAN

Hình 27. Kết quả tạo lớp mạng LAN

Kiểm tra lại kết quả trên giao diện web của router:

Kiểm tra lớp mạng LAN trên giao diện web của router

Hình 28. Kiểm tra lớp mạng LAN trên giao diện web của router