Tổng quan
Giao thức Ngữ cảnh Mô hình (MCP) là một tiêu chuẩn mở cho phép các ứng dụng AI kết nối an toàn với các nguồn dữ liệu và API bên ngoài. Máy chủ MCP Dodo Payments cung cấp cho các trợ lý AI như Claude, Cursor và các khách hàng tương thích với MCP khác quyền truy cập có cấu trúc vào hạ tầng thanh toán của bạn.Các khả năng chính
- Hoạt động thanh toán: Tạo, truy xuất và quản lý thanh toán và hoàn tiền
- Quản lý đăng ký: Xử lý thanh toán định kỳ, nâng cấp và hủy bỏ
- Quản lý khách hàng: Quản lý dữ liệu khách hàng và quyền truy cập cổng thông tin
- Danh mục sản phẩm: Tạo và cập nhật sản phẩm, giá cả và giảm giá
- Quản lý giấy phép: Kích hoạt, xác thực và quản lý giấy phép phần mềm
- Thanh toán dựa trên mức sử dụng: Theo dõi và lập hóa đơn cho mức sử dụng theo chỉ số
Cài đặt
Chọn phương pháp cài đặt phù hợp nhất với quy trình làm việc của bạn.Máy chủ MCP từ xa (Khuyến nghị)
Truy cập máy chủ MCP được lưu trữ mà không cần thiết lập hoặc cài đặt cục bộ. Đây là cách nhanh nhất để bắt đầu.1
Truy cập máy chủ từ xa
Điều hướng đến https://mcp.dodopayments.com trong trình duyệt của bạn.
2
Cấu hình khách hàng MCP của bạn
Sao chép cấu hình JSON được cung cấp cho khách hàng cụ thể của bạn. Đối với Cursor hoặc Claude Desktop, thêm điều này vào cài đặt MCP của bạn:
3
Xác thực và cấu hình
Quy trình OAuth sẽ yêu cầu bạn:
- Nhập khóa API Dodo Payments của bạn
- Chọn môi trường của bạn (kiểm tra hoặc trực tiếp)
- Chọn loại khách hàng MCP của bạn
4
Hoàn tất thiết lập
Nhấp vào Đăng nhập và Phê duyệt để ủy quyền kết nối.
Khi đã kết nối, trợ lý AI của bạn có thể tương tác với API Dodo Payments thay mặt bạn.
Gói NPM
Cài đặt và chạy máy chủ MCP cục bộ bằng NPM.- NPX (Không Cài Đặt)
- Cấu hình Khách hàng MCP
Docker
Chạy máy chủ MCP trong môi trường container hóa để triển khai nhất quán.Hình ảnh Docker có sẵn trên GitHub Container Registry.
Cấu hình Khách hàng
Cấu hình máy chủ MCP Dodo Payments trong khách hàng AI mà bạn ưa thích.- Cursor
- Claude Desktop
- Cline (VS Code)
- Zed
- Khách hàng khác
Thiết lập máy chủ MCP Dodo Payments trong Cursor để cho phép truy cập hội thoại vào dữ liệu thanh toán của bạn.
1
Mở cài đặt Cursor
Điều hướng đến Cài đặt Cursor > Tính năng > Giao thức Ngữ cảnh Mô hình hoặc nhấn
Cmd/Ctrl + Shift + P và tìm kiếm “Cài đặt MCP”.2
Chỉnh sửa cấu hình
Nhấp vào Chỉnh sửa Cấu hình để mở tệp
mcp_config.json.3
Thêm cấu hình Dodo Payments
Chọn một trong các cấu hình sau:Máy chủ từ xa (Khuyến nghị)Local NPX
4
Lưu và khởi động lại
Lưu tệp cấu hình và khởi động lại Cursor.
Xác minh kết nối bằng cách hỏi trợ lý AI về dữ liệu Dodo Payments của bạn.
Lọc công cụ
Kiểm soát các hoạt động API nào được công khai cho trợ lý AI của bạn để tối ưu hóa hiệu suất và duy trì an ninh.Lọc theo loại hoạt động
Hạn chế quyền truy cập chỉ cho các hoạt động đọc hoặc ghi.Lọc theo tài nguyên
Giới hạn các công cụ cho các tài nguyên API cụ thể.Bao gồm hoặc loại trừ các công cụ cụ thể
Tinh chỉnh các công cụ riêng lẻ nào có sẵn.Kết hợp các bộ lọc
Áp dụng nhiều bộ lọc đồng thời để kiểm soát chính xác.Sử dụng nâng cao
Tích hợp lập trình
Xây dựng các máy chủ MCP tùy chỉnh hoặc mở rộng máy chủ hiện có một cách lập trình.Phát triển công cụ tùy chỉnh
Mở rộng máy chủ MCP với các công cụ và logic kinh doanh của riêng bạn.Thực hành bảo mật tốt nhất
Bảo vệ thông tin xác thực API của bạn và duy trì các tích hợp an toàn.Quản lý Khóa API
Quản lý Khóa API
Không bao giờ cam kết thông tin xác thực vào kiểm soát phiên bảnLưu trữ khóa API trong các biến môi trường hoặc hệ thống quản lý bí mật an toàn.Thay đổi khóa thường xuyênTạo khóa API mới định kỳ và thu hồi các khóa cũ thông qua bảng điều khiển Dodo Payments của bạn.Sử dụng khóa kiểm tra cho phát triểnLuôn sử dụng khóa API chế độ kiểm tra trong quá trình phát triển để tránh ảnh hưởng đến dữ liệu sản xuất.
Kiểm soát Truy cập
Kiểm soát Truy cập
Áp dụng lọc công cụ trong sản xuấtGiới hạn các hoạt động được công khai chỉ cho những gì trợ lý AI của bạn cần.Thực hiện xác thực cho các điểm cuối tùy chỉnhXác thực các yêu cầu và thực thi ủy quyền trong các trình xử lý công cụ tùy chỉnh của bạn.Theo dõi việc sử dụng APITheo dõi hoạt động máy chủ MCP thông qua bảng điều khiển Dodo Payments của bạn và thiết lập cảnh báo cho các mẫu bất thường.
An ninh Mạng
An ninh Mạng
Sử dụng HTTPS cho các máy chủ từ xaLuôn triển khai các máy chủ MCP từ xa phía sau các điểm cuối HTTPS.Thực hiện giới hạn tỷ lệBảo vệ chống lại lạm dụng bằng cách thực hiện giới hạn tỷ lệ ở cả cấp máy chủ MCP và API.Hạn chế quyền truy cập mạngCấu hình các quy tắc tường lửa để giới hạn các khách hàng nào có thể kết nối với máy chủ MCP của bạn.
Khắc phục sự cố
Vấn đề kết nối
Vấn đề kết nối
Xác minh khóa API của bạnĐảm bảo khóa API của bạn được thiết lập chính xác và có các quyền cần thiết.Kiểm tra kết nối mạng của bạnXác minh rằng bạn có thể truy cập các điểm cuối API Dodo Payments.Xem nhật ký của khách hàngBật ghi nhật ký chi tiết trong khách hàng MCP của bạn để chẩn đoán các vấn đề kết nối.
Lỗi xác thực
Lỗi xác thực
Xác nhận môi trường khóa APIĐảm bảo bạn đang sử dụng khóa kiểm tra với các điểm cuối kiểm tra và khóa trực tiếp với các điểm cuối sản xuất.Kiểm tra quyền của khóaXác minh rằng khóa API của bạn có quyền cho các hoạt động mà bạn đang cố gắng thực hiện.Tạo lại thông tin xác thựcNếu vấn đề vẫn tiếp diễn, hãy tạo một khóa API mới thông qua bảng điều khiển của bạn.
Lỗi thực thi công cụ
Lỗi thực thi công cụ
Xác thực các tham số đầu vàoĐảm bảo trợ lý AI đang cung cấp các tham số được định dạng chính xác cho mỗi công cụ.Xem các thông báo lỗiKiểm tra phản hồi lỗi từ API để có hướng dẫn cụ thể về những gì đã sai.Kiểm tra trực tiếp với APIXác minh rằng hoạt động hoạt động khi gọi API Dodo Payments trực tiếp qua curl hoặc Postman.