Kết nối Codex với SePay qua MCP

Hướng dẫn kết nối Codex với SePay qua MCP trên dòng lệnh, để tra cứu giao dịch, webhook, tài khoản ngân hàng và tài liệu tích hợp SePay...

||

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

  1. Một tài khoản ChatGPT hoặc API key OpenAI để đăng nhập Codex.
  2. Một terminal: Terminal trên macOS hoặc Linux, PowerShell trên Windows.
  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

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 | sh

Trê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/mcp

Codex 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 sepay

Cấ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:

  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ó ở Quyền và bảo mật SePay MCP.

Màn hình cấp quyền SePay MCP cho Codex: các nhóm quyền ở mục AI được phép xem, nhóm Thao tác ghi tắt sẵn và danh sách việc AI không được phép
Nhấn để phóng to
Bật nhóm dữ liệu Codex được đọc rồi chọn Đồng ý cấp quyền.

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.

Trang Đã cấp quyền cho Codex của SePay với nút Hoàn tất kết nối
Nhấn để phóng to
Trang không tự chuyển về Codex thì chọn Hoàn tất kết nối.

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 sepay

Lệ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.