Skip to main content
Dodo Agent Plugin kết nối hai MCP servers và mười bảy integration skills với AI coding agent của bạn chỉ trong một lần cài đặt. Plugin hoạt động với Claude Code, Codex CLI, Cursor, VS Code / GitHub Copilot, KiroOpenCode. Gemini CLI chỉ nhận được hai MCP servers. MCP servers và skills CLI hoạt động với mọi MCP-compatible client. Plugin tuân theo đặc tả Agent Plugins 1.0.0, vì vậy các client có hỗ trợ native sẽ tải plugin trực tiếp từ root plugin.jsonmcp.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

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 cài đặt plugins theo hai bước: đăng ký marketplace từ shell, sau đó cài đặt plugin bên trong Codex TUI.
1

Register the marketplace

2

Install from the Codex TUI

Mở Codex và chạy slash command /plugins:
Sau đó nhập /plugins, chuyển sang marketplace Dodo Payments, chọn plugin dodopayments và chọn Install plugin.
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.
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.
Nếu trước đây bạn đã thêm marketplace nhưng plugin không xuất hiện bên dưới /plugins, hãy làm mới marketplace:
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ũ.
Các phiên bản trước 0.5.0 cung cấp skills/ dưới dạng symlink vào git submodule, vì vậy clone này tạo ra plugin không có skills hoạt động. Hiện skills được cung cấp dưới dạng các file thực. Nếu bạn đã cài đặt phiên bản cũ hơn, hãy xóa thư mục và clone lại.
OpenCode được phân phối qua npm. Thêm plugin vào opencode.json của bạn:
Khởi động lại OpenCode. Cả hai MCP servers (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:
Các entry 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ộ.
Một skills path không tồn tại sẽ bị bỏ qua một cách im lặng. Hãy kiểm tra thay vì giả định:
Bạn sẽ thấy đủ mười bảy skills. Tài liệu của các phiên bản trước 0.5.0 ghi rằng những skills này được tự động phát hiện — thực tế không phải vậy, nên người dùng OpenCode có MCP servers nhưng không có skills.
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 settings.json:
Key là một path, value bật plugin. Absolute paths và ~/ đề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 đọc Agent Plugins manifest natively và tải plugin này dưới dạng một Power.
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 được tải từ 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 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. 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.
Khởi động lại Gemini CLI. 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 ServerAgent 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ử:
Agent sẽ tải skill 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.paths trướ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 .md và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ể:

Bảo mật và best practices

Không bao giờ commit production API keys. Sử dụng test mode trong quá trình phát triển. Agent Plugin sử dụng browser OAuth theo mặc định — chỉ chuyển sang local API keys nếu workflow của bạn yêu cầu.
  • 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.
Mở /plugins trong Claude Code, chọn Dodo Payments và chọn Configure options. Điền các thông tin sau:
  • dodo_api_key — key dodo_test_... hoặc dodo_live_... của bạn
  • dodo_webhook_key — webhook signing secret của bạn
  • dodo_environmenttest_mode hoặc live_mode
Sau đó chỉnh sửa .mcp.json để trỏ dodopayments-api đến local stdio server:
Chạy /reload-plugins để áp dụng thay đổi cho session hiện tại của bạn.
Tự khai báo dodopayments-api trong opencode.json — entry của bạn sẽ ghi đè remote server mặc định của plugin:
Khởi động lại OpenCode để áp dụng.

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
Lần sửa đổi cuối 17 tháng 8, 2026