Overview
Model Context Protocol (MCP) là một tiêu chuẩn mở cho phép các ứng dụng AI kết nối với các nguồn dữ liệu và API bên ngoài. Dodo Payments MCP Server cung cấp cho các trợ lý AI như Claude, Cursor và các client tương thích MCP khác quyền truy cập vào hạ tầng thanh toán của bạn. Dodo Payments MCP Server sử dụng kiến trúc Code Mode. Thay vì cung cấp hàng trăm tools riêng lẻ cho từng API endpoint, Code Mode cho phép các AI agent viết và thực thi mã TypeScript trên Dodo Payments SDK trong một sandbox biệt lập.Các khả năng chính
- Payment Operations — Tạo, truy xuất và quản lý payments và refunds
- Subscription Management — Xử lý billing định kỳ, nâng cấp và hủy
- Customer Administration — Quản lý dữ liệu khách hàng và quyền truy cập portal
- Product Catalog — Tạo và cập nhật products, pricing và discounts
- License Management — Kích hoạt, xác thực và quản lý software licenses
- Usage-Based Billing — Theo dõi và tính phí theo mức sử dụng
How Code Mode Works
Dodo Payments MCP Server cung cấp cho AI agent của bạn hai tools:- Docs Search Tool — Truy vấn tài liệu về Dodo Payments API và SDK để hiểu các operations và parameters hiện có.
- Code Execution Tool — Viết mã TypeScript trên SDK và thực thi trong một sandbox an toàn.
Quick Setup
Connect to the Dodo Payments MCP Server in your AI client:- Agent Plugin (recommended)
- Cursor
- Claude Desktop
- Windsurf
- Claude Code
Dodo Agent Plugin cài đặt cả hai MCP servers và toàn bộ seventeen skills chỉ trong một bước cho Claude Code, Codex CLI, Cursor, VS Code / GitHub Copilot, Kiro và OpenCode (OpenCode cần thêm một
skills.paths setting). Gemini CLI chỉ nhận hai MCP servers vì không có agent-skill primitive. Xem AI Coding Agents guide để biết các lệnh cài đặt cho từng agent.If your agent isn’t in that list, use the tabs below to configure the MCP server directly.Yêu cầu Node.js 18 trở lên. Remote server sử dụng OAuth để authentication. Khi kết nối lần đầu, bạn sẽ được yêu cầu nhập API key và chọn environment.
Dodo Knowledge MCP
Ngoài Dodo Payments MCP Server (dùng để thực thi các API operations), chúng tôi cung cấp Dodo Knowledge MCP — một semantic search server giúp các trợ lý AI truy cập tức thì vào tài liệu Dodo Payments.Built with ContextMCP.ai: Dodo Knowledge MCP is powered by ContextMCP, enabling fast semantic search across our documentation using vector embeddings.
What is Dodo Knowledge MCP?
Dodo Knowledge MCP là một remote MCP server cung cấp semantic documentation search. Tìm tài liệu liên quan bằng natural language queries, nhận thông tin chính xác và cập nhật về Dodo Payments, đồng thời kết nối mà không cần API keys hoặc local installation.Quick Setup
Kết nối với Dodo Knowledge MCP trong AI client của bạn:- Cursor
- Claude Desktop
- Windsurf
- Claude Code
Thêm vào
~/.cursor/mcp.json:Yêu cầu Node.js 18 trở lên. Package
mcp-remote xử lý kết nối với remote MCP server.Sử dụng đồng thời cả hai MCP Servers
Để có trải nghiệm phát triển được AI hỗ trợ tốt nhất, hãy sử dụng cả hai MCP servers:Khắc phục sự cố Dodo Knowledge MCP
Nếu gặp vấn đề kết nối, hãy xóa MCP authentication cache bằngrm -rf ~/.mcp-auth, khởi động lại client application, kiểm tra client logs để tìm error messages và xác minh phiên bản Node.js (yêu cầu 18+).
Knowledge MCP Server
Truy cập trang cấu hình Dodo Knowledge MCP
Cài đặt
Chọn phương thức cài đặt phù hợp với workflow của bạn.Remote MCP Server (Khuyến nghị)
Truy cập MCP server được host mà không cần local setup hoặc installation.1
Access the remote server
Mở https://mcp.dodopayments.com trong browser.
2
Configure your MCP client
Sao chép JSON configuration được cung cấp cho client cụ thể của bạn. Với Cursor hoặc Claude Desktop, hãy thêm configuration này vào MCP settings:
3
Authenticate and configure
OAuth flow sẽ yêu cầu bạn:
- Nhập Dodo Payments API key
- Chọn environment (test hoặc live)
- Chọn loại MCP client
4
Complete setup
Nhấp Login and Approve để authorize connection.
Sau khi kết nối, AI assistant có thể tương tác với Dodo Payments API thay mặt bạn.
NPM Package
Cài đặt và chạy MCP server locally.- NPX (No Installation)
- MCP Client Configuration
Docker
Chạy MCP server trong một container.Docker images có sẵn trên GitHub Container Registry.
Cấu hình Client
Cấu hình máy chủ Dodo Payments MCP trong AI client ưa thích của bạn.- Cursor
- Claude Desktop
- Claude Code
- VS Code
- Cline (VS Code)
- Zed
- Other Clients
Thiết lập máy chủ Dodo Payments MCP trong Cursor để bật quyền truy cập vào dữ liệu thanh toán của bạn thông qua hội thoại.Cài đặt bằng một cú nhấpSử dụng nút bên dưới để cài đặt trực tiếp máy chủ MCP 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 trong
mcp.json của Cursor thông qua Cursor Settings > Tools & MCP > New MCP Server.Cấu hình thủ công1
Open Cursor settings
Điều hướng đến Cursor Settings > Tools & MCP hoặc nhấn
Cmd/Ctrl + Shift + P và tìm kiếm “MCP Settings”.2
Edit configuration
Nhấp vào New MCP Server để mở tệp
mcp.json.3
Add Dodo Payments configuration
Chọn một trong các cấu hình sau:Remote Server (Recommended)Local NPX
4
Save and restart
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 AI assistant về dữ liệu Dodo Payments của bạn.
Biến môi trường
Định cấu hình hoạt động của máy chủ MCP bằng các biến môi trường.Chạy từ xa
Triển khai máy chủ MCP dưới dạng HTTP server từ xa cho các client web hoặc quy trình agentic.Cấu hình Remote Server
Sau khi triển khai, client có thể kết nối bằng URL máy chủ:Authorization Headers
Remote server chấp nhận xác thực thông qua các header sau:Các phương pháp bảo mật tốt nhất
Code Mode cung cấp tính bảo mật vốn có bằng cách thực thi code trong môi trường sandbox và inject API key ở phía server. Hãy tuân thủ các phương pháp tốt nhất sau để bảo vệ thông tin xác thực của bạn.API Key Management
API Key Management
Không bao giờ commit thông tin xác thực vào hệ thống kiểm soát phiên bản. Lưu API key trong các biến môi trường hoặc hệ thống quản lý secret bảo mật:Thường xuyên xoay vòng key bằng cách định kỳ tạo API key mới và thu hồi key cũ thông qua dashboard Dodo Payments. Luôn sử dụng API key ở test mode trong quá trình phát triển để tránh ảnh hưởng đến dữ liệu production.
Access Control
Access Control
Khi triển khai từ xa, luôn yêu cầu xác thực thông qua header
Authorization hoặc header x-dodo-payments-api-key.Network Security
Network Security
Luôn triển khai remote MCP server phía sau các endpoint HTTPS. Bảo vệ khỏi lạm dụng bằng cách triển khai rate limit ở cả cấp MCP server và API. Cấu hình quy tắc firewall để giới hạn các client có thể kết nối đến MCP server.
Khắc phục sự cố
Connection issues
Connection issues
Xác minh API key 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 để đảm bảo bạn có thể truy cập các endpoint Dodo Payments API. Bật verbose logging trong MCP client để chẩn đoán sự cố kết nối.
Authentication errors
Authentication errors
Đảm bảo bạn đang sử dụng test key với test endpoint và live key với production endpoint. Xác minh
DODO_PAYMENTS_ENVIRONMENT được thiết lập chính xác (live_mode cho production). Nếu sự cố vẫn tiếp diễn, hãy tạo API key mới thông qua dashboard.Tool execution failures
Tool execution failures
Đảm bảo AI assistant cung cấp các parameter được định dạng chính xác cho từng tool. Kiểm tra error response từ API để biết hướng dẫn cụ thể về nguyên nhân lỗi. Xác minh thao tác hoạt động khi gọi trực tiếp Dodo Payments API qua curl hoặc Postman.
Tại sao nên dùng Code Mode
Các triển khai MCP truyền thống gặp phải vấn đề “tool proliferation”, trong đó mỗi API endpoint được cung cấp dưới dạng một tool riêng. Code Mode tốt hơn vì một số lý do sau:LLM viết code tốt hơn gọi tool
LLM được đào tạo trên hàng triệu dòng code thực tế, vì vậy chúng tự nhiên viết script tốt. Việc gọi tool thường dựa trên các ví dụ tổng hợp.“Bắt một LLM thực hiện tác vụ bằng cách gọi tool cũng giống như đưa Shakespeare tham gia một lớp học tiếng Quan Thoại kéo dài một tháng rồi yêu cầu ông viết một vở kịch bằng ngôn ngữ đó.” — Cloudflare
Loại bỏ tình trạng phình to context window
Trong các phương pháp truyền thống, mỗi định nghĩa tool đều tiêu tốn token trước khi cuộc hội thoại bắt đầu. Việc cung cấp hơn 50 tool có thể tiêu tốn 55K–100K+ token. Anthropic phát hiện rằng các định nghĩa tool có thể tiêu tốn tới 134K token trước khi tối ưu hóa. Code Mode chỉ tải 2 định nghĩa tool (~1K token). Agent tìm kiếm tài liệu khi cần. Tool Search Tool của Anthropic giữ lại 95% context window, giảm overhead từ 77K xuống 8.7K token.Giảm độ trễ thông qua điều phối bằng code
Việc gọi tool truyền thống yêu cầu một vòng suy luận đầy đủ của model cho mỗi thao tác. Nếu một tác vụ cần 20 API call thì sẽ có 20 vòng khứ hồi. Trong Code Mode, agent viết một script thực thi tất cả call và chỉ trả về kết quả cuối cùng. Anthropic ghi nhận mức giảm 37% số token và độ chính xác được cải thiện (khả năng truy xuất kiến thức tăng từ 25.6% lên 28.5%) khi sử dụng phương pháp này.Bảo mật hơn ngay từ thiết kế
Code Mode mang lại các lợi ích bảo mật vốn có:- Không có API key trong parameter — API key được inject ở phía server và không bao giờ xuất hiện trong các parameter của tool gửi đến LLM.
- Sandbox cô lập — Code chạy trong môi trường bảo mật, không có quyền truy cập mạng hoặc filesystem của host.
- SDK được kiểm soát — Agent chỉ có thể sử dụng các phương thức SDK được cấp quyền.
Mở rộng theo mọi quy mô API
Khi API phát triển, hiệu suất MCP truyền thống suy giảm vì phải tải thêm nhiều tool. Code Mode vẫn duy trì ở mức cố định với 2 tool bất kể quy mô API. Cloudflare đã hợp nhất hơn 2.500 API endpoint thành 2 tool và khoảng 1.000 token context.Để biết thêm chi tiết, hãy xem các blog kỹ thuật từ Anthropic và Cloudflare, cùng tài liệu Programmatic Tool Calling của Claude.
Tài nguyên
API Reference
Khám phá tài liệu Dodo Payments API đầy đủ
MCP Protocol
Tìm hiểu thêm về tiêu chuẩn Model Context Protocol
GitHub Repository
Xem source code của MCP server và đóng góp
NPM Package
Cài đặt MCP server từ NPM