plugin.json và mcp.json. Các client có trước đặc tả này sẽ tải cùng nội dung thông qua các compatibility manifests được tạo tự động.
Ba primitive, một plugin. Agent Plugin bao gồm mọi thứ bạn cần:
- API MCP server — truy cập trực tiếp đến payments, subscriptions, customers, products, refunds, licenses và usage. Xác thực qua browser OAuth (không cần local keys).
- 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 credentials.
- Mười bảy agent skills — các cheat sheet mà agent tải theo yêu cầu cho checkout, subscriptions, webhooks, usage-based và credit-based billing, 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 practices.
Cài đặt plugin
Chọn coding agent bên dưới. Mỗi cách cài đặt đều thêm cả hai MCP servers; tất cả trừ Gemini CLI cũng thêm mười bảy skills.Claude Code
Claude Code
Cài đặt từ marketplace:API MCP server sử dụng browser OAuth theo mặc định — không cần keys trong thời gian cài đặt. Lần đầu agent gọi một Dodo tool, bạn sẽ được yêu cầu đă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
Codex cài đặt plugins theo hai bước: đăng ký marketplace từ shell, sau đó cài đặt plugin bên trong Codex TUI.Cả hai MCP servers và toàn bộ mười bảy skills sẽ được đăng ký tự động sau khi plugin được cài đặt.Nếu trước đây bạn đã thêm marketplace nhưng plugin không xuất hiện bên dưới
1
Register the marketplace
2
Install from the Codex TUI
Mở Codex và chạy slash command Sau đó nhập
/plugins:/plugins, chuyển sang marketplace Dodo Payments, chọn plugin dodopayments và chọn Install plugin.Codex CLI không có subcommand
codex plugin install — việc cài đặt plugin luôn diễn ra thông qua flow /plugins trong TUI. Xem tài liệu Codex plugins chính thức./plugins, hãy làm mới marketplace:Cursor
Cursor
Cài đặt thủ công — clone repo vào thư mục plugins cục bộ của Cursor:Khởi động lại Cursor. Plugin tải skills từ
skills/ và MCP servers từ .mcp.json, như được khai báo trong .cursor-plugin/plugin.json.Các bản build Cursor gần đây cũng nhận diện trực tiếp Agent Plugins 1.0.0 và chấp nhận
.cursor-plugin/marketplace.json hoặc .claude-plugin/marketplace.json làm marketplace source. Plugin này cung cấp .claude-plugin/marketplace.json — hãy sử dụng path đó. .cursor-plugin/plugin.json được tạo tự động vẫn được giữ lại cho các bản build cũ.OpenCode
OpenCode
OpenCode được phân phối qua npm. Thêm plugin vào Khởi động lại OpenCode. Cả hai MCP servers (Các entry
opencode.json của bạn:dodopayments-api, dodo-knowledge) được đăng ký tự động thông qua config hook của plugin. Không cần block mcp thủ công.Skills cần thêm một dòng. OpenCode không quét các packages đã cài đặt để tìm skills, vì vậy hãy tự trỏ đến thư mục skills/ của package:skills.paths tương đối được phân giải dựa trên project directory, vì vậy package phải tồn tại trong node_modules của project đó — plugin cache riêng của OpenCode nằm ở vị trí khác. Absolute path cũng hoạt động và tránh yêu cầu cài đặt cục bộ.VS Code / GitHub Copilot
VS Code / GitHub Copilot
Clone repo ở bất kỳ đâu, sau đó đăng ký repo:Mở Chat view, đi đến Plugins và thêm thư mục đã clone. Bạn cũng có thể đăng ký trực tiếp trong Key là một path, value bật plugin. Absolute paths và
settings.json:~/ đều hoạt động; relative path được phân giải dựa trên từng workspace folder. Setting được đọc trực tiếp, nên cửa sổ đang chạy sẽ nhận thay đổi mà không cần khởi động lại. Skills được tải từ skills/, còn cả hai MCP servers được tải từ .mcp.json.chat.pluginLocations được đánh dấu là experimental và là một setting restricted, vì vậy workspace phải được tin cậy để setting này có hiệu lực. Hỗ trợ agent-plugin nói chung vẫn là một preview feature được điều khiển bởi chat.plugins.enabled, vốn được bật theo mặc định — bạn chỉ cần đặt setting này nếu tổ chức của bạn vô hiệu hóa nó theo policy.VS Code không dựa trên
$schema của Agent Plugins. Loader của nó kiểm tra .plugin/plugin.json, sau đó .claude-plugin/plugin.json, rồi root plugin.json; đồng thời mặc định MCP là .mcp.json thay vì mcp.json. Vì repo này cung cấp .claude-plugin/plugin.json được tạo tự động, VS Code tải plugin qua compatibility branch đó và nhận bridge mcp-remote thay vì native transports trong mcp.json. Mọi thứ vẫn hoạt động — chỉ khác path.Kiro
Kiro
Kiro đọc Agent Plugins manifest natively và tải plugin này dưới dạng một Power.Skills được tải từ
1
Clone the repository
2
Open the Powers panel
Trong Kiro, mở Powers panel — 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/, MCP servers từ mcp.json, còn phần trình bày dành riêng cho Kiro đến từ extension namespace dev.kiro trong plugin.json.Đối với các plugin ở định dạng Agent Plugins, Kiro quản lý MCP servers nội bộ — chúng không được ghi vào
~/.kiro/settings/mcp.json ở cấp user, vì vậy đừng mong tìm thấy chúng ở đó. Kiro cũng có thể cài đặt một Power trực tiếp từ GitHub URL; xem tài liệu cài đặt của Kiro.Gemini CLI (MCP only)
Gemini CLI (MCP only)
Gemini CLI không có agent-skill primitive, vì vậy chỉ hai MCP servers khả dụng — mười bảy skills không khả dụng. Khởi động lại Gemini CLI.
dodo-knowledge vẫn bao quát phần lớn chức năng do các skills cung cấp và được tự động cập nhật.gemini-extension.json tại root của repo là manifest.Đang sử dụng agent khác? Các hướng dẫn MCP Server và Agent Skills bao quát Claude Desktop, Windsurf, Cline, Zed và mọi MCP-compatible client.
Bạn nhận được gì
Sau khi cài đặt plugin, agent của bạn có quyền truy cập vào hai MCP servers và mười bảy skills.MCP servers
Cả hai servers đều sử dụng Streamable HTTP.
mcp.json canonical khai báo chúng natively (type: "streamable-http"), đây là cách các client hỗ trợ native spec như Codex CLI và Kiro sử dụng. Compatibility manifest được tạo tự động .mcp.json kết nối cùng hai endpoints thông qua mcp-remote, nên chúng cũng chạy được trong các client không thể kết nối trực tiếp bằng Streamable HTTP — Claude Code, VS Code và Cursor thông qua cách cài đặt git-clone được mô tả ở trên, với .cursor-plugin/plugin.json trỏ đến .mcp.json.
Agent skills
Skills được tải tự động — agent chọn skill phù hợp khi phát hiện task liên quan. Xem tài liệu Agent Skills để xem danh sách đầy đủ và cách cài đặt từng skill.
Hãy 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 shapes mới nhất và viết handler có signature verification theo Standard Webhooks spec.
Hỗ trợ client
Các client có Agent Plugin install
Một lần cài đặt sẽ kết nối cả hai MCP servers, cùng với các skills trên mọi client có skill primitive.- OpenCode cần thêm một entry
skills.pathstrước khi tải mười bảy skills — xem phần cài đặt ở trên. - Gemini CLI không có agent-skill primitive, vì vậy skills không khả dụng ở đó theo thiết kế.
Các MCP-compatible client khác
Các client này không có Agent Plugin install. Hãy cấu hình thủ công hai MCP servers và thêm skills thông qua Skills CLI nếu được hỗ trợ.Docs được xây dựng cho agents
Mọi trang tài liệu Dodo Payments đều có sẵn ở định dạng được tối ưu cho AI consumption:- Full docs index:
docs.dodopayments.com/llms.txt— cung cấp index tài liệu đầy đủ để ingestion làm context. - Plain markdown: Thêm
.mdvào bất kỳ documentation URL nào để nhận phiên bản raw markdown (ví dụ:/api-reference/introduction.md). - Source repository:
github.com/dodopayments/dodo-docs— clone để indexing offline.
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 sessions và payment links — Thanh toán một lần và subscriptions
- Thiết lập subscription và usage-based billing end-to-end — Subscriptions, Usage-based billing, Credit-based billing
- Tạo các handlers tuân thủ Standard Webhooks với signature verification — Webhooks
- Gắn route handlers vào framework bằng các adapters chính thức — Framework adaptors
- Kết nối BillingSDK React components cho pricing tables và subscription management — BillingSDK
- Xây dựng các license-key flows cho digital products — License keys
- Triển khai credit-based billing với entitlements, balances, rollover và overage — Credits
- Xây dựng và quản lý product catalog với add-ons và collections — Products, Add-ons, Product collections
- Thêm discounts và localized pricing — Discount codes, Localized pricing, Adaptive currency
- Triển khai mobile in-app checkout cho React Native, Flutter, iOS và Android — Mobile integration
- Xử lý refunds, disputes và customer self-service — Refunds, Disputes, Customer portal
- Kiểm thử integration và go live an toàn — Test mode vs live mode
Bảo mật và best practices
- Trước tiên hãy sử dụng test mode. Sandbox integration của bạn bằng các keys
dodo_test_...trước khi go live. Xem Test Mode vs Live Mode. - OAuth là mặc định. Agent Plugin xác thực qua browser OAuth (không có local secrets). Chỉ sử dụng API-key mode khi cần — xem phần Configure bên dưới.
- Kiểm tra code do agent tạo. Luôn xác minh rằng webhook handlers có signature verification theo Standard Webhooks spec.
Cấu hình bằng API key
Theo mặc định, Agent Plugin sử dụng remote MCP server với browser OAuth — không cần local credentials. Nếu workflow yêu cầu local API key (ví dụ: CI environments, headless servers), bạn có thể 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 và chọn Configure options. Điền các thông tin sau:dodo_api_key— keydodo_test_...hoặcdodo_live_...của bạndodo_webhook_key— webhook signing secret của bạndodo_environment—test_modehoặclive_mode
.mcp.json để trỏ dodopayments-api đến local stdio server:/reload-plugins để áp dụng thay đổi cho session hiện tại của bạn.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 — entry của bạn sẽ ghi đè remote server mặc định của plugin:Các bước tiếp theo
MCP Server
Tài liệu tham khảo đầy đủ cho cả hai MCP servers — tất cả client được hỗ trợ, cấu hình và tools khả dụng
Agent Skills
Cài đặt từng skill, tài liệu tham khảo về skill và hướng dẫn thiết lập cho từng agent
Sentra IDE Assistant
Trợ lý billing hỗ trợ AI cho VS Code, Cursor và Windsurf — hỏi, xây dựng và lập kế hoạch ngay trong editor
API Reference
Tài liệu tham khảo OpenAPI đầy đủ cho mọi endpoint của Dodo Payments