SePay MCP
Dùng khi bạn muốn hỏi AI về giao dịch, dòng tiền bằng tiếng Việt.
- Dành cho
- Chủ doanh nghiệp, kế toán cần tra cứu, đối soát
- Cách dùng
- Hỏi bằng tiếng Việt trong Claude, ChatGPT
- Bắt đầu
- Dán địa chỉ và Client ID, chọn dữ liệu cho phép, rồi hỏi
SePay MCP
Kết nối MCP ngân hàng của SePay một lần là hỏi được Claude, ChatGPT: hôm nay tiền vào bao nhiêu, khách chuyển khoản chưa. AI chỉ truy cập phần dữ liệu bạn cho phép, muốn thu hồi lúc nào cũng được.
Hoạt động với
Khách nói vừa chuyển 1.200.000 đ cho đơn DH00012, tiền về chưa?
Used SePay: Liệt kê giao dịch
Tiền về rồi. Đơn DH00012 nhận đủ 1.200.000 đ lúc 09:15 sáng nay, vào tài khoản BIDV.
Dán địa chỉ SePay MCP vào phần kết nối của ứng dụng AI, kèm Client ID nếu ứng dụng hỏi. Client ID lấy ở my.sepay.vn → AI Agent → Tạo kết nối, chọn ứng dụng của bạn.
Đăng nhập SePay, bật những nhóm dữ liệu AI được đọc. Phần nào không muốn AI thấy, như tiền ra hay số tài khoản, thì bật giấu.
Hỏi bằng tiếng Việt như nhắn tin bình thường. Mỗi lần AI đọc dữ liệu đều được ghi vào nhật ký.
Địa chỉ SePay MCP
https://my.sepay.vn/mcpHỏi về tài liệu tích hợp thì không cần đăng nhập. Lúc thêm SePay, ứng dụng mở trang đăng nhập SePay để bạn cấp quyền.
sepay-claude, để trống ô Mã bí mật ứng dụng khách OAuth (OAuth client secret), bấm Thêm (Add).Nếu dùng gói Team hoặc Enterprise, chỉ Owner của tổ chức thêm được connector, ở Cài đặt tổ chức (Organization settings) → Trình kết nối (Connectors). Sau đó từng người bấm Kết nối (Connect).
Hướng dẫn chi tiết cho Claudesepay-chatgpt (lấy ở my.sepay.vn → AI Agent → Tạo kết nối → ChatGPT), để trống ô Mã bí mật ứng dụng khách OAuth (OAuth client secret).Làm trên chatgpt.com bằng máy tính, ứng dụng điện thoại chưa thêm được. Cần gói ChatGPT Pro, Business, Enterprise hoặc Edu. Gói miễn phí chưa hỗ trợ, gói Pro chỉ dùng được các thao tác đọc. Không thấy mục Thêm server MCP tùy chỉnh (Add custom MCP server) thì tài khoản chưa có quyền: gói Business chỉ admin hoặc owner của workspace thêm được, gói Enterprise, Edu thì nhờ admin cấp quyền.
Hướng dẫn chi tiết cho ChatGPTURL > trong terminal.claude mcp add --transport http --scope user sepay https://my.sepay.vn/mcp --client-id sepay-claude-code --callback-port 8765codex mcp add sepay --url https://my.sepay.vn/mcpsepay-mcp. Cursor không tự hỏi Client ID, bạn khai trong cấu hình: "auth": {"CLIENT_ID": "sepay-mcp"}. Ứng dụng chạy trên web thì lưu thêm Callback URL ở my.sepay.vn → AI Agent → Tạo kết nối → Khác./mcp auth sepay.gemini mcp add --transport http sepay https://my.sepay.vn/mcpLệnh trên dành cho Gemini CLI. Công cụ khác có cách thêm MCP riêng.
Hướng dẫn cho ứng dụng khácBấm từng câu hỏi để xem AI trả lời thế nào.
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ách nói vừa chuyển 1.200.000 đ cho đơn DH00012, tiền về chưa?
Mình kiểm tra giao dịch của đơn DH00012 trên SePay.
Loaded SePay
Used SePay: Liệt kê giao dịch
Tiền về rồi. Đơn DH00012 nhận đủ 1.200.000 đ lúc 09:15 sáng nay, vào tài khoản BIDV.
Liệt kê 5 giao dịch gần nhất trên 500.000 đ vào tài khoản ACB.
Mình lọc giao dịch tiền vào tài khoản ACB, số tiền trên 500.000 đ.
Loaded SePay
Used SePay: Liệt kê giao dịch
5 giao dịch gần nhất trên 500.000 đ vào tài khoản ACB:
| Giờ | Nội dung | Số tiền |
|---|---|---|
| 15:10 | DH00318 | 2.400.000 đ |
| 14:26 | DH00315 | 650.000 đ |
| 12:05 | DH00309 | 1.180.000 đ |
| 10:47 | DH00302 | 3.900.000 đ |
| 09:12 | DH00297 | 820.000 đ |
Chốt sổ hôm nay: tiền vào từng tài khoản bao nhiêu?
Mình cộng giao dịch tiền vào hôm nay theo từng tài khoản.
Loaded SePay
Used SePay: Liệt kê giao dịch
Hôm nay tiền vào 36.720.000 đ từ 31 giao dịch, chia theo tài khoản:
| Tài khoản | Giao dịch | Tiền vào |
|---|---|---|
| ACB ••••1234 | 14 | 17.450.000 đ |
| Tài khoản ảo BIDV | 12 | 13.870.000 đ |
| VPBank ••••9012 | 5 | 5.400.000 đ |
Có khoản nào chuyển vào mà không ghi mã đơn không?
Mình tìm các khoản tiền vào không có mã đơn.
Loaded SePay
Used SePay: Liệt kê giao dịch
Có 2 khoản không ghi mã đơn:
| Giờ | Số tiền | Nội dung |
|---|---|---|
| 10:36 | 420.000 đ | ck |
| 16:02 | 1.000.000 đ | chuyen khoan |
So sánh tiền vào 4 tuần gần nhất.
Mình lấy báo cáo dòng tiền theo tuần.
Loaded SePay
Used SePay: Báo cáo dòng tiền
Tiền vào tăng 3 tuần liền. Tuần 12/10 – 18/10 đạt 196,9 triệu, tăng 9% so với tuần trước.
| Tuần | Tiền vào | So với tuần trước |
|---|---|---|
| 21/9 – 27/9 | 163,4 triệu | |
| 28/9 – 4/10 | 175,2 triệu | +7% |
| 5/10 – 11/10 | 180,6 triệu | +3% |
| 12/10 – 18/10 | 196,9 triệu | +9% |
Tài khoản ngân hàng nào đang mất kết nối?
Mình kiểm tra các tài khoản ngân hàng đã kết nối.
Loaded SePay
Used SePay: Liệt kê tài khoản ngân hàng
MB ••••3456 đang mất kết nối. 3 tài khoản còn lại vẫn kết nối bình thường.
| Ngân hàng | Số tài khoản | Trạng thái |
|---|---|---|
![]() | ••••1234 | Bình thường |
![]() | ••••5678 | Bình thường |
![]() | ••••9012 | Bình thường |
![]() | ••••3456 | Mất kết nối |
Hôm nay webhook gửi về hệ thống có lỗi không?
Mình xem báo cáo webhook hôm nay, rồi xem log các lần gửi lỗi.
Loaded SePay
Used SePay: Báo cáo tình trạng webhook, Liệt kê log webhook
Hôm nay SePay gửi webhook 486 lần, lỗi 5 lần. Cả 5 lần lỗi đều trả mã HTTP 504, trong khoảng 10:41 đến 10:47.
Viết giúp tôi đoạn code PHP nhận webhook SePay
Mình đọc trang Bắt đầu nhanh trên developer.sepay.vn.
Loaded SePay
Used SePay: Đọc nội dung tài liệu
Đây là đoạn code ngắn nhất theo tài liệu:
<?php // handler.php error_log('Nhận webhook: ' . file_get_contents('php://input')); header('Content-Type: application/json'); echo json_encode(['success' => true]);
Đoạn code trả về {"success": true} để SePay biết bạn đã nhận. Muốn chạy thử trên máy thì dùng sepay webhook listen --forward localhost:3000.
Bạn quyết định AI được xem dữ liệu nào, phần nào được phân quyền. Thu hồi quyền lúc nào cũng được.
Nhật ký hoạt động của Claude
| Thời gian | Công cụ | Kết quả |
|---|---|---|
| 22/10 17:42 | Liệt kê giao dịch | 31 giao dịch |
| 22/10 17:40 | Liệt kê tài khoản ngân hàng | 4 tài khoản |
| 22/10 09:16 | Liệt kê giao dịch | 1 giao dịch |
| 21/10 16:05 | Báo cáo tình trạng webhook | 1 báo cáo |
SePay chỉ gửi những nhóm dữ liệu bạn cho phép. Sau đó dữ liệu được ứng dụng AI bạn chọn xử lý theo chính sách của bên đó.
Mỗi công cụ cho những việc khác nhau. Dùng riêng hay kết hợp đều được.
Dùng khi bạn muốn hỏi AI về giao dịch, dòng tiền bằng tiếng Việt.
Dùng khi bạn muốn chạy lệnh, viết script hoặc tự động hoá phần tích hợp.
Dùng khi bạn nhờ AI viết phần nhận thanh toán SePay cho phần mềm của mình.
| MCP | CLI | Skills | |
|---|---|---|---|
| Dùng để | Hỏi dữ liệu ngay trong ứng dụng AI | Làm tích hợp SePay, từ chạy thử đến khi bán hàng | Giúp AI viết code tích hợp SePay đúng ngay từ đầu |
| Ai làm | Bạn hỏi, AI đọc dữ liệu | Bạn hoặc AI chạy lệnh | AI viết code theo hướng dẫn trong Skills |
| Cài đặt | Không cần cài với Claude, ChatGPT, chỉ thêm địa chỉ và Client ID. Claude Code, Codex chạy một lệnh | Cài bằng một lệnh trên macOS, Linux, Windows | Tải sepay.zip cho ứng dụng chat, hoặc một lệnh cài cho agent lập trình |
| Đăng nhập | Đăng nhập SePay, chọn nhóm dữ liệu cho phép | Nhập mã xác nhận một lần trên trình duyệt | Không cần, Skills không kết nối tới tài khoản SePay |
| Dữ liệu | 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. | Đọc và ghi theo quyền đã cấp. Giao dịch giả chỉ tạo được trên sandbox | Không đọc dữ liệu tài khoản |
| Webhook, IPN | Xem lịch sử gửi và báo cáo lỗi | Nhận thẳng về máy (localhost), không cần địa chỉ công khai | AI viết code nhận webhook: xác thực, không xử lý trùng |
Không thấy câu bạn cần? Liên hệ SePay.
MCP (Model Context Protocol) là cách chung để ứng dụng AI kết nối với nguồn dữ liệu bên ngoài, qua một máy chủ gọi là MCP server. SePay MCP là MCP ngân hàng: bạn kết nối Claude hay ChatGPT với nó một lần. Sau đó mỗi khi bạn hỏi, AI tự lấy dữ liệu cần thiết từ SePay, trong phạm vi bạn cho phép.
Mục AI Agent nằm ở menu bên trái, nhóm Tích hợp & Thông báo. Nếu bạn là Người dùng thường: nhờ SuperAdmin hoặc Admin của công ty bật quyền "Cho phép kết nối AI qua MCP" cho bạn. Vẫn không thấy thì liên hệ SePay.
Chỉ những nhóm bạn bật: giao dịch, tài khoản ngân hàng, tài khoản ảo, hạn mức gói, lịch sử webhook, webhook đã cấu hình. Riêng tài liệu tích hợp thì đọc được luôn, không cần đăng nhập.
Dùng SePay MCP được với mọi tài khoản bạn đã kết nối với SePay, ở các ngân hàng: Vietcombank, BIDV, VietinBank, MB, ACB, VPBank, TPBank, Sacombank, MSB, OCB, ABBANK, KienlongBank, Shinhan Bank và NAPAS. Xem danh sách đầy đủ ở trang ngân hàng hợp tác. Phân quyền theo ngân hàng vẫn áp dụng: bạn chỉ được xem tài khoản nào thì AI cũng chỉ truy cập được tài khoản đó.
Có. Lưu trên my.sepay.vn xong, quyền mới áp dụng từ lần AI đọc dữ liệu tiếp theo. Ứng dụng vẫn trả lời như cũ thì mở cuộc trò chuyện mới.
Vào my.sepay.vn → AI Agent, tab Ứng dụng đã kết nối, bấm Thu hồi ở ứng dụng muốn ngắt. AI hết quyền ngay.
Được. Mỗi ứng dụng là một kết nối riêng, quyền và nhật ký cũng tách riêng.
Có, nếu bạn là SuperAdmin hoặc Admin và bật nhóm Hạn mức gói. AI sẽ biết bạn đã dùng bao nhiêu giao dịch, còn bao nhiêu và khi nào hết chu kỳ.
SePay chỉ gửi cho AI những nhóm dữ liệu bạn cho phép. Từ đó, dữ liệu do ứng dụng AI bạn dùng xử lý, theo chính sách riêng của họ.
Dán địa chỉ (và Client ID nếu ứng dụng hỏi) vào ứng dụng AI, đăng nhập SePay, chọn dữ liệu cho phép là xong.
Không thấy mục AI Agent? Nhờ SuperAdmin hoặc Admin công ty cấp quyền.