使用 AI 代码代理构建

安装 Dodo Agent Plugin，为您的编程代理提供两个 MCP 服务器和十七项技能，用于构建 Dodo Payments 集成。

安装 Dodo Agent Plugin，为您的编程代理提供两个 MCP 服务器和十七项技能，用于构建 Dodo Payments 集成。安装后，只需描述您想构建的内容，您的代理就会规划并编写集成代码。该插件支持 Claude Code、Codex CLI、Cursor、VS Code / GitHub Copilot、Kiro 和 OpenCode。Gemini CLI 仅支持两个 MCP 服务器。

​

安装插件

在下方选择你的编码代理。每次安装都会添加两个 MCP 服务器。除了 Gemini CLI 之外，所有代理还会添加十七项技能。OpenCode 需要额外的设置才能加载这些技能，具体说明见对应章节。

Claude Code

从 marketplace 安装：

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

API MCP 服务器默认使用浏览器 OAuth——安装时无需密钥。代理首次调用 Dodo 工具时，系统会提示你登录。

Dodo Agent Plugin on GitHub

源代码、配置选项和本地开发说明

Codex CLI

注册 marketplace，然后从 Codex TUI 安装。

1. Register the marketplace

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

   打开 Codex 并运行 /plugins：

   codex
   

   输入 /plugins，切换到 Dodo Payments marketplace，选择 dodopayments 插件，然后选择 Install plugin。

两个 MCP 服务器和全部十七项技能都会自动注册。

如果插件没有显示在 /plugins 下，请刷新：

codex plugin marketplace upgrade dodopayments

如果不使用 TUI，而是从 shell 安装，请在注册 marketplace 后运行 codex plugin add dodopayments@dodopayments。Codex CLI 没有 codex plugin install 子命令。请参阅 Codex 官方插件文档。

Cursor

将仓库克隆到 Cursor 的本地插件目录：

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

重启 Cursor。插件会从 skills/ 加载技能，并从 .mcp.json 加载 MCP 服务器。

新版 Cursor 可直接识别 Agent Plugins 1.0.0，并接受 .claude-plugin/marketplace.json 作为 marketplace 源。生成的 .cursor-plugin/plugin.json 会保留，以兼容旧版本。

如果你安装的是 0.5.0 之前的版本，请删除该目录并重新克隆——技能现在以真实文件形式提供，而不是符号链接。

OpenCode

在项目中安装插件包，然后将其及其技能路径添加到 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"]
  }
}

重启 OpenCode。两个 MCP 服务器都会自动注册。由于 OpenCode 不会扫描已安装的包来查找技能，因此技能需要额外的 skills.paths 条目。

相对路径会相对于项目目录解析，因此该包必须存在于该项目的 node_modules 中。绝对路径同样有效，并且不要求本地安装。

验证技能是否已加载：

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

你应该能看到全部十七项技能。不存在的技能路径会被静默忽略，因此请进行验证，不要仅凭猜测。

VS Code / GitHub Copilot

克隆仓库并注册：

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

打开 Chat 视图，转到 Plugins，然后添加克隆的文件夹。或者在 settings.json 中注册：

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

键是路径，值用于启用它。绝对路径和 ~/ 都有效；相对路径会相对于每个工作区文件夹解析。该设置会实时读取，因此运行中的窗口无需重启即可加载。

chat.pluginLocations 被标记为实验性功能，并且属于受限设置，因此工作区必须受信任。Agent-plugin 支持是一项预览功能，由 chat.plugins.enabled 控制，该设置默认开启。

Kiro

Kiro 原生读取 Agent Plugins manifest。

1. Clone the repository

   git clone https://github.com/dodopayments/dodo-agent-plugin.git
   
2. Open the Powers panel

   在 Kiro 中，打开 Powers 面板（带闪电图标的 Ghosty 图标）。

3. Import the folder

   选择 Add Custom Power → Import power from a folder，选择克隆的目录（包含 plugin.json 的目录），然后点击 Install。

技能从 skills/ 加载，MCP 服务器从 mcp.json 加载。Kiro 在内部管理 MCP 服务器——它们不会写入 ~/.kiro/settings/mcp.json。Kiro 也可以直接从 GitHub URL 安装 Power；请参阅 Kiro 安装文档。

Gemini CLI (MCP only)

Gemini CLI 没有 agent-skill 原语，因此只有两个 MCP 服务器可用。dodo-knowledge 涵盖了技能所提供功能中的很大一部分，并会自动保持最新。

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

重启 Gemini CLI。仓库根目录下的 gemini-extension.json 是 manifest。

使用其他代理？MCP Server 和 Agent Skills 指南涵盖 Claude Desktop、Windsurf、Cline、Zed 以及任何兼容 MCP 的客户端。

​

你将获得什么

安装完成后，你的代理可以访问两个 MCP 服务器和十七项技能。

​

MCP 服务器

服务器	用途	身份验证
dodopayments-api	实时 API 访问——payments、subscriptions、customers、products、refunds、licenses、usage	OAuth（浏览器）
dodo-knowledge	跨所有 Dodo Payments 文档进行语义搜索	无

两个服务器都使用 Streamable HTTP。规范的 mcp.json 会原生声明它们，Codex CLI 和 Kiro 等遵循规范的客户端会使用该声明。生成的兼容性 manifest .mcp.json 会通过 mcp-remote 连接它们，以支持无法直接连接 Streamable HTTP 的客户端。

​

Agent Skills

技能	描述
dodo-best-practices	SDK 设置、环境、API keys，以及从结账到 webhook 的规范架构
framework-adapters	适用于 Next.js、Express、Hono、Astro、Remix、SvelteKit、Nuxt、Fastify、TanStack、Bun 和 Convex 的官方 @dodopayments/* route handlers
testing-and-go-live	Test mode、测试支付方式、webhook 测试以及生产环境发布检查清单
checkout-integration	Checkout Sessions、payment links 以及 overlay 或 inline checkout
subscription-integration	Subscription 生命周期、试用期、计划变更、按比例计费以及按需收费
mobile-checkout	React Native、Flutter、iOS 和 Android 的应用内 checkout
webhook-integration	使用 Standard Webhooks 规范接收并验证 webhooks
credit-based-billing	Credit entitlements、余额、ledger、rollover、overage 以及基于 meter 的扣减
usage-based-billing	Meters、事件接收、聚合以及按单位定价
license-keys	License key 激活、验证和实例管理
product-catalog-management	Products、定价、add-ons、collections、图像和数字产品交付
discounts-and-promotions	Discount codes、资格规则、叠加使用和订阅周期限制
localized-pricing	本地化定价、Adaptive Currency 和购买力平价
customer-management	Customers、自助服务门户、已保存的支付方式和 wallets
refunds-and-disputes	发起退款、处理争议和拒付，以及协调访问权限
billing-sdk	用于定价表和 billing UI 的 BillingSDK React 组件
better-auth-integration	用于 customer sync、checkout 和 portal access 的 @dodopayments/better-auth 插件

技能会自动加载——代理检测到相关任务时会选择合适的技能。请参阅 Agent Skills 了解完整列表和单独安装方式。

​

首先尝试此提示词

插件激活后，尝试：

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

你的代理会加载 webhook-integration 技能，使用 dodo-knowledge MCP 获取最新的 payload 结构，并按照 Standard Webhooks 规范编写包含签名验证的 handler。

​

客户端支持

该插件遵循 Agent Plugins 1.0.0 规范。具有原生支持的客户端会直接加载它；其他客户端则使用生成的兼容性 manifest。

​

支持插件安装的代理

一次安装即可连接两个 MCP 服务器；对于具有 skill 原语的客户端，还会连接这些技能。

代理	安装方式	技能	MCP 服务器
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 需要额外的 skills.paths 条目，之后才会加载其十七项技能。Gemini CLI 没有 agent-skill 原语，因此技能按设计不可用。

​

其他兼容 MCP 的客户端

这些客户端不支持 Agent Plugin 安装。请手动配置两个 MCP 服务器，并在支持的情况下通过 Skills CLI 添加技能。

代理	MCP 服务器	技能
Claude Desktop	MCP Server 指南	不支持
Windsurf	MCP Server 指南	Skills CLI
Cline / Zed / 其他	MCP Server 指南	Skills CLI

​

专为代理构建的文档

每个 Dodo Payments 文档页面都有针对 AI 使用进行优化的格式：

• 完整文档索引：docs.dodopayments.com/llms.txt——用于上下文摄取的完整文档索引
• 纯 Markdown：在任意文档 URL 后追加 .md，即可获取原始 Markdown 版本（例如 /api-reference/introduction.md）
• 源代码仓库：github.com/dodopayments/dodo-docs——克隆后即可离线建立索引

​

你的代理可以做什么

安装插件后，你的编码代理可以：

• 创建 checkout sessions 和 payment links——一次性支付 和 订阅
• 端到端搭建订阅和基于用量的计费——订阅、基于用量的计费、基于额度的计费
• 生成符合 Standard Webhooks 的 handlers，并进行签名验证——Webhooks
• 使用官方适配器在框架中挂载 route handlers——框架适配器
• 接入 BillingSDK React 组件，用于定价表和订阅管理——BillingSDK
• 编写数字产品的 license-key 流程——License keys
• 实现基于额度的计费，包含 entitlements、余额、rollover 和 overage——Credits
• 构建和管理产品目录，包含 add-ons 和 collections——Products、Add-ons、Product collections
• 添加折扣和本地化定价——Discount codes、Localized pricing、Adaptive currency
• 为 React Native、Flutter、iOS 和 Android 发布移动端应用内 checkout——移动端集成
• 处理退款、争议和客户自助服务——退款、争议、Customer portal
• 测试集成并安全上线——Test mode 与 live mode

​

安全性和最佳实践

切勿提交 live API keys。开发期间请使用 test mode。

• 首先使用 test mode。 在上线前，使用 test mode API key 构建并测试集成。请参阅 Test Mode 与 Live Mode。
• OAuth 是默认方式。 Agent Plugin 通过浏览器 OAuth 进行身份验证（无需本地 secrets）。只有在需要时才使用 API-key mode。
• 审查代理生成的代码。 始终确认 webhook handlers 按照 Standard Webhooks 规范包含签名验证。

​

使用 API Key 配置

默认情况下，Agent Plugin 使用带浏览器 OAuth 的远程 MCP 服务器。若要改用本地 API key，例如在 CI 或无头服务器上使用，请切换到 stdio mode。

Local API key mode — Claude Code

在 Claude Code 中打开 /plugins，选择 Dodo Payments，然后选择 Configure options。填写：

• dodo_api_key——你的 test mode 或 live mode API key
• dodo_webhook_key——你的 webhook signing secret
• dodo_environment——test_mode 或 live_mode

然后编辑 .mcp.json，使 dodopayments-api 指向本地 stdio 服务器：

{
  "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}"
      }
    }
  }
}

运行 /reload-plugins 以应用更改。

Local API key mode — OpenCode

在 opencode.json 中自行声明 dodopayments-api——你的条目会覆盖插件默认的远程服务器：

{
  "$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
    }
  }
}

重启 OpenCode 以应用更改。

​

后续步骤

MCP Server

两个 MCP 服务器的完整参考——所有支持的客户端、配置和可用工具

Agent Skills

单独的技能安装、技能参考和各代理的设置说明

API Reference

所有 Dodo Payments endpoint 的完整 OpenAPI 参考