Trong kỷ nguyên tài chính số các nhà đầu tư không còn lãng phí thời gian tự tổng hợp số liệu từ hàng chục bảng giá khác nhau. Bằng cách cài đặt Finhay MCP trên Claude, bạn trao cho siêu AI này đặc quyền truy xuất dữ liệu thị trường Việt Nam theo thời gian thực (real-time) và phân tích sâu sát tài khoản cá nhân thông qua giao thức Model Context Protocol (MCP) bảo mật.
Quá trình thiết lập này hoàn toàn không đòi hỏi kiến thức lập trình phức tạp. Dưới đây là quy trình chi tiết, từng bước từ giai đoạn chuẩn bị, cài đặt ứng dụng chính thức, cho đến việc thiết lập phiên bản giao dịch nâng cao và ứng dụng các kịch bản (prompt) thực chiến để khai thác tối đa sức mạnh của AI Agent phân tích danh mục.
>> Đọc thêm: MCP chứng khoán nào tại Việt Nam được kết nối chính thức trên Store của Claude và ChatGPT?
1. Chuẩn bị trước khi cài đặt Finhay MCP trên Claude
Quá trình kết nối Finhay MCP với Claude AI diễn ra rất nhanh chóng (chưa tới 2 phút), nhưng bạn cần đảm bảo các điều kiện tiên quyết sau đây đã được đáp ứng.
Yêu cầu đối với tài khoản Claude
- Phiên bản ứng dụng: Việc cài đặt qua Kho ứng dụng và Custom Connectors hiện được hỗ trợ tốt nhất trên nền tảng Claude Desktop App (dành cho Windows/macOS) hoặc phiên bản Claude nền web có hỗ trợ tính năng Connectors.
- Gói cước: Khuyên dùng gói Claude Pro để mở khóa hoàn toàn giới hạn token khi AI phải xử lý các bảng dữ liệu báo cáo tài chính dài hàng nghìn dòng từ Finhay MCP trả về.
Yêu cầu đối với tài khoản Finhay Securities (FHSC)
- Định danh eKYC: Bạn cần sở hữu một tài khoản giao dịch chứng khoán tại FHSC đã được xác thực danh tính đầy đủ.
- Ứng dụng di động: Cài đặt sẵn ứng dụng Finhay trên điện thoại thông minh để thực hiện thao tác quét mã QR đăng nhập và phân quyền OAuth nhanh chóng.
3. Hướng dẫn kết nối Finhay MCP với Claude AI (Phiên bản Store - Chỉ đọc)
Dành cho 90% nhà đầu tư phổ thông, phiên bản phân phối chính thức trên Claude Directory là lựa chọn tối ưu. Phiên bản này cấp quyền Chỉ đọc (Read-only), giúp AI tra cứu dữ liệu thị trường và đọc danh mục đầu tư mà không có quyền đặt lệnh, đảm bảo an toàn tuyệt đối. Các bước kết nối Finhay MCP với Claude AI như sau:
Bước 1: Khởi động trình quản lý Connectors
Mở ứng dụng Claude của bạn. Tại thanh điều hướng bên trái màn hình, nhấp vào mục Customize (Tùy chỉnh), sau đó chọn tiếp vào thẻ Connectors (Kết nối). Khu vực này là nơi quản lý toàn bộ các nguồn dữ liệu ngoại vi mà Claude có thể truy cập.
Bước 2: Tìm kiếm ứng dụng Finhay trên Directory
- Trong giao diện Connectors, bạn nhấn chọn Browse connectors (Duyệt kho kết nối). Một thanh tìm kiếm sẽ hiện ra. Hãy nhập từ khóa Finhay.
- Hệ thống sẽ hiển thị ứng dụng chính thức với logo Finhay và mô tả tính năng theo dõi thị trường Việt Nam. Nhấn nút Connect (Kết nối) màu xanh lá cây nằm bên cạnh ứng dụng.
Bước 3: Xác thực và Phân quyền qua mã QR
- Ngay sau khi bấm Connect, Claude sẽ hiển thị một cửa sổ chứa mã QR bảo mật. Bạn mở ứng dụng Finhay trên điện thoại, sử dụng tính năng quét mã QR để đăng nhập.
- Màn hình điện thoại sẽ hiển thị yêu cầu phân quyền từ Claude (Ví dụ: Yêu cầu quyền Xem dữ liệu thị trường, Xem danh mục/số dư/lãi lỗ). Hãy tích chọn các quyền bạn muốn và bấm Cho phép (Allow). Kết nối sẽ lập tức được thiết lập thành công.
4. Hướng dẫn kết nối Finhay MCP với Claude AI (Phiên bản Custom - Đặt lệnh)
Nếu bạn là một nhà đầu tư chủ động mong muốn xây dựng một AI Agent phân tích danh mục có khả năng chuẩn bị sẵn phiếu lệnh giao dịch, bạn cần sử dụng phiên bản finhay-trading. Phiên bản này yêu cầu cài đặt qua đường dẫn tùy chỉnh (Custom Link) với cơ chế bảo mật khắt khe hơn.
Bước 1: Thêm Custom Connector
Thay vì chọn "Browse connectors", tại giao diện Connectors trên Claude, bạn nhấp vào biểu tượng dấu cộng + và chọn Add custom connector (Thêm kết nối tùy chỉnh).
Bước 2: Nhập thông số Server của FHSC
Một bảng cấu hình sẽ hiện ra. Tại đây, bạn tiến hành nhập thông tin như sau:
- Name (Tên kết nối):
Finhay(hoặc Finhay Trading). - URL: Dán chính xác đường dẫn máy chủ giao dịch: https://mcp-trading.fhsc.com.vn/mcp
- Nhấn nút Add (Thêm) để lưu cấu hình này vào Claude.
Bước 3: Đăng nhập và xác thực quyền Giao dịch
Trở lại màn hình Connectors, bạn nhấn Connect tại mục Finhay vừa tạo. Một cửa sổ điều hướng tương tự bản Store sẽ hiện ra yêu cầu đăng nhập bằng tài khoản FHSC. Tuy nhiên, tại màn hình phê duyệt quyền trên điện thoại, bạn sẽ thấy xuất hiện thêm yêu cầu quyền: Đặt / sửa / huỷ lệnh chứng khoán (giao dịch). Tích chọn đồng ý và bấm Cho phép.
(Lưu ý: Ngay cả khi đã kết nối Finhay MCP với Claude AI qua luồng Trading, AI vẫn không thể tự ý mua bán. Mọi lệnh do AI soạn thảo đều phải được bạn duyệt thủ công qua mã Smart OTP trên ứng dụng điện thoại).
5. Bản đồ 65 Công cụ và 12 Nhóm dữ liệu cung cấp cho Claude AI
Sau khi hoàn tất kết nối Finhay MCP với Claude AI, Claude không còn là một cỗ máy ngôn ngữ trống rỗng. Nó đã được trang bị 65 công cụ (Tools) phân loại khoa học thành 12 nhóm dữ liệu chuyên sâu. Việc nắm vững bản đồ công cụ này giúp bạn thiết kế các câu lệnh (Prompt) chính xác hơn cho hướng dẫn sử dụng Finhay MCP.
|
Nhóm Dữ Liệu |
Số Công Cụ |
Chức Năng Nổi Bật Dành Cho AI Agent |
|---|---|---|
|
Cổ phiếu |
24 |
Cho phép Claude phân tích kỹ thuật ( |
|
Tài khoản |
8 |
Cốt lõi của AI Agent phân tích danh mục. Claude có thể xem số dư ( |
|
Hàng hóa & Vàng |
6 |
Theo dõi sát sao giá Vàng SJC, Vàng nhẫn 9999 ( |
|
Crypto & Forex |
6 (3+3) |
Cập nhật tỷ giá USD/VND ( |
|
Chỉ số & Vĩ mô |
6 (3+3) |
Quét xu hướng VN-Index ( |
|
Trái phiếu, ETF & Quỹ mở |
11 (4+4+3) |
Khai thác thông tin cấu trúc nợ, đa dạng hóa danh mục phòng thủ qua chứng chỉ quỹ (NAV) và Trái phiếu niêm yết. |
|
Tin tức & Workflow |
4 (3+1) |
Tổng hợp lịch sự kiện kinh tế ( |
Nhờ đó, khi thực hiện kết nối Finhay MCP với Claude AI, bạn đang thực sự biến Claude thành một Data Terminal chuyên nghiệp không thua kém các hệ thống B2B đắt đỏ.
>> Xem chi tiết 65 tools của Finhay MCP tại đây.
6. Tổng hợp Kịch bản (Prompt) thực chiến với AI Agent phân tích danh mục
Để thành thạo hướng dẫn sử dụng Finhay MCP, bạn cần học cách "giao tiếp" với Claude. Dưới đây là các kịch bản thực chiến giúp tối ưu hóa hiệu suất đầu tư sau khi kết nối Finhay MCP với Claude.
Kịch bản 1: Kiểm toán danh mục và Cảnh báo rủi ro
Một nhà đầu tư cá nhân thường phân bổ danh mục theo cảm tính. Hãy để Claude đo lường rủi ro tập trung của bạn.
Prompt: "Đóng vai trò là Giám đốc Quản trị Rủi ro. Hãy đọc danh mục hiện tại của tôi qua công cụ get_portfolio_positions. Phân tích tỷ trọng các nhóm ngành tôi đang nắm giữ. Dựa trên dữ liệu vĩ mô mới nhất (sử dụng get_macro_indicator), đánh giá xem danh mục này có đang quá nhạy cảm với rủi ro lạm phát hoặc tỷ giá hay không. Đề xuất phương án tái cơ cấu cụ thể."
Kịch bản 2: Tìm kiếm cơ hội đầu tư cổ phiếu
Thay vì sử dụng các bộ lọc cứng nhắc, bạn có thể mô tả ý tưởng đầu tư để Claude tự tìm kiếm.
Prompt: "Tôi muốn tìm kiếm cơ hội ở nhóm cổ phiếu Bất động sản KCN. Sử dụng công cụ MCP chứng khoán Claude, hãy quét các mã SZC, KBC, IDC. Hãy so sánh biên lợi nhuận, chỉ số P/B (get_financial_analysis) và đối chiếu với diễn biến dòng tiền khối ngoại trong 1 tuần qua (get_stock_foreign_flow_history). Viết một báo cáo tóm tắt 300 chữ đề xuất mã có tiềm năng nhất."
Kịch bản 3: Phân tích liên thị trường
Khả năng đáng sợ nhất của Claude là xử lý đồng thời Cổ phiếu, Vàng và Tiền tệ.
Prompt: "Hãy truy xuất tỷ giá USD/VND (get_forex_quote) và giá Vàng SJC (get_dealer_product_quote) lúc này. Nếu tỷ giá đang căng thẳng, hãy kiểm tra sổ lệnh (get_stock_order_book) của mã HPG xem lực bán chủ động có đang tăng không. Đưa ra nhận định về tâm lý dòng tiền thị trường trong ngắn hạn."
7. bảo mật khi kết nối Finhay MCP với Claude AI
Rất nhiều nhà đầu tư chần chừ chưa kết nối Finhay MCP với Claude AI vì e ngại các rủi ro liên quan đến rò rỉ dữ liệu cá nhân. Tuy nhiên, kiến trúc của hệ thống này được thiết kế theo tiêu chuẩn an ninh cấp độ tổ chức.
- Zero Data Retention (Không lưu trữ dữ liệu vĩnh viễn) Khi Claude gọi API của Finhay để lấy số dư tài khoản của bạn, gói dữ liệu này được mã hóa và truyền thẳng vào bộ nhớ tạm (Context Window) của phiên chat hiện tại. Theo cam kết của Anthropic và FHSC, dữ liệu định danh và tài sản của bạn KHÔNG ĐƯỢC lưu trữ vào cơ sở dữ liệu vĩnh viễn và TUYỆT ĐỐI KHÔNG được sử dụng để huấn luyện (train) mô hình AI của họ trong tương lai.
- Ủy quyền OAuth minh bạch Quá trình kết nối Finhay MCP với Claude AI không bao giờ yêu cầu bạn nhập Mật khẩu hay mã PIN chứng khoán vào khung chat của Claude. Việc xác thực được thực hiện qua giao thức OAuth trên hệ thống của FHSC. Finhay sẽ cấp cho Claude một "chìa khóa ảo" (Token) với các quyền hạn bị giới hạn nghiêm ngặt.
- Quyền lực kiểm soát thuộc về bạn Nếu bạn cảm thấy không an toàn hoặc không muốn tiếp tục sử dụng, bạn có thể ngắt kết nối (Revoke) chìa khóa ảo này bất kỳ lúc nào trực tiếp trên giao diện của Claude hoặc ngay trong ứng dụng quản lý của Finhay. Khi đó, Claude sẽ ngay lập tức mất toàn bộ khả năng truy cập vào dữ liệu tài chính của bạn.
8. Xử lý các lỗi thường gặp (Troubleshooting) khi cài đặt Finhay MCP trên Claude
Trong quá trình thực hiện hướng dẫn sử dụng Finhay MCP, bạn có thể gặp một vài gián đoạn nhỏ. Dưới đây là cách khắc phục nhanh chóng:
- Lỗi "Connector URL Invalid" khi cài đặt bản Custom: Xảy ra khi bạn nhập sai đường dẫn. Hãy chắc chắn rằng bạn copy chính xác chuỗi https://mcp-trading.fhsc.com.vn/mcp và không để thừa khoảng trắng ở đầu hoặc cuối.
- Lỗi AI báo "Không tìm thấy dữ liệu danh mục": Lỗi này thường do trong quá trình xác thực đăng nhập qua mã QR, bạn đã quên tích chọn quyền "Xem danh mục, số dư, lãi/lỗ". Cách khắc phục: Ngắt kết nối Connector hiện tại và thực hiện lại Bước 3 (Xác thực và Phân quyền).
- Lỗi phiên làm việc hết hạn: vÌ lý do bảo mật, chìa khóa kết nối giữa Claude và Finhay có thể tự động hết hạn sau một khoảng thời gian nhất định để bảo vệ tài khoản. Bạn chỉ cần nhấn Connect và xác thực lại trên điện thoại.
Kết luận
Chỉ với 2 phút thiết lập nhanh chóng qua kho ứng dụng chính thức, bạn không chỉ tiết kiệm hàng giờ đồng hồ tra cứu số liệu thủ công mỗi ngày, mà còn chính thức sở hữu một trợ lý đắc lực luôn thấu hiểu từng nhịp đập của thị trường lẫn tình trạng danh mục của riêng bạn.
Dù bạn là một nhà đầu tư F0 đang làm quen với thị trường hay một Quant Trader sành sỏi, việc trang bị Finhay MCP chính là bước đệm vững chắc nhất để tối ưu hóa lợi nhuận, quản trị rủi ro hiệu quả và đầu tư thảnh thơi hơn trong kỷ nguyên tài chính số 2026. Hãy mở ứng dụng Claude và thiết lập kết nối ngay hôm nay để tự mình trải nghiệm quyền năng vô hạn của dữ liệu thời gian thực!
⚠️ Tuyên bố miễn trừ trách nhiệm: Bài viết cung cấp thông tin cập nhật về xu hướng công nghệ tài chính. Dữ liệu truy xuất từ các công cụ AI mang tính chất tham khảo, không cấu thành lời khuyên đầu tư. Nhà đầu tư tự chịu trách nhiệm về quyết định và an toàn bảo mật thiết bị cá nhân.
FAQs
Việc sử dụng cổng API dữ liệu chứng khoán (Finhay MCP) hiện tại là miễn phí đối với các khách hàng đã mở tài khoản tại Công ty Chứng khoán Finhay (FHSC). Tuy nhiên, bạn cần lưu ý rằng để sử dụng tính năng Connectors/Directory của Claude một cách mượt mà nhất, bạn có thể phải trả phí thuê bao gói Claude Pro.
Hoàn toàn KHÔNG. Phiên bản phân phối chính thức trên kho ứng dụng (Directory) của Claude bị khóa chặt ở chế độ Read-only. Hệ thống API của Finhay không cung cấp bất kỳ hàm chức năng nào cho phép thực thi lệnh từ luồng ứng dụng này. Tài sản của bạn an toàn trước mọi thao tác của AI.
Dữ liệu thị trường (Cổ phiếu, Hàng hóa, Vàng, Crypto, Vĩ mô) được cung cấp thông qua Finhay MCP là dữ liệu trực tiếp (real-time) hoặc có độ trễ cực thấp theo đúng quy định của Sở giao dịch và các nhà cung cấp dữ liệu đối tác của FHSC, đảm bảo AI Agent phân tích danh mục của bạn luôn bám sát nhịp đập thị trường.
Finhay
15-10-2026
