dodo-agent-plugin

用途

Dodo Payments Agent Plugin 是 Dodo Payments 官方发布的 AI 编程代理插件，目标是为各类 AI 编程代理提供 Dodo Payments 的集成能力，让代理能够直接调用 Dodo Payments 的支付 API、搜索官方文档，并在需要时加载对应的集成技能。它遵循 Agent Plugins 1.0.0 规范，使用单一来源（root plugin.json、skills/、mcp.json）生成各客户端兼容清单。

主要能力

MCP 服务器

Dodo Payments API MCP 服务器：提供实时 API 访问，覆盖 payments、subscriptions、customers、products、refunds、licenses、usage。默认使用浏览器 OAuth 认证，安装时无需本地凭据；首次调用 Dodo 工具时会提示登录。
Dodo Knowledge MCP 服务器：无需凭据，对当前 Dodo Payments 文档进行语义搜索。两个服务器均使用 Streamable HTTP over HTTPS，各清单原生拨号，无需 npx mcp-remote 桥接，无 Node 依赖。规范 mcp.json 使用 type: "streamable-http"；生成的 .mcp.json（用于 Claude Code、Cursor、VS Code、Grok Build、Devin、Goose、Droid）使用相同端点但拼写为 type: "http"；Muse、Antigravity、Junie、Gemini 使用各自的拼写。

Agent 技能

技能以 SKILL.md 文件（带 YAML frontmatter）形式提供，代理会在任务需要时自行加载相关技能。包含的技能主题：

Getting started
Accepting payments
Catalog and pricing
Customers and operations
UI and integrations 技能源自 dodopayments/skills，以真实文件形式 vendored 到 skills/ 目录，来源记录在 .skills-source.json。

使用方式

安装（各客户端）

通用：注册 marketplace 后安装插件。
Codex CLI：在 TUI 中运行 codex，输入 /plugins，选择 Dodo Payments marketplace 和 dodopayments 插件，然后选择 Install plugin。若已添加过 marketplace 但插件未出现，可刷新。
手动安装：克隆仓库。
Cursor：重启 Cursor。插件从 skills/ 加载技能，从 .mcp.json 加载 MCP 服务器，依据 .cursor-plugin/plugin.json 声明。Cursor 3.14.27 也直接识别 Agent Plugins 1.0.0。
Kiro：原生读取 Agent Plugins 清单并作为 Power 加载；指向克隆的文件夹即可。
Gemini CLI：gemini-extension.json 在仓库根目录作为清单，Gemini 自动发现旁边的 skills/ 目录。已验证于 Gemini CLI 0.63.0：gemini skills list 显示所有技能，gemini mcp list 显示两个服务器。
VS Code / GitHub Copilot：打开 Chat 视图，进入 Plugins，添加克隆的文件夹。技能从 skills/ 加载，两个 MCP 服务器从 .mcp.json 加载。
OpenCode：通过 npm 分发。将插件加入 opencode.json 后重启 OpenCode，两个 MCP 服务器（dodopayments-api、dodo-knowledge）会自动注册为原生远程服务器。运行 opencode mcp auth dodopayments-api 登录 API 服务器。技能需要本地安装包并额外配置 skills.paths 指向包的 skills/ 目录（相对项目目录解析，因此包需存在于项目 node_modules 中；也可使用绝对路径）。

可选配置（Claude Code）

若希望使用本地 stdio API 服务器和自己的 API key，而非默认远程 OAuth 服务器，可在 Claude Code 中打开 /plugins，选择 Dodo Payments，选择 Configure options，填写：

dodo_api_key：dodo_test_... 或 dodo_live_...
dodo_webhook_key：webhook 签名密钥
dodo_environment：test_mode 或 live_mode 随后编辑 .mcp.json 将 dodopayments-api 指向本地 stdio 服务器，运行 /reload-plugins 应用。

启用/禁用 MCP 服务器

两个 MCP 默认均启用，可独立关闭。npm 插件在注册 MCP 前读取两个环境变量。真值：1、true、yes、on（不区分大小写）。Claude Code、Codex CLI、Cursor 从静态 .mcp.json 加载 MCP，禁用需在项目级配置覆盖对应条目并设置 "enabled": false；Claude Code 可运行 claude mcp disable dodopayments-api，然后 /reload-plugins。

尝试示例

插件激活后，可尝试让代理加载 webhook-integration 技能，使用 dodo-knowledge MCP 获取最新 payload 形状，并按照 Standard Webhooks 规范编写带签名验证的处理器。

适用场景

在 AI 编程代理中集成 Dodo Payments 支付、订阅、退款、许可证与用量计费。
通过语义搜索快速查阅 Dodo Payments 文档。
需要代理自动加载支付相关技能并生成集成代码。

限制

技能需要 OpenCode 本地安装包及额外配置，且不存在 skills 路径会被静默忽略。
VS Code 1.125.1 不基于 Agent Plugins $schema，通过兼容清单加载；MCP 默认使用 .mcp.json 而非 mcp.json。
版本低于 v0.5.0 的克隆会产生无工作技能（skills/ 为符号链接指向子模块），需重新克隆。
Claude Code 的 /plugin UI 中按 MCP 切换功能尚未上游支持。

开发与许可

仓库无子模块、无构建步骤；技能以真实文件 vendored。提供校验、加载与发布流程。许可证为 MIT。

工具介绍

用途