使用 AI 代码代理构建

安装 Dodo Agent Plugin，为您的编程代理提供两个 MCP 服务器和十七项技能，用于构建 Dodo Payments 集成。安装后，只需描述您想构建的内容，您的代理就会规划并编写集成代码。该插件支持 Claude Code、Codex CLI、Cursor、VS Code / GitHub Copilot、Kiro 和 OpenCode。Gemini CLI 仅支持两个 MCP 服务器。该插件遵循 Agent Plugins 1.0.0 规范。具有原生支持的客户端会直接加载它；其他客户端则使用生成的兼容性清单。 您将获得：

Dodo Payments API MCP 服务器 — 实时访问支付、订阅、客户、产品、退款、许可证和用量数据。通过浏览器 OAuth 进行身份验证（无需本地密钥）。
Dodo Knowledge MCP 服务器 — 对所有 Dodo Payments 文档进行语义搜索。无需凭据。
十七项代理技能 — 代理按需加载的速查表，涵盖结账、订阅、webhook、按用量计费和按额度计费、许可证密钥、产品目录、折扣、本地化定价、移动端结账、退款与争议、客户管理、框架适配器、BillingSDK、Better Auth、测试与上线，以及最佳实践。

安装插件

请在下方选择您的编程代理。每次安装都会添加两个 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

codex plugin marketplace add dodopayments/dodo-agent-plugin

Install from the Codex TUI

打开 Codex 并运行 /plugins：

codex

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

两个 MCP 服务器和全部十七项技能都会自动注册。如果插件未出现在 /plugins 下，请刷新：

codex plugin marketplace upgrade dodopayments

注册 marketplace 后，如果不想使用 TUI，而是想从 shell 安装，请运行 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 标记为实验性功能，并且属于受限设置，因此必须信任工作区。代理插件支持是由 chat.plugins.enabled 管理的预览功能，该功能默认开启。

Kiro

Kiro 原生读取 Agent Plugins 清单。

Clone the repository

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

Open the Powers panel

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

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 是清单。

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

您将获得什么

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

MCP 服务器

服务器	用途	身份验证
`dodopayments-api`	实时 API 访问——支付、订阅、客户、产品、退款、许可证、用量	OAuth（浏览器）
`dodo-knowledge`	对所有 Dodo Payments 文档进行语义搜索	无

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

代理技能

技能	描述
`dodo-best-practices`	SDK 设置、环境、API 密钥，以及从结账到 webhook 的标准架构
`framework-adapters`	用于 Next.js、Express、Hono、Astro、Remix、SvelteKit、Nuxt、Fastify、TanStack、Bun 和 Convex 的官方 `@dodopayments/*` 路由处理程序
`testing-and-go-live`	测试模式、测试支付方式、webhook 测试和生产环境上线检查清单
`checkout-integration`	Checkout Sessions、支付链接，以及覆盖式或内嵌式结账
`subscription-integration`	订阅生命周期、试用期、计划变更、按比例分摊和按需收费
`mobile-checkout`	React Native、Flutter、iOS 和 Android 的应用内结账
`webhook-integration`	使用 Standard Webhooks 规范接收和验证 webhook
`credit-based-billing`	额度权益、余额、账本、结转、超额用量和基于计量器的扣减
`usage-based-billing`	计量器、事件摄取、聚合和按单位定价
`license-keys`	许可证密钥激活、验证和实例管理
`product-catalog-management`	产品、定价、附加项、集合、图片和数字产品交付
`discounts-and-promotions`	折扣代码、资格规则、叠加使用和订阅周期限制
`localized-pricing`	本地化定价、Adaptive Currency 和购买力平价
`customer-management`	客户、自助服务门户、已保存的支付方式和钱包
`refunds-and-disputes`	发起退款、处理争议和拒付，以及协调访问权限
`billing-sdk`	用于定价表和计费界面的 BillingSDK React 组件
`better-auth-integration`	用于客户同步、结账和门户访问的 `@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 获取最新的负载结构，并按照 Standard Webhooks 规范编写带签名验证的处理程序。

客户端支持

支持插件安装的代理

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

代理	安装方式	技能	MCP 服务器
Claude Code	marketplace 命令	17	2
Codex CLI	marketplace 命令	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：将 .md 附加到任意文档 URL，即可获取原始 Markdown 版本（例如 /api-reference/introduction.md）
源代码仓库：github.com/dodopayments/dodo-docs — 克隆后即可进行离线索引

您的代理可以做什么

安装插件后，您的编程代理可以：

创建结账会话和支付链接 — 一次性支付和订阅
端到端构建订阅和按用量计费 — 订阅、按用量计费、按额度计费
生成符合 Standard Webhooks 的处理程序并验证签名 — Webhooks
使用官方适配器在框架中挂载路由处理程序 — 框架适配器
连接 BillingSDK React 组件以实现定价表和订阅管理 — BillingSDK
编写数字产品的许可证密钥流程 — 许可证密钥
实现按额度计费，包括权益、余额、结转和超额用量 — 额度
构建和管理产品目录，包括附加项和集合 — 产品、附加项、产品集合
添加折扣和本地化定价 — 折扣代码、本地化定价、Adaptive Currency
为 React Native、Flutter、iOS 和 Android 提供移动端应用内结账 — 移动端集成
处理退款、争议和客户自助服务 — 退款、争议、Customer Portal
测试集成并安全上线 — 测试模式与生产模式

安全与最佳实践

切勿提交生产 API 密钥。开发期间请使用测试模式。

先使用测试模式。 在上线前，使用测试模式 API 密钥构建并测试集成。请参阅测试模式与生产模式。
OAuth 是默认方式。 Agent Plugin 通过浏览器 OAuth 进行身份验证（无需本地机密）。仅在需要时使用 API 密钥模式。
检查代理生成的代码。 始终确认 webhook 处理程序根据 Standard Webhooks 规范进行签名验证。

使用 API 密钥配置

默认情况下，Agent Plugin 使用支持浏览器 OAuth 的远程 MCP 服务器。若要改用本地 API 密钥，例如在 CI 或无头服务器中使用，请切换到 stdio 模式。

Local API key mode — Claude Code

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

dodo_api_key — 您的测试模式或生产模式 API 密钥
dodo_webhook_key — 您的 webhook 签名密钥
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 端点的完整 OpenAPI 参考

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

安装插件

Dodo Agent Plugin on GitHub

您将获得什么

MCP 服务器

代理技能

首先尝试此提示词

客户端支持

支持插件安装的代理

其他兼容 MCP 的客户端

为代理构建的文档

您的代理可以做什么

安全与最佳实践

使用 API 密钥配置

后续步骤

MCP Server

Agent Skills

API Reference

​安装插件

Dodo Agent Plugin on GitHub

​您将获得什么

​MCP 服务器

​代理技能

​首先尝试此提示词

​客户端支持

​支持插件安装的代理

​其他兼容 MCP 的客户端

​为代理构建的文档

​您的代理可以做什么

​安全与最佳实践

​使用 API 密钥配置

​后续步骤

MCP Server

Agent Skills

API Reference

安装插件

您将获得什么

MCP 服务器

代理技能

首先尝试此提示词

客户端支持

支持插件安装的代理

其他兼容 MCP 的客户端

为代理构建的文档

您的代理可以做什么

安全与最佳实践

使用 API 密钥配置

后续步骤