Kết nối ChatGPT với SePay qua MCP
Hướng dẫn kết nối ChatGPT với SePay qua MCP trên chatgpt.com, để tra cứu giao dịch, tài khoản ngân hàng và webhook.
Bạn thêm SePay vào ChatGPT như một plugin: chép địa chỉ máy chủ và Client ID từ SePay sang ChatGPT, rồi đăng nhập SePay để cấp quyền.
Điều kiện trước khi bắt đầu
- 1 Một tài khoản ChatGPT. Thêm SePay trên chatgpt.com bằng trình duyệt máy tính, không thêm được từ ứng dụng ChatGPT trên điện thoại.
- 2 Tài khoản đó thêm được plugin: mở chatgpt.com/plugins, chọn Thêm (Add) ở góc trên bên phải, thấy mục Thêm server MCP tùy chỉnh (Add custom MCP server) là được. Không thấy thì xem Lỗi thường gặp.
- 3 Vào được trang AI Agent trên SePay, xem điều kiện trên SePay.
Các bước kết nối
Bước 1: Lấy địa chỉ máy chủ và Client ID trên SePay
- 1 Đăng nhập my.sepay.vn.
- 2 Ở menu bên trái, mục Tích hợp & Thông báo, chọn AI Agent.
- 3 Chọn Tạo kết nối, rồi chọn ChatGPT.
Trang Kết nối ChatGPT với SePay hiện hướng dẫn từng bước, kèm hai giá trị cần dán:
- 1 Địa chỉ SePay (
https://my.sepay.vn/mcp): dán vào ChatGPT ở Bước 3. - 2 OAuth Client ID (
sepay-chatgpt): dán vào ChatGPT ở Bước 3.
Mỗi giá trị có nút sao chép. Để trang này mở song song với ChatGPT. Kết nối xong, trang tự chuyển sang bước Hoàn tất.

Bước 2: Mở hộp thoại thêm server MCP trong ChatGPT
- 1 Trên chatgpt.com, chọn Plugin (Plugins) ở menu bên trái.
- 2 Chọn Thêm (Add) ở góc trên bên phải.
- 3 Chọn Thêm server MCP tùy chỉnh (Add custom MCP server).

Bước 3: Điền thông tin máy chủ SePay
Trong hộp thoại Thêm server MCP tùy chỉnh:
- 1 Ở ô Tên (Name), đặt tên dễ nhận ra, ví dụ
SePay. Tên này hiện lại trên hộp thoại ở Bước 5. - 2 Ở mục Kết nối (Connection), chọn URL server (Server URL) rồi dán
https://my.sepay.vn/mcp. - 3 Ở mục Xác thực (Authentication), chọn OAuth hoặc không xác thực (OAuth or no authentication). ChatGPT báo lỗi khi tạo thì xem Lỗi thường gặp.
- 4 Mở Cài đặt OAuth nâng cao (Advanced OAuth settings). Phần cài đặt hiện ra ở bên phải hộp thoại.
- 5 Ở mục Phương thức đăng ký (Registration method), chọn Ứng dụng khách OAuth do người dùng xác định (User-Defined OAuth Client).
- 6 Dán Client ID từ SePay (
sepay-chatgpt) vào ô ID ứng dụng khách OAuth (OAuth client ID). Để trống ô Mã bí mật ứng dụng khách OAuth (OAuth client secret). Bỏ qua ô URL callback.

Bước 4: Xác nhận và tạo plugin
Vẫn trong hộp thoại đó:
- 1 Đọc cảnh báo rủi ro, đánh dấu Tôi hiểu và muốn tiếp tục (I understand and want to continue).
- 2 Chọn Tạo dưới dạng plugin (Create as a plugin).
Cấp quyền cho ChatGPT trên SePay
Bước 5: Đăng nhập SePay và đồng ý cấp quyền
Tạo xong, ChatGPT hiện hộp thoại Kết nối SePay (tên theo Bước 3). Chọn nút Kết nối SePay để mở màn hình cấp quyền của SePay. Nếu chưa đăng nhập my.sepay.vn, SePay hỏi đăng nhập trước.

Trên màn hình ChatGPT muốn truy cập dữ liệu SePay của bạn:
- 1 Bật hoặc tắt từng nhóm dữ liệu ở mục AI được phép xem.
- 2 Nếu cần, mở Ẩn bớt thông tin cho ứng dụng này.
- 3 Chọn Đồng ý cấp quyền.
Ý nghĩa từng nhóm dữ liệu và tùy chọn ẩn có ở hướng dẫn tổng quan.

Hỏi thử ChatGPT về dữ liệu SePay
Gửi ChatGPT câu hỏi, ví dụ "Báo cáo dòng tiền năm 2026, vẽ dashboard có biểu đồ theo tháng". ChatGPT có thể hỏi bạn xác nhận trước khi dùng công cụ của SePay, hãy đồng ý để tiếp tục. Khi ChatGPT trả về số liệu lấy từ SePay, như tổng tiền vào và tiền vào từng tháng, kết nối đã chạy.

Cài thêm SePay Skills (không bắt buộc)
SePay Skills là tệp hướng dẫn giúp ChatGPT dùng SePay đúng cách, ví dụ lập báo cáo dòng tiền hay trả lời câu hỏi theo tài liệu SePay. Skills khác gì MCP xem ở hướng dẫn tổng quan. Chỉ gói ChatGPT Plus, Business, Enterprise, Healthcare và Edu thêm được skill.
- 1 Tải tệp sepay.zip về máy. Tải lên nguyên tệp zip, không giải nén.
- 2 Ở thanh bên, chọn Plugin (Plugins).
- 3 Chọn tab Kỹ năng (Skills).
- 4 Chọn Thêm (Create) ở góc trên bên phải, rồi chọn Tải lên từ máy tính (Upload from your computer).
Trong hộp thoại Tải kỹ năng lên:
- 1 Kéo
sepay.zipvào khung tải lên, hoặc bấm vào khung để chọn tệp. - 2 Hộp thoại báo Đã tải kỹ năng lên thì chọn Xong.
Skill sepay hiện trong mục Đã cài đặt của tab Kỹ năng. Mở cuộc trò chuyện mới và hỏi về SePay, ví dụ "Lập báo cáo tiền vào, tiền ra tháng này".
- Lấy bản mới: skill không tự cập nhật. Tải lại
sepay.zip, xóa skillsepaycũ trong tab Kỹ năng rồi thêm lại. - Gỡ skill: xóa skill
sepaytrong tab Kỹ năng. Kết nối MCP vẫn giữ nguyên.
Hướng dẫn đầy đủ, cách thử và lỗi thường gặp xem ở Cài đặt và sử dụng SePay Skills. Tên menu ghi theo giao diện ChatGPT tháng 11/2026, có thể đổi theo phiên bản ứng dụng.
Quản lý và thu hồi quyền
Bạn chỉnh quyền, xem nhật ký hoặc thu hồi kết nối ChatGPT ở trang AI Agent, tab Ứng dụng đã kết nối. Xem chi tiết ở phần Quản lý kết nối.
Lỗi thường gặp và cách khắc phục
Nguyên nhân: Tài khoản ChatGPT chưa được phép thêm server MCP tự tạo (thường gặp với tài khoản công ty).
Cách khắc phục: Nhờ quản trị viên ChatGPT của công ty bật quyền, hoặc dùng tài khoản ChatGPT cá nhân.
Nguyên nhân: Dán sai ID ứng dụng khách OAuth, hoặc chưa chọn Ứng dụng khách OAuth do người dùng xác định.
Cách khắc phục: Xóa kết nối SePay trong ChatGPT, tạo lại theo Bước 2–3 và sao chép đúng Client ID SePay cấp cho ChatGPT.
Nguyên nhân: Chưa đăng nhập, hoặc phiên đăng nhập đã hết hạn.
Cách khắc phục: Chọn kết nối, đăng nhập SePay và chọn Đồng ý cấp quyền.
Nguyên nhân: Nhóm quyền tương ứng đang tắt.
Cách khắc phục: Vào SePay → AI Agent → tab Ứng dụng đã kết nối → Chỉnh quyền để bật nhóm quyền, rồi hỏi lại ở cuộc trò chuyện mới. Nếu nhóm đó không có trong Chỉnh quyền, kết nối lại và chọn Tiếp tục phiên để cấp thêm.