Cách kết nối Claude với dữ liệu chứng khoán Việt Nam

• Tài khoản Claude ở bất kỳ gói nào: Free, Pro, Max, Team hoặc Enterprise. Theo trung tâm trợ giúp của Anthropic, gói Free được thêm một custom connector; gói Team và Enterprise cần chủ sở hữu (Owner) thêm connector cho tổ chức trước.
• Tài khoản Algolab miễn phí — tạo ngay trong bước đăng nhập nếu chưa có. Tài khoản Lite dùng chung 1.000 lượt gọi công cụ mỗi ngày; gói Plus, Pro, Max có hạn mức riêng.
• Không cần cài phần mềm: Claude kết nối tới máy chủ Algolab từ hạ tầng đám mây của Anthropic, bạn chỉ thao tác trong trình duyệt hoặc ứng dụng Claude.

Đây là cách một chạm: không khoá, không terminal. Connector gắn với tài khoản Claude, nên thêm một lần trên web là dùng được trong Claude Desktop.

1. 1

   Bước 1: Mở mục Connectors

   Trên claude.ai hoặc Claude Desktop, mở Customize ở thanh bên rồi chọn Connectors (một số phiên bản đặt mục này ở Settings → Connectors). Với gói Team/Enterprise, chủ sở hữu tổ chức thêm connector trong Organization settings → Connectors trước, thành viên chỉ cần bấm Connect.

2. 2

   Bước 2: Thêm custom connector Algolab

   Bấm dấu + và chọn Add custom connector. Điền Name: Algolab và Remote MCP server URL như dưới đây, rồi bấm Add. Không cần mở Advanced settings.

   https://mcp.algolab.vn

3. 3

   Bước 3: Bấm Connect và cấp quyền

   Bấm Connect bên cạnh connector vừa thêm. Trang đăng nhập Algolab mở ra — đăng nhập (hoặc tạo tài khoản miễn phí) rồi bấm Cho phép. Quyền cấp cho Claude là đọc dữ liệu thị trường, không truy cập dữ liệu cá nhân của bạn.

4. 4

   Bước 4: Bật connector trong cuộc trò chuyện

   Mở cuộc trò chuyện mới, bấm nút + ở góc dưới bên trái khung chat, chọn Connectors và bật Algolab. Có thể tắt từng công cụ trong menu Search and tools nếu muốn.

5. 5

   Bước 5: Hỏi thử bằng tiếng Việt

   Gõ một câu hỏi có số liệu, ví dụ câu dưới đây. Claude sẽ gọi công cụ get_market_overview của Algolab rồi trả lời kèm mốc thời gian của số liệu.

   VN-Index hôm nay thế nào? Nhóm ngành nào dẫn dắt, khối ngoại mua ròng mã nào?

Claude Code là trợ lý lập trình chạy trong terminal. Cách chắc chắn nhất là dùng khoá API của Algolab:

Tạo khoá API

Đăng nhập algolab.vn/mcp, kéo tới phần “Cách 2” và bấm tạo khoá. Khoá có dạng alm_… và chỉ hiện một lần — lưu lại ngay. Quên khoá thì tạo lại; khoá cũ tự vô hiệu.

Thêm máy chủ

Chạy lệnh sau trong terminal (không dán vào cuộc trò chuyện), thay alm_xxx bằng khoá của bạn:

claude mcp add --transport http --scope user algolab \
  "https://mcp.algolab.vn" \
  --header "Authorization: Bearer alm_xxx"

• --scope user giúp máy chủ có mặt ở mọi thư mục, mọi phiên. Thiếu tham số này, Claude Code dùng phạm vi mặc định local — máy chủ chỉ có trong thư mục lúc cài.
• Kiểm tra bằng claude mcp list, hoặc gõ /mcp trong phiên để xem trạng thái kết nối và danh sách công cụ.
• Lệnh dựng sẵn của Algolab xuất hiện dưới dạng /mcp__algolab__…, ví dụ phân tích một mã, tổng quan thị trường hay dự báo VN-Index.

Không muốn dùng khoá? Claude Code cũng hỗ trợ đăng nhập OAuth cho máy chủ từ xa: thêm máy chủ không kèm --header, rồi gõ /mcp và chọn xác thực để mở trang đăng nhập Algolab trong trình duyệt. Nếu bước này báo lỗi, quay lại cách dùng khoá ở trên. Tham khảo tài liệu MCP của Claude Code.

Cursor, Gemini CLI và Antigravity cấu hình tương tự bằng file JSON — mẫu có sẵn trên trang Algolab MCP và trong tài liệu kết nối.

Hỏi bằng tiếng Việt như với một chuyên viên; Claude tự chọn công cụ. Vài câu mở đầu:

• “Tổng quan thị trường hôm nay: chỉ số, độ rộng, nhóm ngành dẫn dắt, khối ngoại.”
• “Phân tích FPT: định giá, kết quả kinh doanh 4 quý, khuyến nghị CTCK gần đây, tín hiệu kỹ thuật.”
• “So sánh lợi nhuận sau thuế của VCB, BID, CTG trong 4 quý gần nhất, trình bày thành bảng.”
• “Tóm tắt báo cáo phân tích mới nhất về HPG: luận điểm, giá mục tiêu, rủi ro.”
• “Lãi suất liên ngân hàng và tỷ giá USD/VND 3 tháng qua thay đổi thế nào?”

Thêm câu “ghi rõ mốc thời gian và nguồn” để câu trả lời dễ kiểm chứng. Kết quả nên đối chiếu với trang cổ phiếu hoặc bảng giá trên algolab.vn. Nhiều mẫu câu hỏi hơn trong bài AI đầu tư chứng khoán.