---
title: "FinLens MCP: Phân tích chứng khoán Việt Nam bằng AI"
description: "Tổng quan FinLens MCP: cách kết nối Claude và ChatGPT với dữ liệu tài chính Việt Nam, cùng 18 bài hướng dẫn phân tích cổ phiếu bằng AI theo chủ đề."
summary: "FinLens MCP là máy chủ Model Context Protocol cho phép Claude, ChatGPT và Gemini truy vấn dữ liệu tài chính Việt Nam: giá cổ phiếu HOSE/HNX/UPCOM, báo cáo tài chính, dòng tiền khối ngoại, báo cáo phân tích của hơn 20 công ty chứng khoán, kinh tế vĩ mô, cổ tức, chứng quyền, trái phiếu doanh nghiệp và quỹ đầu tư. Nhà đầu tư đăng ký gói FinLens Pro hoặc Premium tại finlens.vn/pricing, thêm địa chỉ https://mcp.finlens.vn/mcp vào trợ lý AI rồi hỏi bằng tiếng Việt, ví dụ \"Phân tích tài chính HPG 5 năm gần nhất\". Bộ tài liệu FinLens MCP gồm 18 bài hướng dẫn theo chủ đề, từ kết nối ban đầu tới backtest chiến lược và tối ưu danh mục."
product: mcp
keywords: ["finlens mcp","MCP chứng khoán Việt Nam","dữ liệu tài chính Việt Nam","mcp kết nối thị trường chứng khoán Việt Nam","phân tích chứng khoán bằng AI","kết nối Claude với dữ liệu chứng khoán","ChatGPT phân tích cổ phiếu Việt Nam","Model Context Protocol chứng khoán","công cụ AI cho nhà đầu tư chứng khoán","hướng dẫn sử dụng FinLens MCP"]
url: https://docs.finlens.vn/mcp
source: docs.finlens.vn
---



FinLens MCP nối trợ lý AI của bạn với dữ liệu chứng khoán Việt Nam theo thời gian
thực. Bạn hỏi bằng tiếng Việt thông thường, AI tự chọn công cụ và trả về số liệu
thật — không phải phỏng đoán từ trí nhớ huấn luyện.

## Bắt đầu trong 3 bước [#bắt-đầu-trong-3-bước]

<Steps>
  <Step>
    ### Đăng ký gói Pro hoặc Premium [#đăng-ký-gói-pro-hoặc-premium]

    Chọn gói tại [finlens.vn/pricing](https://finlens.vn/pricing). Gói Free không kết
    nối được MCP.
  </Step>

  <Step>
    ### Thêm vào Claude hoặc ChatGPT [#thêm-vào-claude-hoặc-chatgpt]

    Dán URL `https://mcp.finlens.vn/mcp` vào phần connector, rồi đăng nhập FinLens để
    xác thực. Mất khoảng 2 phút — [xem hướng dẫn từng bước](/mcp/bat-dau).
  </Step>

  <Step>
    ### Hỏi thử [#hỏi-thử]

    *"Phân tích tài chính HPG 5 năm gần nhất"* — nếu AI trả về số liệu thật là đã kết
    nối xong.
  </Step>
</Steps>

<Cards>
  <Card title="Cẩm nang 107 công cụ" href="/mcp/cam-nang-cong-cu">
    Tra cứu toàn bộ công cụ theo 12 nhóm, kèm tham số và câu hỏi mẫu.
  </Card>

  <Card title="Kết nối FinLens MCP" href="/mcp/bat-dau">
    Thêm vào Claude Desktop, Claude.ai hoặc ChatGPT qua OAuth.
  </Card>
</Cards>

## 18 bài hướng dẫn theo chủ đề [#18-bài-hướng-dẫn-theo-chủ-đề]

### Phân tích doanh nghiệp [#phân-tích-doanh-nghiệp]

<Cards>
  <Card title="Phân tích cơ bản" href="/mcp/phan-tich-co-ban">
    7 nhóm KPI, báo cáo tài chính TTM, phân rã DuPont, so sánh cùng ngành.
  </Card>

  <Card title="Doanh nghiệp phi tài chính" href="/mcp/cong-ty-thuong">
    Thuyết minh BCTC, cơ cấu chi phí và nợ vay, định giá DCF theo kịch bản.
  </Card>

  <Card title="Cổ phiếu ngân hàng" href="/mcp/ngan-hang">
    NPL, CASA, NII và CIR — bộ chỉ tiêu riêng cho ngành ngân hàng.
  </Card>

  <Card title="Cổ phiếu công ty chứng khoán" href="/mcp/chung-khoan">
    Danh mục tự doanh, dư nợ margin và chỉ báo tâm lý thị trường.
  </Card>
</Cards>

### Dòng tiền & thị trường [#dòng-tiền--thị-trường]

<Cards>
  <Card title="Dòng tiền" href="/mcp/dong-tien">
    Smart money, khối ngoại và dòng tiền chủ động theo từng mã, từng ngành.
  </Card>

  <Card title="Sức mạnh ngành" href="/mcp/suc-manh-nganh">
    Xếp hạng RS ngành 1–100, độ rộng thị trường, lọc cổ phiếu dẫn dắt.
  </Card>

  <Card title="Diễn biến trong phiên" href="/mcp/phien-truc-tiep">
    Thị trường hôm nay, cung cầu theo bước giá, điểm lại phiên giao dịch.
  </Card>

  <Card title="Tin tức đã phân tích" href="/mcp/tin-tuc-ai">
    Tin được AI tóm tắt, gắn sentiment và trọng số liên quan theo mã.
  </Card>
</Cards>

### Công cụ đầu tư [#công-cụ-đầu-tư]

<Cards>
  <Card title="Kỹ thuật & Backtest" href="/mcp/ky-thuat-backtest">
    141 chỉ báo, quét tín hiệu 1.700 mã, backtest và tối ưu tham số.
  </Card>

  <Card title="Danh mục đầu tư" href="/mcp/danh-muc">
    Max Sharpe, HRP, VaR, đường biên hiệu quả và backtest tái cân bằng.
  </Card>

  <Card title="Chứng quyền có bảo đảm" href="/mcp/chung-quyen">
    Định giá Black-Scholes, điểm hòa vốn, đòn bẩy, so sánh CW cùng mã cơ sở.
  </Card>

  <Card title="Cổ tức" href="/mcp/co-tuc">
    Lịch GDKHQ sắp tới, lịch sử chi trả và phân tích chính sách cổ tức.
  </Card>

  <Card title="Quỹ đầu tư" href="/mcp/quy-dau-tu">
    185 quỹ: danh mục nắm giữ, NAV, và quỹ nào đang gom hay xả một mã.
  </Card>

  <Card title="Trái phiếu doanh nghiệp" href="/mcp/trai-phieu">
    Lịch đáo hạn, dư nợ theo ngành, hồ sơ phát hành và trái phiếu chuyển đổi.
  </Card>
</Cards>

### Nguồn tham khảo & kỹ thuật nâng cao [#nguồn-tham-khảo--kỹ-thuật-nâng-cao]

<Cards>
  <Card title="Báo cáo công ty chứng khoán" href="/mcp/bao-cao-ctck">
    Báo cáo từ hơn 20 công ty chứng khoán và đồng thuận giá mục tiêu.
  </Card>

  <Card title="Kinh tế vĩ mô" href="/mcp/vi-mo">
    GDP, CPI, tỷ giá, lãi suất, xuất nhập khẩu — và cầu nối vĩ mô sang cổ phiếu.
  </Card>

  <Card title="Chia nhỏ prompt" href="/mcp/nang-cao">
    Bắc cầu nhiều công cụ, soi một cổ phiếu qua 6 lăng kính khác nhau.
  </Card>
</Cards>

## Công cụ MCP theo chủ đề [#công-cụ-mcp-theo-chủ-đề]

Bảng tra nhanh khi bạn muốn biết AI sẽ gọi công cụ nào cho câu hỏi của mình.

| Chủ đề                     | Công cụ chính                                                                                                              |
| -------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| Hồ sơ & giá cổ phiếu       | `stocks_search`, `stocks_get_profile`, `stocks_get_latest_quote`                                                           |
| Tài chính cơ bản           | `fundamental_get_key_metrics`, `fundamental_dupont`, `fundamental_compare_peers`, `fundamental_quality_scan`               |
| Doanh nghiệp phi tài chính | `fundamental_cost_structure`, `fundamental_debt_structure`, `fundamental_valuation_history`, `fundamental_intrinsic_value` |
| Ngân hàng                  | `fundamental_bank_asset_quality`, `fundamental_bank_funding`, `fundamental_bank_income`                                    |
| Công ty chứng khoán        | `fundamental_securities_portfolio`, `fundamental_securities_income`, `fundamental_securities_market_sentiment`             |
| Dòng tiền                  | `flows_get_stock_flow`, `flows_sector_flow`, `flows_top_net`                                                               |
| Ngành & phiên giao dịch    | `market_sector_strength`, `market_today`, `stocks_supply_demand`                                                           |
| Kỹ thuật & backtest        | `signals_screen`, `signals_backtest`, `signals_optimize`, `signals_candle_patterns`                                        |
| Danh mục đầu tư            | `portfolio_optimize`, `portfolio_backtest`, `portfolio_analyze`, `portfolio_efficient_frontier`                            |
| Chứng quyền                | `warrants_search`, `warrants_get_info`, `warrants_price_history`, `warrants_compare`                                       |
| Cổ tức                     | `dividends_upcoming`, `dividends_get_history`, `dividends_analyze_policy`                                                  |
| Quỹ đầu tư                 | `fund_stock_ownership`, `fund_holdings`, `fund_rank`                                                                       |
| Trái phiếu doanh nghiệp    | `bond_search`, `bond_maturity_wall`, `bond_sector_debt`, `bond_issuer_profile`                                             |
| Báo cáo phân tích          | `research_list_reports`, `research_read_report`, `research_get_analyst_consensus`                                          |
| Vĩ mô & xuất nhập khẩu     | `fin_dashboard`, `fin_macro_context`, `fin_relate`, `fin_trade_matrix`                                                     |
| Tin tức                    | `news_market_brief`, `news_get_for_stock`, `news_search`                                                                   |

<Callout title="Quy ước đơn vị giá">
  Giá cổ phiếu và chỉ số trả về ở đơn vị **nghìn đồng** (23.4 nghĩa là 23.400 VND),
  còn giá chứng quyền ở **đồng** nguyên. Phải quy đổi trước khi so sánh hai loại với
  nhau — chi tiết tại [Quy ước dữ liệu FinLens](/platform).
</Callout>


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

### Có MCP server nào cho thị trường chứng khoán Việt Nam không?

Có. FinLens MCP là máy chủ Model Context Protocol phục vụ riêng thị trường Việt Nam, địa chỉ https://mcp.finlens.vn/mcp. Sau khi thêm vào Claude, ChatGPT hoặc Gemini, trợ lý AI truy vấn được hơn 1.700 cổ phiếu trên HOSE, HNX và UPCOM cùng chỉ số VNINDEX, VN30, HNX-Index, kèm báo cáo tài chính, dòng tiền khối ngoại, trái phiếu doanh nghiệp và số liệu kinh tế vĩ mô. Câu hỏi đặt bằng tiếng Việt tự nhiên, không cần biết lập trình.

### Làm sao để Claude hoặc ChatGPT đọc được dữ liệu tài chính Việt Nam?

Trợ lý AI không có sẵn dữ liệu thị trường Việt Nam và cũng không cập nhật theo thời gian thực, nên cần nối qua một MCP server. Cách làm là thêm địa chỉ https://mcp.finlens.vn/mcp vào phần connector của Claude Desktop, Claude.ai hoặc ChatGPT rồi đăng nhập bằng tài khoản FinLens qua OAuth, mất khoảng hai phút. Từ đó AI tự gọi công cụ để lấy số liệu thật thay vì phỏng đoán từ trí nhớ huấn luyện, và mỗi câu trả lời đều dựa trên dữ liệu có ngày tháng rõ ràng.

### FinLens MCP là gì?

FinLens MCP là máy chủ MCP giúp trợ lý AI như Claude và ChatGPT truy vấn trực tiếp dữ liệu chứng khoán Việt Nam. Sau khi kết nối, AI gọi được các công cụ như flows_get_stock_flow (dòng tiền cổ phiếu), signals_screen (quét tín hiệu kỹ thuật), portfolio_optimize (tối ưu danh mục) hay news_market_brief (điểm tin thị trường) để trả lời câu hỏi bằng tiếng Việt. Địa chỉ máy chủ là https://mcp.finlens.vn/mcp.

### Cách kết nối FinLens MCP với Claude và ChatGPT?

Kết nối FinLens MCP gồm ba bước: đăng ký gói FinLens Pro hoặc Premium tại finlens.vn/pricing, thêm địa chỉ https://mcp.finlens.vn/mcp vào Claude Desktop, Claude.ai hoặc ChatGPT, rồi đặt câu hỏi đầu tiên. Câu hỏi thử nghiệm gợi ý là "Phân tích tài chính HPG 5 năm gần nhất". Hướng dẫn từng bước kèm phần kiểm tra kết nối nằm ở bài Kết nối FinLens MCP với Claude AI & ChatGPT tại /mcp/bat-dau.

### FinLens MCP phân tích được những gì?

FinLens MCP bao phủ các nhóm phân tích chính của thị trường Việt Nam: tài chính cơ bản (báo cáo tài chính, DuPont, so sánh cùng ngành), dòng tiền khối ngoại và smart money qua flows_get_stock_flow và flows_sector_flow, phân tích kỹ thuật với 141 chỉ báo cùng backtest qua signals_screen và signals_backtest, tối ưu danh mục qua portfolio_optimize, báo cáo phân tích từ hơn 20 công ty chứng khoán qua research_list_reports, kinh tế vĩ mô qua fin_dashboard, cổ tức qua dividends_upcoming, chứng quyền có bảo đảm qua warrants_compare, trái phiếu doanh nghiệp qua bond_maturity_wall và 185 quỹ đầu tư qua fund_stock_ownership. Diễn biến trong phiên và tin tức đã được AI đọc sẵn nằm ở market_today và news_market_brief.

### Nên đọc bài hướng dẫn FinLens MCP nào trước?

Bộ tài liệu FinLens MCP có 18 bài hướng dẫn xếp từ cơ bản đến nâng cao, mỗi bài tập trung vào một nhóm công cụ. Nhà đầu tư mới nên đọc bài 1 về cách kết nối tại /mcp/bat-dau, sau đó là bài phân tích cơ bản tại /mcp/phan-tich-co-ban và bài dòng tiền tại /mcp/dong-tien. Người cần tra cứu nhanh toàn bộ công cụ có thể xem cẩm nang công cụ tại /mcp/cam-nang-cong-cu.