VNINDEX · VN30 · VN100 · HNX · HNX30 · UPCOM · VNDIAMOND · VNFINLEAD · VNFINSELECT · VNMIDCAP · VNSML · VN50 · VNSI · VNDIVIDEND · VNENERGY · VNHEAL · VNIND · VNIT · VNMAT · VNREAL · VNUTI · VNCONS · HPG · FPT · VCB · VHM · VIC · MWG · MBB · ACB · TCB · BID · CTG · GAS · SSI · VNM · HSG · STB · GVR · MSN · CHPG2608 · CFPT2607 · CMWG2611 · CVPB2609 · CSTB2610 · CACB2612 · GOLD · BRENT · SP500 · NASDAQ · DXY · US10Y · USDVND · CPI · GDP · IIP · PMI · FDI · VNIBOR · T-BILL · BÁN LẺ · VNINDEX · VN30 · VN100 · HNX · HNX30 · UPCOM · VNDIAMOND · VNFINLEAD · VNFINSELECT · VNMIDCAP · VNSML · VN50 · VNSI · VNDIVIDEND · VNENERGY · VNHEAL · VNIND · VNIT · VNMAT · VNREAL · VNUTI · VNCONS · HPG · FPT · VCB · VHM · VIC · MWG · MBB · ACB · TCB · BID · CTG · GAS · SSI · VNM · HSG · STB · GVR · MSN · CHPG2608 · CFPT2607 · CMWG2611 · CVPB2609 · CSTB2610 · CACB2612 · GOLD · BRENT · SP500 · NASDAQ · DXY · US10Y · USDVND · CPI · GDP · IIP · PMI · FDI · VNIBOR · T-BILL · BÁN LẺ ·
đang hoạt động · v2.1.0

MCP giao dịch chứng khoán — đặt lệnh DNSE, SSI, TCBS ngay trong Claude

Giao dịch chứng khoán ngay trong Claude — đặt lệnh, xem số dư, soi danh mục DNSE · SSI · TCBS.
Bridge chạy trên máy bạn: khoá CTCK không rời máy, không qua server Algolab.

npx -y github:algolabx/mcp-trading link

Chạy trong terminal (cần Node.js 18+). Mã nguồn mở: github.com/algolabx/mcp-trading · dữ liệu thị trường để phân tích thì thêm MCP Dữ liệu.

Kết nối

3 bước, 5 phút — khoá gõ trong terminal, không dán vào chat.

  1. 1
    Liên kết CTCK — mở terminal, chạy dòng của CTCK bạn dùng. Bridge hỏi khoá API (ẩn phím), kiểm tra với CTCK rồi lưu vào máy bạn.
    npx -y github:algolabx/mcp-trading link dnse   # API Key + Secret (LightSpeed OpenAPI) + email OTP
    npx -y github:algolabx/mcp-trading link ssi    # ConsumerID + Secret + số tiểu khoản
    npx -y github:algolabx/mcp-trading link tcbs   # API Key iFlash — tiểu khoản tự phát hiện
    
    npx -y github:algolabx/mcp-trading status      # đã liên kết gì (không in khoá)
  2. 2
    Khai báo bridge với Claude — chọn 1 trong 2 (copy là chạy):

    Claude Code terminal

    claude mcp add --scope user mcp-trading -- \
      npx -y -p github:algolabx/mcp-trading mcp-trading-server

    Gõ /mcp để kiểm tra — thấy mcp-trading là xong.

    Claude Desktop claude_desktop_config.json

    {
      "mcpServers": {
        "mcp-trading": {
          "command": "npx",
          "args": ["-y", "-p", "github:algolabx/mcp-trading", "mcp-trading-server"]
        }
      }
    }

    Config chỉ nạp lúc khởi động — lưu xong phải Quit và mở lại Claude Desktop.

  3. 3Xong! Mở cuộc trò chuyện mới, hỏi “trạng thái bridge?” rồi “xem số dư và danh mục DNSE”. Muốn Claude phân tích luôn danh mục? Thêm MCP Dữ liệu — Claude đọc mã bạn đang nắm rồi tra định giá, tín hiệu, tin tức từng mã.

Bạn có thể nói gì với Claude

Xem số dư và danh mục DNSE

Tiền khả dụng, tổng tài sản, mã đang nắm và khối lượng. DNSE đọc tài khoản không cần OTP.

Danh mục tôi đang lời lỗ thế nào?

Claude ghép giá vốn trong tài khoản với giá realtime từ MCP Dữ liệu → lãi/lỗ từng mã và cả danh mục.

Đánh giá các mã tôi đang nắm

Với MCP Dữ liệu: định giá P/E · P/B, tín hiệu RS/MACD, tin tức, giá mục tiêu CTCK của từng mã → mã nào nên giữ, mã nào nên cơ cấu.

Tôi muốn đặt lệnh

Claude xin OTP (email / Smart OTP / iOTP) để mở phiên giao dịch 8 giờ — chỉ khi bạn muốn giao dịch.

Bán 100 GEL giá 30.000

Claude đưa bản xem trước (mã, chiều, khối lượng, giá, giá trị) — chưa gửi gì. Bạn nói “đặt đi” thì lệnh mới đi.

Sổ lệnh hôm nay · Huỷ lệnh vừa đặt

Xem lệnh chờ khớp / đã khớp; huỷ cũng phải xác nhận 2 bước như đặt.

9 công cụ của bridge

bridge_status

CTCK nào đã liên kết trên máy này, phiên giao dịch nào còn hạn. Không bao giờ in khoá.

get_broker_accounts

Danh sách tiểu khoản tại CTCK (SSI/TCBS hỏi thẳng CTCK để trả đúng số).

get_broker_balance

Tiền mặt, sức mua, tổng tài sản.

get_broker_positions

Danh mục đang nắm: mã, khối lượng, giá vốn.

get_broker_orders

Sổ lệnh trong ngày: chờ khớp, đã khớp, đã huỷ.

request_broker_otp

Nhờ CTCK gửi OTP (DNSE: email) hoặc hướng dẫn lấy Smart OTP / iOTP trong app.

submit_broker_otp

Nộp OTP để mở phiên giao dịch: DNSE trading token 8h · SSI access + refresh · TCBS JWT 8h.

place_broker_order

Đặt lệnh thật — 2 bước: xem trước (chưa gửi gì) → bạn xác nhận → confirm=true lệnh mới đi.

cancel_broker_order

Huỷ lệnh — cũng 2 bước xác nhận như đặt.

CTCK hỗ trợ

DNSE

Khoá: LightSpeed API Key + Secret (webtrading → Thông tin cá nhân → LightSpeed API, lớp 2 chọn Email OTP). Đọc tài khoản không cần OTP; đặt lệnh mở bằng Smart OTP hoặc OTP email.

SSI

Khoá: ConsumerID + Secret + số tiểu khoản (iBoard → Dịch vụ API). OTP 1 lần cho cả đọc lẫn lệnh, sau đó tự gia hạn. Lệnh ký bằng keypair sinh trên máy bạn — dán public key vào iBoard một lần.

TCBS

Khoá: API Key iFlash (app TCInvest → iFlash Open API). iOTP trong app mở phiên 8h; tiểu khoản tự phát hiện.

An toàn

  1. 1Khoá không rời máy bạn. Lưu tại ~/.algolab/mcp-broker.json quyền 600; không tool nào nhận hay trả khoá — kênh duy nhất đưa khoá vào là lệnh link trong terminal.
  2. 2Lệnh tiền luôn 2 bước. Bản xem trước dựng local (chưa chạm mạng) → bạn xác nhận → mới gửi CTCK. Chưa mở OTP thì bridge chặn ngay.
  3. 3Tự kiểm chứng. Bridge chỉ nói chuyện với CTCK, không gọi về Algolab: npx -y github:algolabx/mcp-trading verify quét mọi địa chỉ mạng trong mã đang chạy; mã nguồn mở để tự đọc.
  4. 4Thu hồi 1 lệnh. npx -y github:algolabx/mcp-trading unlink dnse xoá khỏi máy; thu hồi khoá tại CTCK thì chết toàn cục. Khoá API CTCK không rút được tiền.