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

Hướng dẫn kết nối Claude với SePay qua MCP trên claude.ai và ứng dụng Claude cho máy tính, để tra cứu giao dịch, tài khoản ngân hàng, webhook...

||

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

  1. Một tài khoản Claude, gói nào cũng được.
  2. 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.
  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 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

  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.

Trang Tạo kết nối mở ra. Ở cột Bạn dùng ứng dụng AI nào?, chọn Claude:

  1. Địa chỉ SePay (https://my.sepay.vn/mcp): dán vào Claude ở Bước 3.
  2. 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.

Trang Tạo kết nối trên my.sepay.vn đang chọn Claude, hiện địa chỉ SePay và Client ID
Nhấn để phóng to
Chọn Claude để lấy địa chỉ SePay và Client ID.

Bước 2: Mở hộp thoại thêm connector trong Claude

  1. 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.
  2. Chọn Cài đặt (Settings).
Menu ảnh đại diện ở góc dưới bên trái của Claude đang mở, có mục Cài đặt
Nhấn để phóng to
Chọn ảnh đại diện rồi chọn Cài đặt.

Trong cửa sổ Cài đặt (Settings):

  1. Ở menu bên trái, chọn Trình kết nối (Connectors).
  2. Chọn Thêm (Add).
  3. Chọn Thêm trình kết nối tùy chỉnh (Add custom connector).
Mục Trình kết nối trong Cài đặt của Claude, menu Thêm đang mở với lựa chọn Thêm trình kết nối tùy chỉnh
Nhấn để phóng to
Chọn Trình kết nối, Thêm rồi Thêm trình kết nối tùy chỉnh.

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):

  1. Ở ô đầu tiên, đặt tên dễ nhận ra, ví dụ SePay.
  2. Ở ô thứ hai, dán MCP Server URL từ SePay: https://my.sepay.vn/mcp.
  3. Chọn Tiếp tục (Continue).
Hộp thoại Thêm trình kết nối tùy chỉnh của Claude đã điền tên SePay và địa chỉ máy chủ SePay MCP
Nhấn để phóng to
Đặt tên SePay, dán https://my.sepay.vn/mcp rồi chọn Tiếp tục.

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:

  1. Ở mục Xác thực (Authentication), chọn Đăng nhập ngay (Sign in now).
  2. Ở 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).
  3. 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).
  4. Kéo xuống cuối hộp thoại, chọn Thêm (Add).
Phần xác thực trong hộp thoại Thêm trình kết nối tùy chỉnh của Claude chọn Đăng nhập ngay, Dùng ứng dụng khách OAuth của riêng bạn và Client ID sepay-claude
Nhấn để phóng to
Chọn Đăng nhập ngay, Dùng ứng dụng khách OAuth của riêng bạn rồi dán Client ID sepay-claude.

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.

Cuộc trò chuyện Claude hiện dòng Cần xác thực để dùng công cụ này và nút Kết nối khi gọi công cụ SePay MCP
Nhấn để phóng to
Chọn Kết nối để mở màn hình cấp quyền của SePay.

Trên màn hình Claude 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 Claude: 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 Claude được đọc rồi chọn Đồng ý cấp quyền.

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.

Trang trình kết nối SePay trong Cài đặt của Claude, tab Quyền: số 1 ở mục Quyền công cụ với nhóm Công cụ chỉ đọc 19, số 2 ở mục Ngắt kết nối trong menu ⋯
Nhấn để phóng to
Chỉnh quyền dùng từng công cụ ở Quyền công cụ (1). Ngắt kết nối ở menu ⋯ (2).

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