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. Máy chủ MCP Dodo Payments được xây dựng bằng Stainless và sử dụng kiến trúc Code Mode, cho phép các tác nhân AI viết và thực thi mã TypeScript chống lại SDK Dodo Payments trong một môi trường sandbox cách ly.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ách hoạt động của Code Mode
Máy chủ MCP Dodo Payments sử dụng Code Mode, cung cấp cho tác nhân AI của bạn hai công cụ mạnh mẽ:- Công cụ Tìm kiếm Tài liệu: Truy vấn tài liệu về API và SDK Dodo Payments để hiểu các hoạt động và tham số có sẵn
- Công cụ Thực thi Mã: Viết mã TypeScript chống lại SDK mà thực thi trong một môi trường sandbox an toàn mà không có quyền truy cập web hoặc hệ thống tệp
Dodo Knowledge MCP
Ngoài Dodo Payments MCP Server (để thực hiện các thao tác API), chúng tôi cung cấp Dodo Knowledge MCP - một máy chủ tìm kiếm ngữ nghĩa giúp các trợ lý AI truy cập ngay lập tức vào tài liệu và cơ sở kiến thức của Dodo Payments.Được xây dựng với ContextMCP.ai: Dodo Knowledge MCP được hỗ trợ bởi ContextMCP, cho phép tìm kiếm ngữ nghĩa nhanh chóng trong tài liệu của chúng tôi bằng cách sử dụng vector embeddings.
Dodo Knowledge MCP là gì?
Dodo Knowledge MCP là một máy chủ MCP từ xa cung cấp:- Tìm kiếm tài liệu ngữ nghĩa: Tìm tài liệu liên quan bằng cách sử dụng các truy vấn ngôn ngữ tự nhiên
- Câu trả lời theo ngữ cảnh: Các trợ lý AI nhận được thông tin chính xác, cập nhật về Dodo Payments
- Không cần thiết lập: Không cần khóa API hoặc cài đặt cục bộ - chỉ cần kết nối và bắt đầu truy vấn
Thiết lập nhanh
Kết nối với Dodo Knowledge MCP trong khách hàng AI của bạn:- Con trỏ
- Claude Desktop
- Lướt ván
- Claude Code
Thêm vào
~/.cursor/mcp.json:Yêu cầu Node.js 18 hoặc cao hơn. Gói
mcp-remote xử lý kết nối đến máy chủ MCP từ xa.Sử dụng cả hai máy chủ MCP cùng nhau
Để có trải nghiệm phát triển hỗ trợ AI tốt nhất, chúng tôi khuyên bạn nên sử dụng cả hai máy chủ MCP:| Máy chủ | Mục đích | Trường hợp sử dụng |
|---|---|---|
| Dodo Knowledge MCP | Tìm kiếm tài liệu | ”Làm thế nào để tôi xử lý webhooks?”, “Những phương thức thanh toán nào được hỗ trợ?” |
| Dodo Payments MCP | Thao tác API | Tạo thanh toán, quản lý đăng ký, xử lý hoàn tiền |
Khắc phục sự cố Knowledge MCP
Nếu bạn gặp sự cố kết nối:- Xóa bộ nhớ cache xác thực MCP:
rm -rf ~/.mcp-auth - Khởi động lại ứng dụng khách của bạn
- Kiểm tra nhật ký của khách hàng để tìm thông báo lỗi
- Xác minh phiên bản Node.js: Yêu cầu Node.js 18+
Knowledge MCP Server
Truy cập trang cấu hình Dodo Knowledge MCP
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 (Được 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.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.
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:
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 (thử nghiệm hoặc trực tiếp)
- Chọn loại khách hàng MCP của 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ần 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ủ Dodo Payments MCP trong khách hàng AI mà bạn ưa thích.- Cursor
- Claude Desktop
- Claude Code
- VS Code
- Cline (VS Code)
- Zed
- Khách hàng khác
Thiết lập máy chủ Dodo Payments MCP trong Cursor để cho phép truy cập hội thoại vào dữ liệu thanh toán của bạn.Cài đặt một lần nhấpSử dụng nút bên dưới để cài đặt máy chủ MCP trực tiếp trong Cursor:[
](https://cursor.com/en-US/install-mcp?name=dodopayments-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImRvZG9wYXltZW50cy1tY3AiXSwiZW52Ijp7IkRPRE9fUEFZTUVOVFNfQVBJX0tFWSI6IlNldCB5b3VyIERPRE9fUEFZTUVOVFNfQVBJX0tFWSBoZXJlLiIsIkRPRE9fUEFZTUVOVFNfV0VCSE9PS19LRVkiOiJTZXQgeW91ciBET0RPX1BBWU1FTlRTX1dFQkhPT0tfS0VZIGhlcmUuIn19)Sau khi nhấp, hãy thiết lập các biến môi trường của bạn trong
mcp.json của Cursor qua Cài đặt Cursor > Công cụ & MCP > Máy chủ MCP mới.Cấu hình thủ côngMở 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”.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 (Được khuyến nghị)Local NPX
Biến môi trường
Cấu hình hành vi của máy chủ MCP bằng cách sử dụng các biến môi trường.| Biến | Mô tả | Bắt buộc |
|---|---|---|
DODO_PAYMENTS_API_KEY | Khóa API Dodo Payments của bạn | Có |
DODO_PAYMENTS_WEBHOOK_KEY | Khóa ký webhook của bạn | Không |
DODO_PAYMENTS_ENVIRONMENT | Đặt thành live_mode cho sản xuất | Không |
Chạy từ xa
Triển khai máy chủ MCP như một máy chủ HTTP từ xa cho các khách hàng dựa trên web hoặc quy trình agentic.Cấu hình máy chủ từ xa
Khi đã triển khai, các khách hàng có thể kết nối bằng cách sử dụng URL máy chủ:Tiêu đề ủy quyền
Máy chủ từ xa chấp nhận xác thực qua các tiêu đề sau:| Tiêu đề | Mô tả |
|---|---|
Authorization | Xác thực token Bearer |
x-dodo-payments-api-key | Tiêu đề khóa API trực tiếp |
Khả năng của khách hàng
Các khách hàng MCP khác nhau có mức độ hỗ trợ khác nhau cho thông số kỹ thuật MCP. Máy chủ có thể tự động điều chỉnh các sơ đồ công cụ để làm việc xung quanh những hạn chế này.Các cài đặt khách hàng có sẵn
| Khách hàng | Mô tả |
|---|---|
infer | Tự động phát hiện khách hàng (mặc định) |
cursor | Trình soạn thảo Cursor |
claude | Claude AI web hoặc desktop |
claude-code | Claude Code CLI |
openai-agents | Nền tảng đại lý OpenAI |
Cấu hình khả năng thủ công
Đối với các khách hàng không được liệt kê ở trên, hãy cấu hình khả năng một cách thủ công:top-level-unions- Hỗ trợ cho các loại union cấp cao nhấtvalid-json- Phân tích đối số chuỗi JSON chính xácrefs- Hỗ trợ cho các con trỏ $ref trong các sơ đồunions- Hỗ trợ cho các loại union (anyOf)formats- Hỗ trợ cho các xác thực định dạngtool-name-length=N- Độ dài tối đa tên công cụ
Lọc công cụ
Kiểm soát các thao tác API nào được hiển thị cho trợ lý AI của bạn để tối ưu hóa hiệu suất và duy trì bảo mật.Lọc theo loại thao tác
Hạn chế quyền truy cập vào các thao tác chỉ đọ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ẻ 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.Lọc tham số truy vấn URL (Máy chủ từ xa)
Khi sử dụng máy chủ từ xa, áp dụng bộ lọc qua các tham số truy vấn URL:Chế độ công cụ động
Đối với các API lớn, việc tải tất cả các công cụ cùng một lúc có thể làm quá tải cửa sổ ngữ cảnh của AI. Chế độ công cụ động cung cấp một lựa chọn hiệu quả hơn.list_api_endpoints- Khám phá các phương thức có sẵn với bộ lọc tùy chọnget_api_endpoint_schema- Nhận sơ đồ chi tiết cho một phương thức cụ thểinvoke_api_endpoint- Thực thi bất kỳ phương thức nào với các tham số thích hợp
Các công cụ động được tự động kích hoạt cho các API có hơn 50 phương thức. Ghi đè bằng
--tools=all để bao gồm tất cả các công 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 các 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 thử nghiệm cho phát triểnLuôn sử dụng khóa API chế độ thử nghiệm 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 thao tác được hiển thị 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 máy chủ từ xaKhi triển khai từ xa, luôn yêu cầu xác thực qua tiêu đề
Authorization hoặc tiêu đề x-dodo-payments-api-key.Theo dõi việc sử dụng APITheo dõi hoạt động của 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.Bảo mật mạng
Bảo mật 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 xét 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 các khóa thử nghiệm với các điểm cuối thử nghiệm và các khóa trực tiếp với các điểm cuối sản xuất.Kiểm tra biến môi trườngXác minh rằng
DODO_PAYMENTS_ENVIRONMENT được thiết lập chính xác (live_mode cho sản xuất).Tạo lại thông tin xác thựcNếu các 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 xét 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 thao tác hoạt động khi gọi API Dodo Payments trực tiếp qua curl hoặc Postman.
Vấn đề tương thích khách hàng
Vấn đề tương thích khách hàng
Thử một cài đặt khách hàng khácNếu các công cụ không hoạt động đúng cách, hãy thử chỉ định khách hàng của bạn một cách rõ ràng:Kiểm tra hỗ trợ khả năngMột số khách hàng không hỗ trợ tất cả các tính năng của sơ đồ JSON. Sử dụng
--describe-capabilities để hiểu những gì được hỗ trợ.