Skip to main content

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:
  1. 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ó.
  2. Code Execution Tool — Viết mã TypeScript trên SDK và thực thi trong một sandbox an toàn.
Kiến trúc này cho phép các agent thực hiện những operations phức tạp, gồm nhiều bước, chỉ trong một invocation. Ví dụ, một agent có thể liệt kê tất cả subscriptions đang active, lọc theo tiêu chí rồi áp dụng discount cho từng subscription — tất cả trong một script.
Các agent có thể chain nhiều API calls, xử lý conditional logic và thực hiện calculations mà không cần round-trip trở lại LLM.

Quick Setup

Connect to the Dodo Payments MCP Server in your AI client:
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:
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:
Khi cả hai servers được cấu hình, agent của bạn có thể tìm kiếm tài liệu để hiểu một feature, sau đó thực thi các API calls để triển khai feature đó — tất cả trong một conversation.

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ằng rm -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
Bảo mật API key của bạn. Sử dụng test mode keys trong quá trình development.
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.
Local server chạy code của bạn trong một Deno sandbox. Cài đặt Deno 2.8 hoặc sớm hơn và đảm bảo deno có trong PATH; sandbox sẽ không khởi động được trên Deno 2.9 trở lên. Local code execution chỉ hoạt động trên macOS và Linux. Trên Windows, hãy sử dụng remote server hoặc chạy local server dưới WSL2.
Sử dụng @latest để luôn lấy version mới nhất, hoặc pin vào một version cụ thể như @2.51.0 để đảm bảo tính ổn định.

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.
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:[Thêm vào 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ông
1

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.
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.
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.
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ố

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.
Đả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.
Đả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
Lần sửa đổi cuối 26 tháng 9, 2026