Paddle MCP Server

用于桨式计费的MCP服务器

桨式计费 是开发商第一个有记录的商家。我们通过一个统一的API来处理支付、税务、订阅和指标。

这是一个 模型上下文协议（MCP） 服务器，为LLM和AI代理提供用于与Paddle API交互的工具。

重要提示： 此MCP服务器与Paddle Billing配合使用。它不支持Paddle Classic。要使用Paddle Classic，请参阅： 桨经典API参考


特性

MCP服务器与Paddle API几乎等同，允许AI助手和代理：

• 管理您的完整Paddle目录
• 查看客户、购买和配置信息
• 处理订阅、付款和退款工作流程
• 调试计费和订单管理问题
• 直接在对话中创建和调整交易
• 生成财务报告，以获取财务和运营见解
• 更快地实施和测试Paddle集成

可用工具

MCP服务器可以使用以下工具对您的Paddle帐户执行操作：

Products

Prices

Discounts

Discount Groups

Customers

Addresses

Businesses

Transactions

Adjustments

Subscriptions

Saved Payment Methods

Customer Portal Sessions

Notification Settings

Events

Notifications

Notification Logs

Simulations

Simulation Runs

Simulation Run Events

Reports

Client-Side Tokens

安装

要使用MCP服务器，您需要一个API密钥。您可以在中创建和管理API密钥 Paddle>开发工具>身份验证:

• 沙箱：
• 直播：

在MCP设置文件中添加以下内容将在Claude Desktop、Cursor或Windsurf等客户端中配置和运行Paddle MCP服务器：

方法1：在Cursor或VS Code中单击安装

只需单击Cursor或VS Code即可安装Paddle MCP服务器。


安装后，您需要更新MCP设置文件中的配置以替换 your_api_key 使用实际的Paddle API键，并根据需要调整环境和工具值。

方法2：使用命令行参数（建议用于 npx)

将以下内容添加到您正在使用的客户端中的MCP设置或配置文件中：

{
  "mcpServers": {
    "paddle": {
      "command": "npx",
      "args": [
        "-y",
        "@paddle/paddle-mcp",
        "--api-key=your_api_key",
        "--environment=sandbox",
        "--tools=non-destructive"
      ]
    }
  }
}

替换 your_api_key 使用您的实际桨API键，设置 --environment 要么 sandbox 或 production，并设置 --tools 您希望加载并可供MCP客户端使用的工具。

方法3：使用环境变量

将以下内容添加到您正在使用的客户端中的MCP设置或配置文件中：

{
  "mcpServers": {
    "paddle": {
      "command": "npx",
      "args": ["-y", "@paddle/paddle-mcp"],
      "env": {
        "PADDLE_API_KEY": "your_api_key",
        "PADDLE_ENVIRONMENT": "sandbox",
        "PADDLE_MCP_TOOLS": "non-destructive"
      }
    }
  }
}

替换 your_api_key 使用您的实际桨API键，设置 PADDLE_ENVIRONMENT 要么 sandbox 或 production，并设置 PADDLE_MCP_TOOLS 您希望加载并可供MCP客户端使用的工具。

过滤工具

你可以过滤哪些 工具 通过传递 --tools 参数（方法2）或设置 PADDLE_MCP_TOOLS 环境变量（方法1或3）。可接受的值为：

• all -所有工具都可用
• read-only -只有读取操作可用
• non-destructive -读取操作和安全写入操作可用（默认）
• 以逗号分隔的特定工具名称列表（例如。， list_products,get_product,create_product)

有关详细的设置指南，请参阅：

• 克劳德桌面
• 光标
• 帆板运动

发展

1. 安装依赖项：

   pnpm install

1. 构建服务器：

   pnpm build

1. 更新客户端以使用本地版本：

   {
     "mcpServers": {
       "paddle": {
         "command": "node",
         "args": ["path/to/paddle-mcp-server/build/index.js"],
         "env": {
           "PADDLE_API_KEY": "your_api_key",
           "PADDLE_ENVIRONMENT": "sandbox",
           "PADDLE_MCP_TOOLS": "all"
         }
       }
     }
   }

这 PADDLE_MCP_TOOLS 环境变量接受与 --tools 论点： all, read-only, non-destructive，或以逗号分隔的工具名称列表。如果未设置，则默认为 non-destructive.

调试

要调试MCP服务器，您可以使用MCP检查器工具：

1. 使用检查器运行服务器：

   pnpm inspector

1. 在浏览器中打开提供的URL，查看和调试MCP请求和响应。

1. 包括 --api-key 和 --environment 论据。

了解更多

• Paddle开发人员文档
• 桨API参考
• 注册Paddle账单