Bạn thêm SePay vào Claude như một connector, dùng được trên claude.ai và ứng dụng Claude cho máy tính. Cách làm: lấy địa chỉ máy chủ và Client ID trên SePay, khai vào Claude, rồi đăng nhập SePay để cấp quyền.
Điều kiện trước khi bắt đầu
- Một tài khoản Claude, gói nào cũng được.
- Gói Team hoặc Enterprise: chỉ Owner của tổ chức thêm được connector. Owner bấm ảnh đại diện ở góc dưới bên trái → Cài đặt tổ chức (Organization settings) → Trình kết nối (Connectors) rồi làm Bước 1 đến Bước 4. Thành viên chọn Kết nối (Connect) ở ảnh đại diện → Cài đặt (Settings) → Trình kết nối (Connectors) rồi làm Bước 5.
- 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 trong Claude viết theo giao diện Claude tháng 11/2026 và hướng dẫn của Anthropic. Nếu giao diện Claude 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 địa chỉ máy chủ và Client ID trên SePay
- Đăng nhập my.sepay.vn.
- Ở menu bên trái, mục Tích hợp & Thông báo, chọn AI Agent.
- Chọn Tạo kết nối ở góc trên bên phải.
Trang Tạo kết nối mở ra. Ở cột Bạn dùng ứng dụng AI nào?, chọn Claude:
- Địa chỉ SePay (
https://my.sepay.vn/mcp): dán vào Claude ở Bước 3. - Client ID (
sepay-claude): dán vào Claude ở Bước 4.
Mỗi ô có nút sao chép. Giữ trang này mở trong lúc làm các bước sau.

Bước 2: Mở hộp thoại thêm connector trong Claude
- Trên claude.ai hoặc ứng dụng Claude cho máy tính, chọn ảnh đại diện ở góc dưới bên trái.
- Chọn Cài đặt (Settings).

Trong cửa sổ Cài đặt (Settings):
- Ở menu bên trái, chọn Trình kết nối (Connectors).
- Chọn Thêm (Add).
- Chọn Thêm trình kết nối tùy chỉnh (Add custom connector).

Bước 3: Điền tên và địa chỉ máy chủ
Trong hộp thoại Thêm trình kết nối tùy chỉnh (Add custom connector):
- Ở ô đầu tiên, đặt tên dễ nhận ra, ví dụ
SePay. - Ở ô thứ hai, dán MCP Server URL từ SePay:
https://my.sepay.vn/mcp. - Chọn Tiếp tục (Continue).

Bước 4: Chọn cách đăng nhập và dán Client ID
Claude chuyển sang phần xác thực và có thể chọn sẵn Không đăng nhập (No sign-in) kèm nhãn Đã phát hiện (Detected), và gợi ý Dùng danh tính công khai của Claude (Use Claude's published identity) kèm nhãn Đề xuất (Recommended). SePay không nhận hai lựa chọn này, nên đổi lại như sau:
- Ở mục Xác thực (Authentication), chọn Đăng nhập ngay (Sign in now).
- Ở mục Ứng dụng khách OAuth (OAuth client), chọn Dùng ứng dụng khách OAuth của riêng bạn (Use your own OAuth client).
- Dán OAuth Client ID từ SePay (
sepay-claude) vào ô Client ID. Để trống ô Mã bí mật ứng dụng khách OAuth (OAuth client secret). - Kéo xuống cuối hộp thoại, chọn Thêm (Add).

Cấp quyền cho Claude trên SePay
Bước 5: Đăng nhập SePay và đồng ý cấp quyền
Chọn Thêm (Add) xong, Claude mở màn hình cấp quyền của SePay. Nếu bạn đóng màn hình này, lần đầu hỏi về dữ liệu SePay, Claude hiện dòng Cần xác thực để dùng công cụ này (Authentication required to use this tool) kèm nút Kết nối (Connect): chọn Kết nối (Connect) để mở lại.

Trên màn hình Claude 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.

Cấp quyền xong, SePay có trong ảnh đại diện ở góc dưới bên trái → Cài đặt (Settings) → Trình kết nối (Connectors). Chọn SePay rồi mở tab Quyền (Permissions). Ở mục Quyền công cụ (Tool permissions), bạn chọn Claude được tự dùng từng công cụ SePay hay phải hỏi bạn trước.

Hỏi thử Claude về dữ liệu SePay
Mở một cuộc trò chuyện mới và hỏi, ví dụ: "Báo cáo dòng tiền theo từng tháng của tôi trên SePay". Claude trả về tổng tiền vào, tiền ra của từng tháng nghĩa là kết nối đã chạy.
Ngắt kết nối Claude
- Trong Claude: ảnh đại diện ở góc dưới bên trái → Cài đặt (Settings) → Trình kết nối (Connectors), chọn SePay, bấm nút ⋯ ở góc trên bên phải rồi chọn Ngắt kết nối (Disconnect).
- Trên SePay: thu hồi kết nối Claude ở 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
- Dùng SePay MCP trên dòng lệnh với Claude Code.
- Thêm SePay Skills vào Claude để Claude hướng dẫn tích hợp SePay theo đúng tài liệu.
- Xem câu hỏi mẫu cho từng loại dữ liệu ở Danh sách tool SePay MCP.