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

Hướng dẫn kết nối Cursor với SePay qua MCP bằng tệp mcp.json, để 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 Cursor bằng một khối cấu hình trong tệp mcp.json. Cursor 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. Ứng dụng Cursor cho máy tính, đã đăng nhập tài khoản Cursor.
  2. 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 Cursor tháng 11/2026 và hướng dẫn của Cursor. Tên mục trong Cursor ghi theo giao diện tiếng Anh. Nếu Cursor 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: Lấy cấu hình Cursor 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 ở góc trên bên phải.
  4. Ở cột Bạn dùng ứng dụng AI nào?, chọn Cursor.

Bước Cấu hình cho Cursor hiện khối cấu hình cho tệp mcp.json, có sẵn địa chỉ https://my.sepay.vn/mcp và Client ID sepay-mcp. Chọn nút sao chép để dán vào Cursor ở Bước 2.

Trang Tạo kết nối trên my.sepay.vn đang chọn Cursor, hiện khối cấu hình mcp.json kèm nút sao chép
Nhấn để phóng to
Chọn Cursor rồi sao chép khối cấu hình.

Bước 2: Thêm SePay vào Cursor

  1. Trong Cursor, chọn Customize ở thanh bên trái.
  2. Chọn tab MCPs.
  3. Kéo xuống cuối danh sách, chọn New MCP Server (Add a Custom MCP Server). Cursor mở tệp ~/.cursor/mcp.json ở khung bên phải.
  4. Dán cấu hình sau vào tệp rồi lưu (Ctrl+S, trên macOS Cmd+S):
~/.cursor/mcp.json
{
  "mcpServers": {
    "sepay": {
      "url": "https://my.sepay.vn/mcp",
      "auth": { "CLIENT_ID": "sepay-mcp" }
    }
  }
}

Tệp đã có máy chủ MCP khác thì chỉ thêm khối "sepay": { ... } vào trong mcpServers, cách khối liền trước bằng dấu phẩy.

Phải có khối auth với CLIENT_ID sepay-mcp. Thiếu khối này, Cursor không đăng nhập được SePay. Không cần CLIENT_SECRET.

Muốn dùng SePay trong một dự án thôi, đặt cấu hình trên vào tệp .cursor/mcp.json ở thư mục gốc của dự án.

Trang Customize của Cursor ở tab MCPs, khoanh số 1 mục Customize, số 2 tab MCPs, số 3 nút New MCP Server, số 4 khối sepay trong tệp mcp.json bên phải
Nhấn để phóng to
Chọn Customize (1), tab MCPs (2), New MCP Server (3), dán khối sepay vào mcp.json (4) rồi lưu.

Bước 3: Đăng nhập SePay từ Cursor

Lưu tệp xong, SePay hiện ở mục Needs Attention của tab MCPs với tên Sepay (Cursor viết hoa chữ đầu của sepay), kèm dòng Needs authentication. Chọn Authenticate ở dòng đó. Cursor mở trình duyệt tới màn hình cấp quyền của SePay.

Cấp quyền cho Cursor trên SePay

Bước 4: Đồng ý cấp quyền

Cursor dùng Client ID chung sepay-mcp nên SePay hiện màn hình Ứng dụng khác muốn truy cập dữ liệu SePay của bạn, không ghi tên Cursor. Trên màn hình này:

  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 Ứng dụng khác muốn truy cập dữ liệu SePay của bạn (Cursor dùng Client ID sepay-mcp): 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 Cursor được đọc, mở Ẩn bớt thông tin cho ứng dụng này nếu cần, rồi chọn Đồng ý cấp quyền.

SePay hiện trang báo đã cấp quyền rồi tự chuyển về Cursor sau vài giây. Trang không tự chuyển thì chọn Hoàn tất kết nối.

Khi Sepay chuyển sang mục Connected của tab MCPs, kèm số tool đang bật (tools enabled), kết nối đã xong.

Tab MCPs trong Customize của Cursor, Sepay nằm trong mục Connected với 19 tools enabled
Nhấn để phóng to
Sepay ở mục Connected, kèm số tool đang bật.

Trên trang AI Agent của SePay, kết nối này hiện tên SePay MCP ở tab Ứng dụng đã kết nối. Bạn đổi được sang tên dễ nhận ra, ví dụ "Cursor máy công ty", xem Quản lý kết nối.

Hỏi thử Cursor về dữ liệu SePay

Chọn New Chat ở thanh bên trái của Cursor và hỏi, ví dụ "Giao dịch trong tháng này của tôi". Cursor có thể hỏi bạn trước khi dùng tool của SePay: đồng ý để tiếp tục. Khi Cursor gọi tool của sepay và trả lời bằng giao dịch trên tài khoản của bạn, kết nối đã chạy. Ở đây sepay là tên bạn đặt cho SePay MCP trong tệp mcp.json, không phải SePay CLI.

Khung chat Cursor: câu hỏi giao dịch trong tháng này, Cursor gọi tool của SePay rồi tóm tắt số giao dịch, tổng tiền vào và tiền ra
Nhấn để phóng to
Hỏi về dữ liệu của bạn (1), Cursor gọi tool của SePay (2) rồi tóm tắt giao dịch trên tài khoản (3). Số tiền trong ảnh đã thay bằng số mẫu.

Tra cứu tài liệu tích hợp SePay

Cursor đọ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, Cursor đọ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ì?"
  • ...
Khung chat Cursor: câu hỏi quy trình tích hợp xác thực thanh toán cho cửa hàng online, Cursor gọi 7 tool của SePay rồi trả lời bằng tài liệu SePay
Nhấn để phóng to
Hỏi về tích hợp (1), Cursor gọi tool của SePay để đọc tài liệu (2) rồi trả lời kèm link trang tài liệu.

Ngắt kết nối Cursor

Xóa khối "sepay": { ... } khỏi tệp ~/.cursor/mcp.json rồi lưu, Sepay biến khỏi tab MCPs.

Cách 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.

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 để Cursor nắm luồng tích hợp và lưu ý bảo mật khi viết code tích hợp SePay.