Kết nối trợ lý AI của bạn.

Máy chủ của bạn. Một URL MCP.

Có sẵn trong phần mềm nhà bán hàng 5.0.0+. Không cần daemon bổ sung, môi trường chạy Node.js hay relay được lưu trữ bên ngoài. Dùng tên miền API đã cấu hình của bản cài đặt, ví dụ https://api.example.com/mcp.

1. Mở Cài đặt → Truy cập API. Tạo thông tin xác thực riêng và gán các dự án mà trợ lý cần. Bắt đầu với quyền chỉ đọc.
2. Trong Kết nối AI · MCP, bật MCP. Chọn thông tin xác thực, chọn Chỉ đọc và lưu.
3. Thêm URL được hiển thị vào cài đặt HTTP/MCP từ xa của trợ lý.
4. Với OAuth, đăng nhập bảng điều khiển nhà bán hàng. Xem lại tên ứng dụng khách, địa chỉ trả về và quyền của thông tin xác thực, rồi phê duyệt. Basic Auth và TOTP hiện có vẫn áp dụng.

{
  "mcpServers": {
    "whollycrypto": {
      "url": "https://api.example.com/mcp"
    }
  }
}

Thay tên miền ví dụ. Định dạng cấu hình khác nhau tùy ứng dụng khách; chọn Streamable HTTP, không phải lệnh cục bộ hay URL SSE cũ.

Hỏi về các khoản thanh toán của bạn.

• “Hiển thị các hóa đơn chưa thanh toán mới nhất của cửa hàng tôi.”
• “Cửa hàng này có thể chấp nhận những tài sản nào?”
• “Kiểm tra số dư ví và những lần gửi webhook thất bại.”
• “Tạo hóa đơn 25 EUR cho đơn hàng 1042.” Cần quyền tạo hóa đơn.

Tám công cụ đọc bao quát dự án, cửa hàng, phương thức thanh toán, ví, hóa đơn, lịch sử gửi và chuyển đổi được lưu đệm. Công cụ thứ chín tùy chọn tạo hóa đơn theo quy tắc API hiện có.

Kết quả có ID dự án và cửa hàng. Số tiền vẫn là chuỗi thập phân. Tỷ giá và số dư lưu đệm giữ thông tin về độ mới; phép chuyển đổi không phải báo giá hóa đơn được bảo đảm.

Chọn những gì trợ lý được truy cập.

MCP mặc định tắt, kể cả sau nâng cấp. Khóa API hiện có không tự được cấp quyền. Trợ lý chỉ thấy các dự án được phê duyệt; giới hạn IP và giới hạn tần suất REST của thông tin xác thực cũng áp dụng cho MCP.

Để tạo hóa đơn, chọn thông tin xác thực đọc/ghi và Đọc + tạo hóa đơn. Ứng dụng khách OAuth phải yêu cầu mcp:invoice:create, và bạn phải đánh dấu Cũng cho phép tạo hóa đơn khi phê duyệt.

Dùng lại cùng idempotency_key và nội dung hóa đơn sau khi hết thời gian chờ. Khóa mới tạo hóa đơn mới. Các quy tắc thông thường về chênh lệch, dung sai, thanh toán và tín dụng vẫn áp dụng.

Không có công cụ xuất khóa hay gửi tiền. MCP không thể tiết lộ cụm từ khôi phục, gửi tiền, gom tiền, hoàn tiền, gửi lại callback hay thay đổi tài khoản, tên miền và thanh toán dịch vụ.

Chỉ phê duyệt ứng dụng khách bạn nhận ra. Tên ứng dụng khách không được xác minh. Nhà cung cấp AI nhận thông tin bạn cho phép đọc, bao gồm dữ liệu khách hàng do công cụ hóa đơn trả về.

Nếu kết nối thất bại.

• 404: bật MCP và dùng máy chủ API, không phải máy chủ bảng điều khiển hay trang thanh toán.
• 401: kết nối lại bằng OAuth hoặc kiểm tra thông tin xác thực bearer còn hợp lệ.
• 403: kiểm tra quyền của thông tin xác thực, các dự án được phê duyệt, giới hạn origin và IP nguồn.
• 405 khi GET: đây là hành vi dự kiến. Endpoint không trạng thái này dùng POST và phản hồi JSON hữu hạn, không có luồng SSE độc lập.
• 429: chờ theo Retry-After. MCP và REST dùng chung hạn mức của thông tin xác thực.
• Không thể tạo hóa đơn: kiểm tra toàn bộ quyền ghi, trạng thái dự án/cửa hàng, mức sẵn sàng thanh toán và xác minh tài khoản tín dụng.

Tắt bộ nhớ đệm Cloudflare và thử thách tương tác cho /mcp, /mcp/oauth/* và các đường dẫn khám phá OAuth. Danh sách IP cho phép phải có địa chỉ đầu ra được công bố của dịch vụ trợ lý.

Các phiên bản giao thức được hỗ trợ: 2025-11-25, 2025-06-18 và 2025-03-26. Ứng dụng khách phải hỗ trợ một trong các phiên bản này. Xem Tài liệu tham chiếu API để biết từng công cụ, endpoint và định dạng lỗi.

Chọn phương thức thanh toán cho từng hóa đơn.

Dùng invoice.payment_methods với chain_slug: "ethereum" và asset_tickers: ["USDC", "USDT"]. Tìm slug và mã tài sản trong Phương thức thanh toán của cửa hàng hoặc bằng list_payment_methods.

Merchant 5.4.0+ bỏ qua lựa chọn không hoạt động hoặc không được chấp nhận. Nếu không có lựa chọn nào khớp, áp dụng mặc định của cửa hàng. Chỉ chọn chuỗi sẽ bao gồm mọi tài sản đang hoạt động được chấp nhận. Mã tài sản dùng chung cần giá trị chính xác asset_ids. Vẫn kiểm tra mức sẵn sàng và tỷ giá, với lỗi riêng cho từng chuỗi. Lightning tách biệt; mảng lựa chọn rỗng không hợp lệ. Định dạng yêu cầu →