Xây dựng với AI Coding Agents

Cài đặt Dodo Agent Plugin để cung cấp cho coding agent của bạn hai máy chủ MCP và mười bảy skill nhằm xây dựng các tích hợp Dodo Payments.

Cài đặt Dodo Agent Plugin để cung cấp cho coding agent của bạn hai máy chủ MCP và mười bảy skill nhằm xây dựng các tích hợp Dodo Payments. Sau khi cài đặt, hãy mô tả điều bạn muốn xây dựng, agent sẽ lập kế hoạch và viết phần tích hợp. Plugin hoạt động với Claude Code, Codex CLI, Cursor, VS Code / GitHub Copilot, Kiro và OpenCode. Gemini CLI chỉ nhận được hai máy chủ MCP.

​

Cài đặt Plugin

Chọn coding agent của bạn bên dưới. Mỗi lần cài đặt sẽ thêm cả hai MCP server. 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 thiết lập để tải chúng, được mô tả trong phần tương ứng.

Claude Code

Cài đặt từ marketplace:

claude plugins marketplace add dodopayments/dodo-agent-plugin
claude plugins install dodopayments@dodopayments

API MCP server sử dụng browser OAuth theo mặc định — không yêu cầu key tại thời điểm 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

Đăng ký marketplace, sau đó cài đặt từ Codex TUI.

1. Register the marketplace

   codex plugin marketplace add dodopayments/dodo-agent-plugin
   
2. Install from the Codex TUI

   Mở Codex và chạy /plugins:

   codex
   

   Nhập /plugins, chuyển sang marketplace Dodo Payments, chọn plugin dodopayments và chọn Install plugin.

Cả hai MCP server 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 /plugins, hãy làm mới plugin:

codex plugin marketplace upgrade dodopayments

Để cài đặt từ shell thay vì TUI, hãy 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

Clone repo vào thư mục plugin cục bộ của Cursor:

git clone https://github.com/dodopayments/dodo-agent-plugin.git ~/.cursor/plugins/local/dodo-agent-plugin

Khởi động lại Cursor. Plugin tải skill từ skills/ và MCP server 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 và clone lại — skill hiện được cung cấp dưới dạng file thật, không phải symlink.

OpenCode

Cài đặt package plugin trong project, sau đó thêm package và đường dẫn skill của nó vào opencode.json:

npm install --save-dev @dodopayments/opencode-plugin

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["@dodopayments/opencode-plugin"],
  "skills": {
    "paths": ["node_modules/@dodopayments/opencode-plugin/skills"]
  }
}

Khởi động lại OpenCode. Cả hai MCP server sẽ được đăng ký tự động. Skill cần thêm mục 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 theo 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 skill đã được tải:

opencode run "List every skill available to you by name."

Bạn sẽ thấy cả mười bảy skill. Đường dẫn skill không tồn tại sẽ bị bỏ qua một cách im lặng, vì vậy hãy xác minh thay vì mặc định cho rằng chúng đã được tải.

VS Code / GitHub Copilot

Clone repo và đăng ký repo:

git clone https://github.com/dodopayments/dodo-agent-plugin.git ~/dodo-agent-plugin

Mở chế độ xem Chat, đi đến Plugins và thêm thư mục đã clone. Hoặc đăng ký trong settings.json:

{
  "chat.pluginLocations": { "~/dodo-agent-plugin": true }
}

Key là một đường dẫn, còn value sẽ bật nó. Cả đường dẫn tuyệt đối và ~/ đều hoạt động; đường dẫn tương đối được phân giải theo từng thư mục workspace. Thiết lập được đọc trực tiếp, vì vậy một cửa sổ đang chạy sẽ nhận thiết lập 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 trusted. Hỗ trợ agent-plugin là một preview feature do chat.plugins.enabled quản lý và được bật theo mặc định.

Kiro

Kiro đọc manifest của Agent Plugins một cách nguyên bản.

1. Clone the repository

   git clone https://github.com/dodopayments/dodo-agent-plugin.git
   
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.

Skill được tải từ skills/, MCP server từ mcp.json. Kiro quản lý MCP server nội bộ — chúng không được ghi vào ~/.kiro/settings/mcp.json. Kiro cũng có thể cài đặt mộ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 không có agent-skill primitive, vì vậy chỉ có hai MCP server. dodo-knowledge cung cấp phần đáng kể chức năng của skill và luôn được cập nhật tự động.

git clone https://github.com/dodopayments/dodo-agent-plugin.git \
  ~/.gemini/extensions/dodopayments

Khởi động lại Gemini CLI. gemini-extension.json tại thư mục gốc của repo là manifest.

Bạn đ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 client tương thích với MCP.

​

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 MCP server và mười bảy skill.

​

MCP Server

Server	Mục đích	Xác thực
dodopayments-api	Truy cập API trực tiếp — payments, subscriptions, customers, products, refunds, licenses, usage	OAuth (browser)
dodo-knowledge	Tìm kiếm ngữ nghĩa trên toàn bộ tài liệu Dodo Payments	Không có

Cả hai server đều sử dụng Streamable HTTP. mcp.json chuẩn khai báo chúng một cách nguyên bản, được các client theo chuẩn như Codex CLI và Kiro sử dụng. Manifest tương thích được tạo ra .mcp.json kết nối chú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 Skills

Skill	Mô tả
dodo-best-practices	Thiết lập SDK, môi trường, API key và kiến trúc checkout-to-webhook chuẩn
framework-adapters	Các route handler @dodopayments/* chính thức cho Next.js, Express, Hono, Astro, Remix, SvelteKit, Nuxt, Fastify, TanStack, Bun và Convex
testing-and-go-live	Test mode, phương thức thanh toán thử nghiệm, kiểm thử webhook và checklist ra mắt production
checkout-integration	Checkout Sessions, payment link và checkout dạng overlay hoặc inline
subscription-integration	Vòng đời subscription, trial, thay đổi plan, proration và khoản phí theo nhu cầu
mobile-checkout	Checkout trong ứng dụng cho React Native, Flutter, iOS và Android
webhook-integration	Nhận và xác minh webhook bằng đặc tả Standard Webhooks
credit-based-billing	Credit entitlement, số dư, sổ cái, rollover, overage và khấu trừ dựa trên meter
usage-based-billing	Meter, tiếp nhận event, tổng hợp và định giá theo đơn vị
license-keys	Kích hoạt, xác thực license key và quản lý instance
product-catalog-management	Product, pricing, add-on, collection, image và phân phối sản phẩm số
discounts-and-promotions	Discount code, quy tắc đủ điều kiện, stacking và giới hạn theo chu kỳ subscription
localized-pricing	Định giá bản địa hóa, Adaptive Currency và purchasing power parity
customer-management	Customer, self-service portal, payment method đã lưu và wallet
refunds-and-disputes	Phát hành refund, xử lý dispute và chargeback, đối soát quyền truy cập
billing-sdk	Component BillingSDK React cho bảng pricing và giao diện billing
better-auth-integration	Plugin @dodopayments/better-auth cho đồng bộ customer, checkout và quyền truy cập portal

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ử:

Set up Dodo Payments webhook handlers in my Next.js app for payment.succeeded and subscription.active events.

Agent sẽ tải skill 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 chữ ký theo đặc tả Standard Webhooks.

​

Hỗ trợ client

Plugin tuân theo đặc tả Agent Plugins 1.0.0. Client có hỗ trợ nguyên bản sẽ tải plugin trực tiếp; các client khác sử dụng manifest tương thích được tạo ra.

​

Agent có cài đặt Plugin

Một lần cài đặt sẽ kết nối cả hai MCP server, cùng với skill trên mọi client có agent-skill primitive.

Agent	Cài đặt	Skill	MCP Server
Claude Code	marketplace command	17	2
Codex CLI	marketplace command	17	2
Cursor	git clone	17	2
VS Code / GitHub Copilot	git clone	17	2
Kiro	git clone	17	2
OpenCode	npm	17	2
Gemini CLI	git clone	0	2

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ó agent-skill primitive, vì vậy skill không khả dụng theo thiết kế.

​

Các client tương thích MCP khác

Các client này không có cài đặt Agent Plugin. Hãy tự cấu hình hai MCP server và thêm skill thông qua Skills CLI nếu được hỗ trợ.

Agent	MCP Server	Skill
Claude Desktop	Hướng dẫn MCP Server	không được hỗ trợ
Windsurf	Hướng dẫn MCP Server	Skills CLI
Cline / Zed / các client khác	Hướng dẫn MCP Server	Skills CLI

​

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 việc 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 .md và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 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 — Subscription, 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 chữ ký — Webhook
• Gắn route handler vào framework bằng adapter chính thức — Adapter framework
• Kết nối component BillingSDK React cho bảng pricing và quản lý subscription — BillingSDK
• Xây dựng flow 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à pricing bản địa hóa — Discount code, Pricing bản địa hóa, Adaptive currency
• Cung cấp checkout trong ứng dụng trên 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à phương pháp tốt nhất

Không bao giờ commit live API key. Sử dụng test mode trong quá trình phát triển.

• 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 test mode API key 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.
• Xem xét code do agent tạo. Luôn xác minh handler webhook có xác minh chữ ký theo đặc tả Standard Webhooks.

​

Cấu hình bằng API Key

Theo mặc định, Agent Plugin sử dụng remote MCP server với browser OAuth. Để sử dụng API key cục bộ, chẳng hạn trong CI hoặc trên headless server, hãy chuyển sang stdio mode.

Local API key mode — Claude Code

Mở /plugins trong Claude Code, chọn Dodo Payments và chọn Configure options. Điền các mục sau:

• dodo_api_key — API key test mode hoặc live mode của bạn
• dodo_webhook_key — webhook signing secret của bạn
• dodo_environment — test_mode hoặc live_mode

Sau đó chỉnh sửa .mcp.json để trỏ dodopayments-api đến local stdio server:

{
  "mcpServers": {
    "dodopayments-api": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "dodopayments-mcp@latest"],
      "env": {
        "DODO_PAYMENTS_API_KEY": "${user_config.dodo_api_key}",
        "DODO_PAYMENTS_WEBHOOK_KEY": "${user_config.dodo_webhook_key}",
        "DODO_PAYMENTS_ENVIRONMENT": "${user_config.dodo_environment}"
      }
    }
  }
}

Chạy /reload-plugins để áp dụng thay đổi.

Local API key mode — OpenCode

Tự khai báo dodopayments-api trong opencode.json — mục của bạn sẽ được ưu tiên hơn remote server mặc định của plugin:

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["@dodopayments/opencode-plugin"],
  "mcp": {
    "dodopayments-api": {
      "type": "local",
      "command": ["npx", "-y", "dodopayments-mcp@latest"],
      "environment": {
        "DODO_PAYMENTS_API_KEY": "YOUR_TEST_MODE_API_KEY",
        "DODO_PAYMENTS_WEBHOOK_KEY": "whsec_...",
        "DODO_PAYMENTS_ENVIRONMENT": "test_mode"
      },
      "enabled": true
    }
  }
}

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 server — tất cả client được hỗ trợ, cấu hình và các tool khả dụng

Agent Skills

Cài đặt skill riêng lẻ, tài liệu tham khảo về 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 tất cả endpoint của Dodo Payments