- Dodo Payments API MCP server — quyền truy cập trực tiếp vào payments, subscriptions, customers, products, refunds, licenses và usage. Xác thực qua browser OAuth (không cần key cục bộ).
- Dodo Knowledge MCP server — tìm kiếm ngữ nghĩa trên toàn bộ tài liệu Dodo Payments. Không cần thông tin xác thực.
- Mười bảy agent skill — các bảng hướng dẫn nhanh được agent tải theo yêu cầu cho checkout, subscriptions, webhooks, billing dựa trên usage và credit, license keys, product catalog, discounts, localized pricing, mobile checkout, refunds và disputes, customer management, framework adapters, BillingSDK, Better Auth, testing và go-live, cùng các best practice.
Cài đặt Plugin
Chọn coding agent bên dưới. Mỗi cách cài đặt đều thêm cả hai máy chủ MCP. Tất cả agent ngoại trừ Gemini CLI cũng thêm mười bảy skill. OpenCode cần thêm một setting để tải các skill này, được mô tả trong phần tương ứng.Claude Code
Claude Code
Cài đặt từ marketplace:API MCP server mặc định sử dụng browser OAuth — không cần key khi cài đặt. Lần đầu agent gọi một công cụ Dodo, bạn sẽ được nhắc đăng nhập.
Dodo Agent Plugin on GitHub
Mã nguồn, các tùy chọn cấu hình và hướng dẫn phát triển cục bộ
Codex CLI
Codex CLI
Đăng ký marketplace, sau đó cài đặt từ Codex TUI.Cả hai máy chủ MCP và toàn bộ mười bảy skill sẽ được đăng ký tự động.Nếu plugin không xuất hiện trong
1
Register the marketplace
2
Install from the Codex TUI
Mở Codex và chạy Nhập
/plugins:/plugins, chuyển sang marketplace Dodo Payments, chọn plugin dodopayments, rồi chọn Install plugin./plugins, hãy làm mới plugin:Để cài đặt từ shell thay vì TUI, chạy
codex plugin add dodopayments@dodopayments sau khi đăng ký marketplace. Codex CLI không có subcommand codex plugin install. Xem tài liệu plugin Codex chính thức.Cursor
Cursor
Clone repo vào thư mục plugin cục bộ của Cursor:Khởi động lại Cursor. Plugin tải skill từ
skills/ và các máy chủ MCP từ .mcp.json.Các bản dựng Cursor gần đây nhận diện trực tiếp Agent Plugins 1.0.0 và chấp nhận .claude-plugin/marketplace.json làm nguồn marketplace. .cursor-plugin/plugin.json được tạo ra vẫn được giữ lại cho các bản dựng cũ hơn.Nếu bạn đã cài đặt phiên bản trước 0.5.0, hãy xóa thư mục rồi clone lại — skill hiện được cung cấp dưới dạng file thực, không phải symlink.OpenCode
OpenCode
Cài đặt package plugin trong project, sau đó thêm package và đường dẫn skill vào Khởi động lại OpenCode. Cả hai máy chủ MCP sẽ được đăng ký tự động. Skill cần thêm mục Bạn sẽ thấy đủ mười bảy skill. Đường dẫn skill không tồn tại sẽ bị bỏ qua trong im lặng, vì vậy hãy xác minh thay vì mặc định cho rằng chúng đã được tải.
opencode.json:skills.paths vì OpenCode không quét skill trong các package đã cài đặt.Đường dẫn tương đối được phân giải dựa trên thư mục project, vì vậy package phải tồn tại trong node_modules của project đó. Đường dẫn tuyệt đối cũng hoạt động và tránh yêu cầu cài đặt cục bộ.Xác minh các skill đã được tải:VS Code / GitHub Copilot
VS Code / GitHub Copilot
Clone repo và đăng ký repo:Mở chế độ xem Chat, đi tới Plugins, rồi thêm thư mục đã clone. Hoặc đăng ký trong Key là một đường dẫn, còn value bật plugin. Đường dẫn tuyệt đối và
settings.json:~/ đều hoạt động; đường dẫn tương đối được phân giải dựa trên từng thư mục workspace. Setting được đọc trực tiếp, nên cửa sổ đang chạy sẽ nhận setting mà không cần khởi động lại.chat.pluginLocations được đánh dấu là experimental và là một restricted setting, vì vậy workspace phải được tin cậy. Hỗ trợ agent-plugin là một tính năng preview do chat.plugins.enabled chi phối và được bật theo mặc định.Kiro
Kiro
Kiro đọc manifest Agent Plugins nguyên bản.Skill được tải từ
1
Clone the repository
2
Open the Powers panel
Trong Kiro, mở bảng Powers (biểu tượng Ghosty có tia sét).
3
Import the folder
Chọn Add Custom Power → Import power from a folder, chọn thư mục đã clone (thư mục chứa
plugin.json), rồi nhấp Install.skills/, còn các máy chủ MCP được tải từ mcp.json. Kiro quản lý máy chủ MCP nội bộ — chúng không được ghi vào ~/.kiro/settings/mcp.json. Kiro cũng có thể cài đặt Power trực tiếp từ URL GitHub; xem tài liệu cài đặt của Kiro.Gemini CLI (MCP only)
Gemini CLI (MCP only)
Gemini CLI không có primitive agent-skill, vì vậy chỉ có hai máy chủ MCP. Khởi động lại Gemini CLI.
dodo-knowledge bao phủ phần lớn chức năng mà các skill cung cấp và luôn tự động được cập nhật.gemini-extension.json tại thư mục gốc của repo là manifest.Bạn nhận được gì
Sau khi cài đặt, agent của bạn có quyền truy cập vào hai máy chủ MCP và mười bảy skill.Máy chủ MCP
Cả hai máy chủ đều sử dụng Streamable HTTP.
mcp.json chuẩn khai báo chúng nguyên bản, được các client tuân thủ đặc tả như Codex CLI và Kiro sử dụng. Manifest tương thích được tạo tự động .mcp.json kết nối chúng thông qua mcp-remote dành cho các client không thể kết nối trực tiếp với Streamable HTTP.
Agent Skill
Skill được tải tự động — agent sẽ chọn skill phù hợp khi phát hiện một tác vụ liên quan. Xem Agent Skills để biết danh sách đầy đủ và cách cài đặt từng skill.
Thử prompt này trước
Sau khi plugin hoạt động, hãy thử:webhook-integration, sử dụng MCP dodo-knowledge để lấy các payload shape mới nhất và viết handler có xác minh signature theo đặc tả Standard Webhooks.
Hỗ trợ client
Agent có cài đặt Plugin
Một lần cài đặt sẽ kết nối cả hai máy chủ MCP, cùng các skill trên mọi client có primitive skill.
OpenCode cần thêm một mục
skills.paths trước khi tải mười bảy skill. Gemini CLI không có primitive agent-skill, vì vậy skill không khả dụng theo thiết kế.
Client khác tương thích với MCP
Các client này không có chức năng cài đặt Agent Plugin. Hãy cấu hình thủ công hai máy chủ MCP và thêm skill thông qua Skills CLI nếu được hỗ trợ.Tài liệu được xây dựng cho Agent
Mọi trang tài liệu Dodo Payments đều có sẵn ở định dạng được tối ưu cho AI sử dụng:- Mục lục tài liệu đầy đủ:
docs.dodopayments.com/llms.txt— mục lục tài liệu hoàn chỉnh để nạp ngữ cảnh - Markdown thuần: Thêm
.mdvào bất kỳ URL tài liệu nào để nhận phiên bản markdown thô (ví dụ:/api-reference/introduction.md) - Repository mã nguồn:
github.com/dodopayments/dodo-docs— clone để lập chỉ mục ngoại tuyến
Agent của bạn có thể làm gì
Khi plugin được cài đặt, coding agent của bạn có thể:- Tạo checkout session và payment link — Thanh toán một lần và subscription
- Thiết lập billing dựa trên subscription và usage từ đầu đến cuối — Subscriptions, Billing dựa trên usage, Billing dựa trên credit
- Tạo handler tuân thủ Standard Webhooks với xác minh signature — Webhooks
- Gắn route handler vào framework bằng adapter chính thức — Framework adaptor
- Kết nối component React của BillingSDK cho bảng pricing và quản lý subscription — BillingSDK
- Xây dựng quy trình license key cho sản phẩm số — License key
- Triển khai billing dựa trên credit với entitlement, số dư, rollover và overage — Credit
- Xây dựng và quản lý product catalog với add-on và collection — Product, Add-on, Product collection
- Thêm discount và localized pricing — Mã discount, Localized pricing, Adaptive Currency
- Cung cấp checkout trong ứng dụng mobile cho React Native, Flutter, iOS và Android — Tích hợp mobile
- Xử lý refund, dispute và self-service cho customer — Refund, Dispute, Customer portal
- Kiểm thử tích hợp và go-live an toàn — Test mode và live mode
Bảo mật và Best Practice
- Trước tiên hãy sử dụng test mode. Xây dựng và kiểm thử tích hợp bằng API key của test mode trước khi go-live. Xem Test Mode và Live Mode.
- OAuth là mặc định. Agent Plugin xác thực qua browser OAuth (không có secret cục bộ). Chỉ sử dụng API-key mode khi cần.
- Kiểm tra code do agent tạo. Luôn xác minh handler webhook có xác minh signature theo đặc tả Standard Webhooks.
Cấu hình bằng API Key
Theo mặc định, Agent Plugin sử dụng MCP server từ xa với browser OAuth. Để sử dụng API key cục bộ thay thế, chẳng hạn trong CI hoặc trên server headless, hãy chuyển sang stdio mode.Local API key mode — Claude Code
Local API key mode — Claude Code
Mở Chạy
/plugins trong Claude Code, chọn Dodo Payments, rồi chọn Configure options. Điền các mục sau:dodo_api_key— API key của test mode hoặc live modedodo_webhook_key— webhook signing secretdodo_environment—test_modehoặclive_mode
.mcp.json để trỏ dodopayments-api đến server stdio cục bộ:/reload-plugins để áp dụng thay đổi.Local API key mode — OpenCode
Local API key mode — OpenCode
Tự khai báo Khởi động lại OpenCode để áp dụng.
dodopayments-api trong opencode.json — mục của bạn sẽ ghi đè server remote mặc định của plugin:Bước tiếp theo
MCP Server
Tài liệu tham khảo đầy đủ cho cả hai máy chủ MCP — tất cả client được hỗ trợ, cấu hình và công cụ khả dụng
Agent Skills
Cài đặt từng skill, tài liệu tham khảo skill và hướng dẫn thiết lập cho từng agent
API Reference
Tài liệu tham khảo OpenAPI đầy đủ cho mọi endpoint Dodo Payments