Phân quyền và lượt dùng thử
Mục lục
Toàn bộ cơ chế thẩm định quyền truy cập của vnstock-mcp được thực hiện trực tiếp bởi lõi Rust nguyên khối, kết nối tĩnh với hệ thống phân quyền chuẩn Gen 5. Không có bất kỳ logic phân quyền nào phụ thuộc vào mã nguồn Python hay có thể bị can thiệp trái phép.
Tổng quan
vnstock-mcp áp dụng mô hình phân quyền rõ ràng theo từng cấp tài khoản. Với tư cách là người dùng bản Cộng đồng, bạn được quyền sử dụng 26 công cụ cơ sở cùng chính sách dùng thử định lượng 30 lượt/ngày (miễn phí cho cá nhân, học tập và nghiên cứu).
1. Quyền hạn của Bản Cộng đồng
| Nhóm chức năng | Số lượng công cụ | Quyền hạn chi tiết |
|---|---|---|
| Tra cứu Tổng quan | 7 công cụ | Tra cứu danh sách mã cổ phiếu theo sàn (HOSE, HNX, UPCoM), rổ chỉ số VN30, cây ngành ICB 4 cấp, lịch nghỉ lễ, giờ giao dịch, bảng giá cơ sở. |
| Hồ sơ & Báo cáo tài chính | 9 công cụ | Hồ sơ doanh nghiệp niêm yết, Bảng cân đối kế toán, Báo cáo kết quả kinh doanh, Báo cáo lưu chuyển tiền tệ, chỉ số tài chính cơ bản, lịch sử chia cổ tức. |
| Vĩ mô & Thị trường | 3 công cụ | Chỉ số vĩ mô cơ bản, dữ liệu mở tài khoản nhà đầu tư mới, thống kê thị trường. |
| Harness Nghiên cứu Cục bộ | 4 công cụ | Quản lý bảng ledger tạm thời trong phiên, lưu/nạp file CSV/JSON trên máy, đối chiếu 2 nguồn dữ liệu (research_diff), xuất script Python tái lập (research_journal). |
| Dùng thử Định lượng (Quant Trial) | 3 công cụ | 30 lượt / ngày cho tính toán chỉ báo kỹ thuật cơ bản (quant_ta_basic), chỉ số tài chính (quant_fa_basic), và tra cứu danh mục chỉ báo (quant_catalog). |
| Tổng cộng | 26 công cụ | Dành cho cá nhân, học tập và nghiên cứu |
2. Chính sách Dùng thử Quant Hàng ngày (30 lượt / ngày)
Nhằm khuyến khích cộng đồng tiếp cận phương pháp đầu tư định lượng khoa học, vnstock-mcp cấp quyền dùng thử định lượng hàng ngày cho người dùng bản Cộng đồng:
- Lượt dùng thử: 30 lượt tính toán / ngày cho hai công cụ:
quant_ta_basic: Tính các chỉ báo kỹ thuật cốt lõi (SMA, EMA, RSI, MACD, Bollinger Bands, ATR, Stochastic, OBV...).quant_fa_basic: Tính các chỉ số tài chính cơ bản trực tiếp trên Báo cáo tài chính.
- Dữ liệu linh hoạt: Bạn có thể dùng 30 lượt này để tính trên dữ liệu nến Vnstock HOẶC tính trên dữ liệu do bạn tự nhập, dữ liệu file CSV, hay dữ liệu từ nguồn khác bạn có quyền sử dụng hợp pháp.
- Tự động làm mới: Bộ đếm lượt dùng thử tự động làm mới vào lúc
00:00:00hàng ngày theo giờ Việt Nam (UTC+7).
3. Cơ chế Lọc danh mục công cụ (Tool Filtering)
Một trong những hạn chế khi dùng MCP với các Trợ lý AI là hiện tượng AI có thể gọi nhầm các công cụ vượt cấp tài khoản của người dùng, dẫn đến chuỗi lỗi phản hồi và làm gián đoạn trải nghiệm người dùng.
vnstock-mcp giải quyết vấn đề này bằng cơ chế Lọc danh mục công cụ (Tool Filtering) ngay tại tầng Rust:
┌────────────────────────────────┐
│ Cấp tài khoản người dùng: FREE │
└───────────────┬────────────────┘
│
_native.get_enabled_tools()
│
▼
┌────────────────────────────────────────────────────────┐
│ Rust Core: Duyệt 37 công cụ theo catalog │
│ • Tool có minimum_tier <= Free --> CẤP PHÉP │
│ • Tool có minimum_tier > Free --> ẨN KHỎI DANH MỤC │
└───────────────────────────┬────────────────────────────┘
│
▼
┌────────────────────────────────────────────────────────┐
│ FastMCP server: Mount ĐÚNG 26 CÔNG CỤ vào tools/list │
└───────────────────────────┬────────────────────────────┘
│
▼
┌────────────────────────────────────────────────────────┐
│ Trợ lý AI chỉ nhìn thấy 26 công cụ hợp lệ │
│ ==> HẠN CHẾ NGUY CƠ GỌI SAI CÔNG CỤ │
└────────────────────────────────────────────────────────┘
Trợ lý AI chỉ nhận được danh sách 26 công cụ thuộc phạm vi cấp quyền, giúp giảm thiểu lỗi gọi nhầm công cụ và tăng độ ổn định của phiên làm việc.
4. Khi nào bạn nên Nâng cấp lên Bản Mở rộng?
Khi nhu cầu nghiên cứu và phân tích của bạn vượt quá phạm vi cơ bản, bạn có thể tham gia các gói tài trợ dự án để mở rộng năng lực định lượng của hệ sinh thái:
- Gói Bronze (Tài trợ Đồng - 33 công cụ):
- Quant không bị đếm lượt dùng thử; phép tính tính vào hạn mức chung của tài khoản.
- Mở khóa toàn bộ nến lịch sử OHLCV sâu, sổ lệnh độ sâu (Order Book), dòng tiền tự doanh & khối ngoại.
- Phân tích rủi ro danh mục chuyên sâu: Value at Risk (VaR), Conditional VaR (CVaR), Beta, Max Drawdown.
- Gói Silver (Tài trợ Bạc - 36 công cụ):
- Toàn bộ quyền lợi của Bronze.
- Mở khóa đầy đủ 58+ chỉ báo kỹ thuật chuyên sâu (Ichimoku Cloud, SuperTrend, VWAP, Chaikin Money Flow, Keltner Channels, Donchian, Parabolic SAR...).
- Gói Golden & Diamond (37 công cụ):
- Mở khóa toàn bộ hệ sinh thái tối ưu hóa danh mục hiện đại: Markowitz Efficient Frontier, Risk Parity, Black-Litterman.
- Pipeline tự động hóa xuất dữ liệu cho AmiBroker và Excel.
Tham khảo chi tiết tại trang Chương trình Tài trợ Dự án.
Tiếp theo
- Khám phá chi tiết Danh mục 26 Công cụ dành cho bản Cộng đồng.