Bạn thêm SePay vào Codex bằng một lệnh codex mcp add. Codex tự mở trình duyệt để bạn đăng nhập SePay và cấp quyền.
Điều kiện trước khi bắt đầu
- Một tài khoản ChatGPT hoặc API key OpenAI để đăng nhập Codex.
- Một terminal: Terminal trên macOS hoặc Linux, PowerShell trên Windows.
- 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
Các bước viết theo Codex tháng 10/2026 và hướng dẫn của OpenAI. Nếu Codex có thay đổi, hãy tìm các mục có ý nghĩa tương tự hoặc liên hệ SePay để được hỗ trợ.
Bước 1: Cài Codex
Nếu gõ codex trong terminal đã chạy được thì bỏ qua bước này. Trên macOS, Linux, cài bằng lệnh:
$ curl -fsSL https://chatgpt.com/codex/install.sh | shTrên Windows, cài bằng lệnh sau trong PowerShell:
$ powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"Cài bằng npm (npm install -g @openai/codex) hoặc Homebrew (brew install --cask codex) cũng được. Cài xong, mở terminal mới, chạy codex và chọn Đăng nhập bằng ChatGPT (Sign in with ChatGPT) hoặc cách đăng nhập khác Codex đưa ra.
Bước 2: Thêm SePay vào Codex
Thêm SePay vào Codex bằng lệnh này. Lệnh áp dụng cho mọi thư mục trên máy, mỗi máy chạy một lần. Lệnh này cũng có ở trang Tạo kết nối của SePay, thẻ Codex.
$ codex mcp add sepay --url https://my.sepay.vn/mcpCodex in Detected OAuth support. Starting OAuth flow… rồi mở trình duyệt tới màn hình cấp quyền của SePay. Để nguyên terminal đó cho tới khi xong Bước 3. Trình duyệt không tự mở thì sao chép đường link Codex in ra và dán vào trình duyệt.
Lỡ đóng terminal hoặc trình duyệt trước khi cấp quyền xong, đăng nhập lại bằng lệnh:
$ codex mcp login sepayCấp quyền cho Codex trên SePay
Bước 3: Đồng ý cấp quyền
Trên màn hình Codex muốn truy cập dữ liệu SePay của bạn:
- Bật hoặc tắt từng nhóm dữ liệu ở mục AI được phép xem.
- Nếu cần, mở Ẩn bớt thông tin cho ứng dụng này.
- Chọn Đồng ý cấp quyền.
Ý nghĩa từng nhóm dữ liệu và tùy chọn ẩn có ở Quyền và bảo mật SePay MCP.

SePay hiện trang Đã cấp quyền cho Codex và tự chuyển về Codex sau vài giây. Trang không tự chuyển thì chọn Hoàn tất kết nối. Khi terminal in dòng bắt đầu bằng Successfully logged in, kết nối đã xong.

Hỏi thử Codex về dữ liệu SePay
Chạy codex rồi hỏi, ví dụ "Liệt kê 5 giao dịch gần nhất của tôi trên SePay". Lần đầu, Codex có thể hỏi bạn có cho gọi công cụ của SePay không: đồng ý để tiếp tục. Khi Codex gọi công cụ của sepay rồi trả về danh sách giao dịch, kết nối đã chạy. Ở đây sepay là tên bạn đặt cho SePay MCP trong lệnh ở Bước 2, không phải SePay CLI.
Tra cứu tài liệu tích hợp SePay
Codex đọc được tài liệu trên developer.sepay.vn qua SePay MCP, kể cả khi chưa cấp quyền. Khi bạn hỏi về tích hợp, Codex đọc trang tài liệu liên quan rồi trả lời kèm link trang đó. Mở link để đối chiếu trước khi dùng code. Ví dụ:
- "Viết endpoint nhận webhook SePay bằng Node.js, bỏ qua giao dịch gửi trùng."
- "Cổng thanh toán SePay gửi IPN thế nào, tôi cần trả về gì?"
- ...
Ngắt kết nối Codex
Gỡ SePay khỏi Codex bằng lệnh:
$ codex mcp remove sepayLệnh này không thu hồi kết nối trên SePay. Muốn thu hồi, vào trang AI Agent, xem Quản lý kết nối. Ngược lại, nếu bạn thu hồi trên SePay nhưng chưa gỡ khỏi Codex thì chạy codex mcp login sepay để cấp quyền lại khi cần dùng.
Lỗi thường gặp
Các lỗi chung của SePay MCP ở Lỗi thường gặp khi kết nối SePay MCP.
Tiếp theo
- Xem câu hỏi mẫu cho từng loại dữ liệu ở Danh sách tool SePay MCP.
- Cài SePay Skills để Codex nắm luồng tích hợp và lưu ý bảo mật khi viết code tích hợp SePay.