# Finhay MCP

Finhay MCP là MCP server chính thức của Công ty Cổ phần Chứng khoán Finhay (FHSC). Finhay MCP cho phép ChatGPT, Claude và các AI agent hỗ trợ Model Context Protocol đọc dữ liệu thị trường và dữ liệu tài khoản FHSC của người dùng (danh mục, số dư, lãi/lỗ), sau khi người dùng đăng nhập và cấp quyền. Kết nối chỉ đọc dữ liệu, không đặt lệnh giao dịch. Hiện miễn phí.

FHSC là công ty chứng khoán tiên phong đưa dữ liệu chứng khoán Việt Nam vào trợ lý AI qua Model Context Protocol. Finhay MCP ra mắt ngày 15/04/2026 và có mặt trên kho ứng dụng chính thức của Claude (https://claude.ai/directory/finhay) và ChatGPT (https://chatgpt.com/plugins/plugin_asdk_app_6a46090f77a081918284e319f625069f).

Ra mắt: 2026-04-15 · Cập nhật: 2026-09-26 · Nguồn: https://fhsc.com.vn/finhay-mcp

## Vì sao cần Finhay MCP

Search chỉ thấy thông tin công khai trên internet. Danh mục, số dư và lãi/lỗ trong tài khoản FHSC không có trên đó. Finhay MCP cho trợ lý AI đọc các dữ liệu này trực tiếp từ hệ thống FHSC, trong phạm vi người dùng cho phép, thay vì người dùng phải tự chép, dán hoặc chụp màn hình.

## Quyền và dữ liệu

- Chỉ đọc: kết nối qua kho ứng dụng không thể đặt lệnh giao dịch.
- Chỉ chia sẻ khi người dùng đồng ý: đăng nhập tài khoản FHSC và xem từng quyền trước khi cho phép.
- Thu hồi bất cứ lúc nào: ngắt kết nối Finhay trong ứng dụng AI.
- Giao dịch qua MCP dùng phiên bản trading riêng; mọi lệnh phải được người dùng xác thực theo phương thức của FHSC.

## Kết nối

### AI agent và MCP client

- Địa chỉ máy chủ: `https://mcp.fhsc.com.vn/mcp`
- Giao thức: Streamable HTTP
- Xác thực: OAuth (đăng nhập tài khoản FHSC)

Lời nhắc gửi cho agent:

> Thêm MCP server Finhay tại https://mcp.fhsc.com.vn/mcp (Streamable HTTP, xác thực OAuth). Sau khi thêm, mở trang đăng nhập để tôi đăng nhập tài khoản FHSC và cấp quyền. Chỉ dùng để đọc dữ liệu thị trường và danh mục; không tạo yêu cầu giao dịch.

### Claude

Listing: https://claude.ai/directory/finhay

1. Mở Connector: Customize → Connectors
2. Thêm mới Connector: Browse connectors → tìm Finhay → Connect
3. Xác thực kết nối: Đăng nhập tài khoản FHSC → Phân quyền sử dụng

### ChatGPT

Listing: https://chatgpt.com/plugins/plugin_asdk_app_6a46090f77a081918284e319f625069f

1. Kết nối Finhay: Apps → tìm Finhay → Connect → Sign in with Finhay
2. Xác thực kết nối: Đăng nhập tài khoản FHSC → Phân quyền sử dụng

## Danh mục công cụ

65 công cụ, 12 nhóm.

### Cổ phiếu (finhay-market)

- `get_stocks_catalog`: Danh mục cổ phiếu
- `get_stock_quote`: Giá realtime
- `get_stock_order_book`: Lấy sổ lệnh hiện tại của một cổ phiếu, độ sâu bên mua (Bid) và bên bán (Ask) đang chờ trên thị trường
- `get_stock_history`: Lịch sử giá
- `get_stock_profile`: Hồ sơ doanh nghiệp
- `get_stock_listing`: Thông tin niêm yết
- `get_stock_ownership`: Cơ cấu sở hữu
- `get_stock_foreign_room`: Room ngoại hiện tại
- `get_stock_foreign_room_history`: Lịch sử room ngoại
- `get_stock_technicals`: Chỉ báo kỹ thuật
- `get_stock_trading`: Thanh khoản/giao dịch phiên
- `get_stock_trading_history`: Lịch sử thanh khoản
- `get_stock_foreign_flow`: Dòng tiền khối ngoại
- `get_stock_foreign_flow_history`: Lịch sử dòng tiền ngoại
- `get_stock_proprietary_flow`: Dòng tiền tự doanh
- `get_stock_proprietary_flow_history`: Lịch sử dòng tiền tự doanh
- `get_stock_active_order_stats`: Thống kê lệnh chủ động
- `get_stock_active_order_stats_history`: Lịch sử lệnh chủ động
- `get_company_overview`: Tổng quan tài chính
- `get_financial_analysis`: Phân tích tài chính
- `get_financial_statement`: Báo cáo tài chính
- `screen_stocks`: Sàng lọc cổ phiếu
- `get_recommendation_reports`: Báo cáo khuyến nghị
- `get_market_session`: Trạng thái phiên HOSE/HNX/UPCOM

### Chỉ số (finhay-market)

- `get_indices_catalog`: Danh mục chỉ số
- `get_index_quote`: Giá/chỉ số hiện tại
- `get_index_history`: Lịch sử chỉ số

### Forex (finhay-market)

- `get_forex_catalog`: Danh mục Forex
- `get_forex_quote`: Tỷ giá hiện tại
- `get_forex_history`: Lịch sử tỷ giá

### Crypto (finhay-market)

- `get_cryptos_catalog`: Danh mục crypto
- `get_crypto_quote`: Giá crypto hiện tại
- `get_crypto_history`: Lịch sử giá crypto

### Hàng hóa (finhay-market)

- `get_commodities_catalog`: Danh mục hàng hóa
- `get_commodity_quote`: Giá hàng hóa hiện tại
- `get_commodity_history`: Lịch sử giá hàng hóa
- `get_dealer_products`: Danh mục sản phẩm dealer
- `get_dealer_product_quote`: Giá sản phẩm dealer
- `get_dealer_product_history`: Lịch sử giá dealer

### Quỹ mở (finhay-market)

- `get_funds_catalog`: Danh mục quỹ
- `get_fund_quote`: Giá quỹ hiện tại
- `get_fund_history`: Lịch sử giá quỹ

### Trái phiếu (finhay-market)

- `get_bonds_catalog`: Danh mục trái phiếu
- `get_bond_quote`: Giá trái phiếu
- `get_bond_order_book`: Sổ lệnh trái phiếu
- `get_bond_history`: Lịch sử trái phiếu

### ETF (finhay-market)

- `get_etfs_catalog`: Danh mục ETF
- `get_etf_quote`: Giá ETF hiện tại
- `get_etf_order_book`: Sổ lệnh ETF
- `get_etf_history`: Lịch sử ETF

### Tin tức (finhay-market)

- `list_news`: Danh sách tin tức
- `get_news_detail`: Chi tiết tin tức
- `list_calendar_events`: Lịch sự kiện kinh tế

### Vĩ mô (finhay-market)

- `get_bank_interest_rates`: Lãi suất ngân hàng
- `list_macro_indicators`: Danh mục chỉ tiêu vĩ mô
- `get_macro_indicator`: Dữ liệu chỉ tiêu vĩ mô

### Tài khoản (finhay-portfolio)

- `get_account_summary`: Xem số dư, margin, dư nợ của 1 tiểu khoản
- `get_portfolio_positions`: Danh mục đang nắm giữ
- `get_order_history`: Lịch sử/sổ lệnh
- `get_order_detail`: Chi tiết lệnh
- `get_asset_summary`: Tổng quan tài sản
- `get_pnl_today`: Lãi/lỗ trong ngày
- `get_user_rights`: Quyền cổ đông
- `get_my_profile`: Thông tin tài khoản

### Workflow (finhay-core)

- `get_workflow_guide`: Hướng dẫn các workflow chuẩn

## Câu hỏi thường gặp

### AI đã tự search được, sao còn cần Finhay MCP?

Search chỉ thấy thông tin công khai trên internet. Danh mục, số dư và lãi/lỗ trong tài khoản FHSC của bạn không có trên đó. Finhay MCP cho phép trợ lý AI đọc các dữ liệu này trực tiếp từ hệ thống FHSC, trong phạm vi bạn cho phép, thay vì bạn phải tự chép, dán hoặc chụp màn hình.

### Finhay MCP có mất phí không?

Finhay MCP phát hành chính thức từ ngày 15/04/2026 và hiện miễn phí. Bạn chỉ cần tài khoản FHSC. Phí gói dịch vụ AI và phí giao dịch, nếu có, được tính riêng. Chính sách miễn phí hiện tại không phải cam kết miễn phí vĩnh viễn.

### AI có tự mua bán chứng khoán được không?

Không. Kết nối đọc dữ liệu không thực hiện giao dịch. Với phiên bản trading riêng, mọi lệnh phải được bạn xác thực theo phương thức hợp lệ của FHSC. [Xem điều khoản giao dịch qua MCP](https://fhsc.com.vn/dieu-khoan-finhay-mcp).

### Dữ liệu của tôi được chia sẻ tới đâu, và có dừng được không?

Khi bạn đồng ý kết nối, dữ liệu trong phạm vi được cấp có thể được chuyển tới ứng dụng AI và các hệ thống bên thứ ba mà ứng dụng đó sử dụng. Bạn có thể thu hồi quyền bất cứ lúc nào bằng cách ngắt kết nối Finhay trong ứng dụng AI. Việc thu hồi không xóa các lần chia sẻ đã diễn ra trước đó. [Đọc mục bảo vệ dữ liệu cá nhân](https://fhsc.com.vn/dieu-khoan-finhay-mcp).

### Tôi có cần biết lập trình không?

Không. Bạn chỉ cần tài khoản FHSC và một ứng dụng AI hỗ trợ MCP, rồi làm theo hướng dẫn kết nối ở trên.

### Kết nối bị lỗi hoặc hết hạn thì làm gì?

Ngắt kết nối Finhay trong ứng dụng AI rồi kết nối lại, đăng nhập tài khoản FHSC và cấp quyền. Nếu vẫn lỗi, hãy [gửi yêu cầu hỗ trợ](https://fhsc.com.vn/lien-he-finhay) kèm tên ứng dụng, thời điểm và thông báo lỗi. Không gửi mật khẩu, mã OTP hoặc token truy cập.

## Lưu ý

Thông tin trên trang và kết quả từ ứng dụng AI chỉ mang tính tham khảo, không phải khuyến nghị đầu tư của FHSC. Bạn cần tự kiểm tra và quyết định trước khi giao dịch.