跳转到主要内容

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 插件将两个 MCP 服务器和八个集成技能接入到您的一次安装的 AI 编码代理中。它兼容 Claude Code、Codex CLI、Cursor 和 OpenCode——以及 MCP 服务器和技能 CLI，适用于任何 MCP 兼容客户端。
三个原语，一个插件。 Agent 插件将您所需的一切打包:
  • API MCP 服务器——实时访问支付、订阅、客户、产品、退款、许可证和使用情况。通过浏览器 OAuth 进行身份验证（无需本地密钥）。
  • 知识 MCP 服务器——跨所有 Dodo Payments 文档的语义搜索。无需凭据。
  • 八个代理技能——辅助材料帮助您的代理按需加载结账、订阅、webhooks、基于使用的计费、基于信用的计费、许可证密钥、BillingSDK 和最佳实践。

​
安装插件

选择下方的编程代理。安装会自动添加两个 MCP 服务器和所有八个技能。

Claude Code

从市场安装：
claude plugins marketplace add dodopayments/dodo-agent-plugin
claude plugins install dodopayments@dodopayments
API MCP 服务器默认使用浏览器 OAuth——安装时不需要密钥。代理第一次调用 Dodo 工具时，会提示您登录。

Dodo Agent Plugin on GitHub

源代码、配置选项和本地开发说明
Codex 能够原生读取 .claude-plugin/marketplace.json，因此相同的插件库可以工作：
codex plugin marketplace add dodopayments/dodo-agent-plugin
codex plugin install dodopayments@dodopayments
两个 MCP 服务器和所有八个技能会自动注册。
手动安装——将 repo 克隆到 Cursor 的本地插件目录中：
git clone https://github.com/dodopayments/dodo-agent-plugin.git ~/.cursor/plugins/local/dodo-agent-plugin
重启 Cursor。插件会通过 Cursor 的 Claude Code 兼容层从 .claude/skills/ 和从 .mcp.json 加载 MCP 服务器。
Cursor 市场支持即将到来。当前请使用上面的手动安装。
OpenCode 通过 npm 分发。将插件添加到您的 opencode.json：
{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["@dodopayments/opencode-plugin"]
}
重启 OpenCode。通过插件的配置挂钩，两个 MCP 服务器（dodopayments-api, dodo-knowledge）自动注册，八个技能会根据安装包自动发现。无需手动 mcp 块。
使用不同的代理？参阅 MCP 服务器 和 代理技能 指南，涵盖 Cursor、Claude Desktop、VS Code、Windsurf、Cline、Zed 及任何 MCP 兼容客户端。

​
您将获得的内容

插件安装后，您的代理可以访问两个 MCP 服务器和八个技能。

​
MCP 服务器

服务器目的身份验证
dodopayments-api实时 API 访问——支付、订阅、客户、产品、退款、许可证、使用OAuth（浏览器）
dodo-knowledge跨所有 Dodo Payments 文档的语义搜索无
两个服务器通过 mcp-remote 连接，因此可以在任何 MCP 兼容客户端中运行。

​
代理技能

技能描述
best-practices整合 Dodo Payments 的最佳实践综合指南
checkout-integration创建结账会话和支付流程
subscription-integration实施订阅计费流程
webhook-integration为支付事件设置和处理 webhooks
usage-based-billing使用事件和计量器实现计量计费
credit-based-billing信用权益、余额和计量信用扣减
license-keys管理数字产品的许可证密钥
billing-sdk使用 BillingSDK React 组件
技能自动加载——当检测到相关任务时，您的代理会选择合适的。请参阅 代理技能文档 查看完整列表和个别安装。

​
首次尝试此提示

插件激活后，尝试： 
Set up Dodo Payments webhook handlers in my Next.js app for payment.succeeded and subscription.active events.
您的代理将加载 webhook-integration 技能，使用 dodo-knowledge MCP 获取最新的负载形状，并编写符合标准 Webhooks 规范的带有签名验证的处理程序。

​
其他支持的代理

Agent 插件覆盖 Claude Code、Codex CLI、Cursor 和 OpenCode。如果使用其他代理，通过 MCP 服务器和技能 CLI 连接 Dodo Payments：
代理最快路径还支持
Claude CodeAgent 插件（单命令）MCP 服务器，个别技能
Codex CLIAgent 插件（单命令）MCP 服务器
CursorAgent 插件（git clone）MCP 服务器配置、技能 CLI
OpenCodeAgent 插件（npm）MCP 服务器配置、技能 CLI
GitHub Copilot (VS Code)MCP 服务器指南技能 CLI
Claude DesktopMCP 服务器指南—
WindsurfMCP 服务器指南技能 CLI
Cline / Zed / othersMCP 服务器指南技能 CLI

​
为代理构建的文档

每个 Dodo Payments 文档页面都已优化为适合 AI 使用的格式：
  • 完整文档索引：docs.dodopayments.com/llms.txt — 提供完整的文档索引以供上下文使用。
  • 纯 markdown：在任何文档 URL 后面附加 .md 可以获取原始 markdown 版本（例如，/api-reference/introduction.md）。
  • 源代码库：github.com/dodopayments/dodo-docs — 克隆以进行离线索引。

​
您的代理可以做些什么

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

​
安全性和最佳实践

切勿提交生产 API 密钥。 在开发期间使用 测试模式。Agent 插件默认使用浏览器 OAuth——仅在您的工作流需要时切换到本地 API 密钥。
  • 首先使用测试模式。 使用 dodo_test_... 密钥在上线前对集成进行沙盒测试。参见 测试模式与实时模式。
  • OAuth 是默认值。 Agent 插件通过浏览器 OAuth 进行身份验证（没有本地密钥）。仅在需要时使用 API 密钥模式——请参阅下方的配置部分。
  • 检查代理生成的代码。 始终验证 webhook 处理程序是否包含符合 标准 Webhooks 规范 的签名验证。

​
使用 API 密钥进行配置

默认情况下，Agent 插件使用带有浏览器 OAuth 的远程 MCP 服务器——无需本地凭据。如果您的工作流需要本地 API 密钥（例如 CI 环境，无头服务器），您可以切换到 stdio 模式。
在 Claude Code 中打开 /plugins，选择 Dodo Payments，然后选择 配置选项。填写：
  • dodo_api_key — 您的 dodo_test_... 或 dodo_live_... 密钥
  • 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 将更改应用于当前会话。
在 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": "dodo_test_...",
        "DODO_PAYMENTS_WEBHOOK_KEY": "whsec_...",
        "DODO_PAYMENTS_ENVIRONMENT": "test_mode"
      },
      "enabled": true
    }
  }
}
重启 OpenCode 以应用。

​
下一步

MCP Server

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

Agent Skills

个别技能安装、技能参考和每个代理的设置说明

Sentra IDE Assistant

AI 驱动的账单助手适用于 VS Code、Cursor 和 Windsurf——在编辑器中询问、构建和计划

API Reference

所有 Dodo Payments 端点的完整 OpenAPI 参考
Last modified on May 4, 2026