Chuyển đến nội dung chính

Documentation Index

Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt

Use this file to discover all available pages before exploring further.

Dodo Agent Plugin kết nối hai máy chủ MCP và tám kỹ năng tích hợp vào agent coding AI của bạn trong một lần cài đặt. Nó hoạt động với Claude Code, Codex CLI, Cursor, và OpenCode — và các máy chủ MCP và kỹ năng CLI hoạt động với bất kỳ client tương thích MCP nào.
Ba nguyên thủy, một plugin. Agent Plugin tổng hợp mọi thứ bạn cần:
  • API MCP server — truy cập trực tiếp vào thanh toán, đăng ký, khách hàng, sản phẩm, hoàn tiền, giấy phép, và sử dụng. Xác thực qua OAuth trình duyệt (không cần khóa cục bộ).
  • 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.
  • Tám kỹ năng agent — các ghi chú tóm tắt mà agent của bạn nạp khi cần cho quy trình thanh toán, đăng ký, webhooks, hóa đơn dựa trên sử dụng, hóa đơn dựa trên tín dụng, khóa giấy phép, BillingSDK, và các thực tiễn tốt nhất.

Cài đặt plugin

Chọn agent coding của bạn bên dưới. Việc cài đặt tự động thêm cả hai máy chủ MCP và tất cả tám kỹ năng.

Claude Code

Cài đặt từ marketplace:
claude plugins marketplace add dodopayments/dodo-agent-plugin
claude plugins install dodopayments@dodopayments
Máy chủ API MCP sử dụng OAuth trình duyệt theo mặc định — không cần khóa cài đặt. Lần đầu tiên agent của bạn gọi công cụ Dodo, bạn sẽ được nhắc đăng nhập.

Dodo Agent Plugin on GitHub

Mã nguồn, tùy chọn cấu hình, và hướng dẫn phát triển cục bộ
Codex đọc .claude-plugin/marketplace.json một cách nguyên bản, vì vậy repo plugin cùng hoạt động:
codex plugin marketplace add dodopayments/dodo-agent-plugin
codex plugin install dodopayments@dodopayments
Cả hai máy chủ MCP và tất cả tám kỹ năng đều được đăng ký tự động.
Cài đặt thủ công — nhân bản 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 các kỹ năng từ .claude/skills/ (thông qua lớp tương thích Claude Code của Cursor) và máy chủ MCP từ .mcp.json.
Hỗ trợ marketplace của Cursor sắp ra mắt. Hiện tại, sử dụng cài đặt thủ công ở trên.
OpenCode phân phối qua npm. Thêm plugin vào opencode.json của bạn:
{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["@dodopayments/opencode-plugin"]
}
Khởi động lại OpenCode. Cả hai máy chủ MCP (dodopayments-api, dodo-knowledge) được đăng ký tự động thông qua config hook của plugin, và tám kỹ năng được tự phát hiện từ gói được cài đặt. Không cần khối mcp thủ công.
Sử dụng agent khác? Các hướng dẫn MCP ServerAgent Skills bao gồm Cursor, Claude Desktop, VS Code, Windsurf, Cline, Zed và bất kỳ client tương thích MCP nào.

Bạn nhận được gì

Khi plugin được cài đặt, agent của bạn có quyền truy cập vào hai máy chủ MCP và tám kỹ năng.

Máy chủ MCP

ServerMục đíchXác thực
dodopayments-apiTruy cập API trực tiếp — thanh toán, đăng ký, khách hàng, sản phẩm, hoàn tiền, giấy phép, sử dụngOAuth (trình duyệt)
dodo-knowledgeTìm kiếm ngữ nghĩa qua toàn bộ tài liệu Dodo PaymentsKhông có
Cả hai máy chủ đều được kết nối qua mcp-remote để chúng chạy trong bất kỳ client tương thích MCP nào.

Kỹ năng agent

Kỹ năngMô tả
best-practicesHướng dẫn toàn diện tích hợp Dodo Payments với thực tiễn tốt nhất
checkout-integrationTạo phiên thanh toán và luồng thanh toán
subscription-integrationThực hiện luồng hóa đơn đăng ký
webhook-integrationCài đặt và xử lý webhooks cho sự kiện thanh toán
usage-based-billingThực hiện hóa đơn có tính phí dựa trên sự kiện và mét
credit-based-billingQuyền tín dụng, số dư, và khấu trừ tín dụng dựa trên mét
license-keysQuản lý khóa giấy phép cho sản phẩm kỹ thuật số
billing-sdkSử dụng BillingSDK React components
Kỹ năng tự động tải — agent của bạn chọn kỹ năng phù hợp khi phát hiện nhiệm vụ liên quan. Xem tài liệu Agent Skills để biết danh sách đầy đủ và cài đặt riêng lẻ.

Thử lời nhắc này trước

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 của bạn sẽ tải kỹ năng webhook-integration, sử dụng MCP dodo-knowledge để lấy các hình dạng payload mới nhất, và viết một bộ xử lý với xác minh chữ ký theo chuẩn Standard Webhooks.

Các agent hỗ trợ khác

Agent Plugin bao phủ Claude Code, Codex CLI, Cursor, và OpenCode. Nếu bạn sử dụng một agent khác, kết nối với Dodo Payments thông qua máy chủ MCP và kỹ năng CLI:
AgentĐường dẫn nhanh nhấtCũng hỗ trợ
Claude CodeAgent Plugin (một lệnh)MCP server, kỹ năng riêng lẻ
Codex CLIAgent Plugin (một lệnh)MCP server
CursorAgent Plugin (git clone)Cấu hình máy chủ MCP, kỹ năng CLI
OpenCodeAgent Plugin (npm)Cấu hình máy chủ MCP, kỹ năng CLI
GitHub Copilot (VS Code)Hướng dẫn MCP ServerKỹ năng CLI
Claude DesktopHướng dẫn MCP Server
WindsurfHướng dẫn MCP ServerKỹ năng CLI
Cline / Zed / othersHướng dẫn MCP ServerKỹ năng CLI

Tài liệu được xây dựng cho các agent

Mọi trang tài liệu Dodo Payments đều có sẵn ở định dạng tối ưu hóa cho AI tiêu thụ:
  • Chỉ mục tài liệu đầy đủ: docs.dodopayments.com/llms.txt — cung cấp chỉ mục tài liệu hoàn chỉnh cho việc truy xuất ngữ cảnh.
  • Markdown đơn giản: Thêm .md vào bất kỳ URL tài liệu nào để lấy phiên bản markdown gốc (ví dụ, /api-reference/introduction.md).
  • Kho nguồn: github.com/dodopayments/dodo-docs — nhân bản để lập chỉ mục ngoại tuyến.

Điều gì agent của bạn có thể làm

Với plugin đã được cài đặt, agent coding của bạn có thể:

Bảo mật và thực tiễn tốt nhất

Không bao giờ cam kết khóa API sản xuất. Sử dụng chế độ thử nghiệm trong quá trình phát triển. Agent Plugin sử dụng OAuth trình duyệt theo mặc định — chỉ chuyển sang sử dụng khóa API cục bộ nếu quy trình của bạn yêu cầu.
  • Sử dụng chế độ thử nghiệm trước. Định hình tích hợp của bạn với các khóa dodo_test_... trước khi phát hành. Xem Chế độ thử nghiệm vs Chế độ trực tiếp.
  • OAuth là tiêu chuẩn mặc định. Agent Plugin xác thực qua OAuth trình duyệt (không có bí mật cục bộ). Chỉ sử dụng chế độ khóa API nếu bạn cần — xem phần Cấu hình dưới đây.
  • Xem xét mã được tạo bởi agent. Luôn kiểm tra bộ xử lý webhook bao gồm xác minh chữ ký theo tiêu chuẩn Standard Webhooks.

Cấu hình với khóa API

Theo mặc định, Agent Plugin sử dụng máy chủ MCP từ xa với OAuth trình duyệt — không cần thông tin xác thực cục bộ. Nếu quy trình của bạn yêu cầu khóa API cục bộ (ví dụ, môi trường CI, máy chủ không đầu), bạn có thể chuyển sang chế độ stdio.
Mở /plugins trong Claude Code, chọn Dodo Payments, và chọn Cấu hình tùy chọn. Điền vào:
  • dodo_api_key — khóa dodo_test_... hoặc dodo_live_... của bạn
  • dodo_webhook_key — bí mật ký của webhook của bạn
  • dodo_environmenttest_mode hoặc live_mode
Sau đó chỉnh sửa .mcp.json để trỏ dodopayments-api vào máy chủ stdio cục bộ:
{
  "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 các thay đổi vào phiên hiện tại của bạn.
Tự khai báo dodopayments-api trong opencode.json của bạn — mục nhập của bạn sẽ chiến thắng trong số các máy chủ từ xa 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": "dodo_test_...",
        "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

Tham chiếu đầy đủ cho cả hai máy chủ MCP — tất cả các client được hỗ trợ, cấu hình, và công cụ có sẵn

Agent Skills

Cài đặt kỹ năng riêng lẻ, tham chiếu kỹ năng, và hướng dẫn cài đặt cho mỗi agent

Sentra IDE Assistant

Trợ lý hóa đơn được AI hỗ trợ cho VS Code, Cursor, và Windsurf — hỏi, xây dựng, và lên kế hoạch trong trình soạn thảo của bạn

API Reference

Tham chiếu OpenAPI đầy đủ cho tất cả các điểm cuối của Dodo Payments
Last modified on May 4, 2026