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).

Ứ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.
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

- 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. - Ứng dụng hỏi Client ID thì dán OAuth Client ID (
sepay-mcp), để trống Client Secret. - Ứ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.
- 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

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/mcpThêm -s user để dùng ở mọi dự án, hoặc khai trong ~/.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 |
| Connector | Tên Claude và ChatGPT dùng cho một máy chủ MCP đã thêm |
| Client ID | Mã SePay cấp cho từng ứng dụng AI. Mã công khai, không cần giữ kín |
| Cấp quyền | Bước đăng nhập SePay và chọn nhóm dữ liệu ứng dụng AI được đọc |
| Phiên kết nối | Mộ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 |
| Terminal | Cử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 Ứ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:
- 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".
- Mở menu ⋮ để chọn Nhật ký, Chỉnh quyền hoặc 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.

Lỗi thường gặp khi kết nối SePay MCP
Câu hỏi thường gặp
Tiếp theo
- Thêm SePay vào claude.ai theo Kết nối Claude với SePay qua MCP.
- Xem câu hỏi mẫu cho từng loại dữ liệu ở Danh sách tool SePay MCP.
- Xem nhóm quyền, tùy chọn ẩn và khi nào kết nối bị ngắt ở Quyền và bảo mật SePay MCP.