Tổng quan SePay MCP: kết nối ứng dụng AI với SePay

SePay MCP (Model Context Protocol) cho Claude, ChatGPT, Codex đọc giao dịch, tài khoản ngân hàng, webhook và tài liệu SePay trong phạm vi bạn cấp quyền.

||

Claude, ChatGPT, Codex và các ứng dụng AI khác kết nối SePay MCP tại https://my.sepay.vn/mcp để đọc dữ liệu SePay bạn cho phép và tra tài liệu tích hợp. MCP (Model Context Protocol) là chuẩn mở Anthropic công bố tháng 11/2024, cho ứng dụng AI dùng dữ liệu và công cụ bên ngoài (modelcontextprotocol.io).

Claude dựng dashboard dòng tiền năm 2026 từ dữ liệu giao dịch SePay qua SePay MCP
Nhấn để phóng to
Claude đọc giao dịch qua SePay MCP rồi dựng dashboard dòng tiền.

Ứng dụng AI đọc được gì qua SePay MCP

Khi kết nối, bạn đăng nhập my.sepay.vn và chọn nhóm dữ liệu ứng dụng AI được đọc:

  • Giao dịch và báo cáo dòng tiền
  • Tài khoản ngân hàng và tài khoản ảo (VA)
  • Hạn mức gói dịch vụ
  • Webhook đã cấu hình và lịch sử gửi webhook

Tài liệu SePay đọc được ngay, không cần đăng nhập. SePay MCP: Mặc định chỉ đọc. Thao tác ghi chỉ chạy khi bạn cấp quyền và xác nhận từng lần. Không trả về số dư tài khoản.

Ví dụ, bạn hỏi "Đơn hàng DH00012 đã được thanh toán chưa?", ứng dụng AI tìm giao dịch có mã DH00012 rồi trả lời kèm thời gian và số tiền. Thêm câu hỏi mẫu ở Danh sách tool SePay MCP.

Quan trọng

Bạn chọn nhóm dữ liệu ứng dụng AI được đọc và ẩn được thông tin nhạy cảm. Mọi lần đọc đều có trong nhật ký, và bạn thu hồi kết nối lúc nào cũng được.

Chọn ứng dụng AI để kết nối

Claude và ChatGPT là ứng dụng trò chuyện, dùng trên trình duyệt. Claude Code và Codex chạy trên dòng lệnh, Cursor là trình soạn code có AI, thường dùng khi lập trình.

Điều kiện trên SePay

Mọi cách kết nối đều bắt đầu từ trang AI Agent trên SePay: ở menu bên trái, mục Tích hợp & Thông báo, chọn AI Agent. SePay MCP bật sẵn cho mọi công ty. Nhân viên có vai trò Người dùng bình thường cần SuperAdmin hoặc Admin cấp quyền Cho phép kết nối AI qua MCP (trang phân quyền người dùng, nhóm Kết nối AI (MCP)) mới kết nối được.

Chưa có kết nối nào, trang AI Agent hiện màn Dùng AI với SePay. Bấm Tạo kết nối để mở màn toàn màn hình chọn ứng dụng: Claude, Claude Code, ChatGPT, Codex, Cursor hoặc Khác. Đã có kết nối thì trang có 4 tab Tổng quan, Ứng dụng đã kết nối, Nhật ký hoạt động và Skills & CLI (chi tiết).

Kết nối ứng dụng AI khác (VS Code, Gemini CLI, Cline...)

Cursor có hướng dẫn riêng ở Kết nối Cursor với SePay qua MCP. Ứng dụng nào hỗ trợ máy chủ MCP qua HTTP cũng kết nối được. Trên trang AI Agent, chọn Tạo kết nối → Khác, rồi chọn Giao diện (GUI) cho ứng dụng có cửa sổ hoặc chạy trên web, Dòng lệnh (CLI) cho công cụ chạy trong terminal. Kết nối tạo theo cách này hiện tên SePay MCP ở tab Ứng dụng đã kết nối, bạn đổi tên cho dễ nhận ra.

Ứng dụng có giao diện

Trang Tạo kết nối, thẻ Khác ở chế độ Giao diện (GUI), gồm MCP Server URL, OAuth Client ID và ô lưu Callback URL
Nhấn để phóng to
Chế độ Giao diện: sao chép MCP Server URL, OAuth Client ID và lưu Callback URL khi ứng dụng yêu cầu.
  1. Trong ứng dụng AI, mở phần thêm máy chủ MCP từ xa. Đặt tên sepay, dán MCP Server URL (https://my.sepay.vn/mcp). Nếu phải chọn kiểu kết nối, chọn Streamable HTTP hoặc HTTP.
  2. Ứng dụng hỏi Client ID thì dán OAuth Client ID (sepay-mcp), để trống Client Secret.
  3. Ứng dụng chạy trên web và hiện Callback URL (có nơi gọi là Redirect URL) thì dán địa chỉ đó vào ô Callback URL trên SePay, chọn Lưu Callback URL. Ứng dụng chạy trên máy bạn thì bỏ qua bước này.
  4. Khi ứng dụng mở trình duyệt, đăng nhập SePay, chọn nhóm dữ liệu rồi chọn Đồng ý cấp quyền.

Callback URL phải bắt đầu bằng https://. Địa chỉ bạn lưu chỉ dùng được cho tài khoản của bạn, trong công ty đang chọn: đồng nghiệp tự lưu ở tài khoản của họ, đổi sang công ty khác thì lưu lại. Mỗi tài khoản lưu tối đa 10 địa chỉ, xóa bớt ở mục Các URL đã lưu trước đó.

Cấu hình mẫu theo tài liệu của từng hãng:

VS Code (hướng dẫn): mở Command Palette, chạy MCP: Thêm máy chủ (MCP: Add Server), chọn HTTP (HTTP hoặc Server-Sent Events) (HTTP (HTTP or Server-Sent Events)), dán https://my.sepay.vn/mcp, đặt ID sepay. VS Code hỏi Client ID thì dán sepay-mcp.

Cline (hướng dẫn): tab Cấu hình (Configure) → Cấu hình máy chủ MCP (Configure MCP Servers) → tab Máy chủ từ xa (Remote Servers). Điền Tên máy chủ (Server Name) sepay, URL máy chủ (Server URL) https://my.sepay.vn/mcp, Kiểu truyền tải (Transport Type) chọn Streamable HTTP, rồi chọn Thêm máy chủ (Add Server).

Ứng dụng dòng lệnh

Trang Tạo kết nối, thẻ Khác ở chế độ Dòng lệnh (CLI), có lệnh thêm cho Gemini CLI và tệp cấu hình mẫu
Nhấn để phóng to
Chế độ Dòng lệnh có sẵn lệnh thêm SePay cho Gemini CLI, tệp cấu hình mẫu và OAuth Client ID.

Công cụ dòng lệnh không cần Callback URL, thường cũng không cần Client ID; công cụ nào hỏi thì dán OAuth Client ID. Ví dụ với Gemini CLI, thêm SePay cho thư mục dự án đang mở bằng lệnh:

$ gemini mcp add --transport http sepay https://my.sepay.vn/mcp

Thêm -s user để dùng ở mọi dự án, hoặc khai trong ~/.gemini/settings.json:

~/.gemini/settings.json
{
  "mcpServers": {
    "sepay": {
      "httpUrl": "https://my.sepay.vn/mcp"
    }
  }
}

Để cấp quyền, mở Gemini CLI bằng lệnh gemini, gõ /mcp auth sepay rồi chọn Đồng ý cấp quyền trên trình duyệt. SePay tự chuyển về công cụ sau vài giây. Gỡ SePay bằng gemini mcp remove sepay.

Lỗi thường gặp khi kết nối ứng dụng khác

Một số từ cần biết

TừNghĩa
Máy chủ MCPĐịa chỉ ứng dụng AI kết nối tới, với SePay là https://my.sepay.vn/mcp
ConnectorTên Claude và ChatGPT dùng cho một máy chủ MCP đã thêm
Client IDMã SePay cấp cho từng ứng dụng AI. Mã công khai, không cần giữ kín
Cấp quyềnBước đăng nhập SePay và chọn nhóm dữ liệu ứng dụng AI được đọc
Phiên kết nốiMột lần cấp quyền của một ứng dụng ở một nơi, ví dụ Claude trên máy công ty
TerminalCửa sổ gõ lệnh: Terminal trên macOS, PowerShell trên Windows

Quản lý kết nối

Mọi kết nối nằm ở trang AI Agent, gồm 4 tab Tổng quan, Ứng dụng đã kết nối, Nhật ký hoạt động, Skills & CLI. Người dùng bình thường chỉ thấy kết nối của mình. Tab Tổng quan của mỗi người có số ứng dụng đang kết nối, lượt AI tra cứu trong 30 ngày, lần dùng gần nhất và các ứng dụng kết nối gần đây kèm nút Thu hồi. SuperAdmin và Admin thấy thêm khối giám sát cả công ty trong tab Tổng quan và xem kết nối của người khác qua bộ lọc Đang xem. Tab Skills & CLI hướng dẫn cài SePay Skills và SePay CLI.

Tab Tổng quan trang AI Agent trên my.sepay.vn với số ứng dụng đang kết nối, lượt AI tra cứu 30 ngày, lần dùng gần nhất và bảng ứng dụng đã kết nối gần đây
Nhấn để phóng to
Tab Tổng quan: số ứng dụng đang kết nối, lượt AI tra cứu và các ứng dụng dùng gần đây.

Tab Ứng dụng đã kết nối liệt kê từng kết nối kèm quyền, ngày cấp quyền và lần dùng gần nhất. Trên mỗi dòng:

  1. Chọn biểu tượng bút cạnh tên để đặt tên gợi nhớ, ví dụ "Cursor máy công ty".
  2. Mở menu ⋮ để chọn Nhật ký, Chỉnh quyền hoặc Thu hồi.
Danh sách ứng dụng AI đang kết nối SePay MCP trên my.sepay.vn, menu hành động mở với Nhật ký, Chỉnh quyền, Thu hồi
Nhấn để phóng to
Mỗi kết nối có nút đổi tên và menu Nhật ký, Chỉnh quyền, Thu hồi.

Chỉnh quyền bật, tắt từng nhóm dữ liệu và tùy chọn ẩn, chi tiết ở Chỉnh quyền sau khi kết nối. Thu hồi ngắt kết nối ngay, chi tiết ở Thu hồi kết nối.

Nhật ký hoạt động

Tab Nhật ký hoạt động ghi mỗi lần ứng dụng AI đọc dữ liệu hoặc gửi lại webhook: kết nối nào, hành động gì, lúc nào, từ IP nào, kết quả thành công, lỗi hay bị từ chối. Nhật ký giữ 90 ngày, kể cả với kết nối đã thu hồi.

Nhật ký hoạt động SePay MCP trên my.sepay.vn với bộ lọc thời gian, ứng dụng, trạng thái và ô tìm kiếm
Nhấn để phóng to
Nhật ký ghi từng lần ứng dụng AI đọc dữ liệu SePay, lọc được theo thời gian, ứng dụng và trạng thái.

Lỗi thường gặp khi kết nối SePay MCP

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

Tiếp theo