Skip to main content
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. Plugin tuân theo đặc tả Agent Plugins 1.0.0. Các client có hỗ trợ gốc sẽ tải plugin trực tiếp; các client khác sử dụng manifest tương thích được tạo tự động. Bạn nhận được gì:
  • 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

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ộ
Đăng ký marketplace, sau đó cài đặt từ Codex TUI.
1

Register the marketplace

2

Install from the Codex TUI

Mở Codex và chạy /plugins:
Nhập /plugins, chuyển sang marketplace Dodo Payments, chọn plugin dodopayments, rồi chọn Install plugin.
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 /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.
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.
Cài đặt package plugin trong project, sau đó thêm package và đường dẫn skill vào opencode.json:
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 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:
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.
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 settings.json:
Key là một đường dẫn, còn value bật plugin. Đường dẫn tuyệt đối và ~/ đề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 đọc manifest Agent Plugins nguyên bản.
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.
Skill được tải từ 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 không có primitive agent-skill, vì vậy chỉ có hai máy chủ MCP. 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.
Khởi động lại Gemini CLI. gemini-extension.json tại thư mục gốc 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 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 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ử:
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 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 .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 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ể:

Bảo mật và Best Practice

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 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.
Mở /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 mode
  • dodo_webhook_key — webhook signing secret
  • dodo_environment — test_mode hoặc live_mode
Sau đó chỉnh sửa .mcp.json để trỏ dodopayments-api đến server stdio cục bộ:
Chạy /reload-plugins để áp dụng thay đổi.
Tự khai báo dodopayments-api trong opencode.json — mục của bạn sẽ ghi đè server remote mặc định của plugin:
Khởi động lại OpenCode để áp dụng.

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