Paddle Billing 的 MCP 服务器

Paddle Billing 是一个以开发者为中心的商户记录平台。我们通过一个统一的 API 处理支付、税务、订阅和指标等所有事务。

这是一个 Model Context Protocol (MCP) 服务器，提供与 Paddle API 交互的工具。

重要提示： 此 MCP 服务器适用于 Paddle Billing。它不支持 Paddle Classic。如需使用 Paddle Classic，请参阅：Paddle Classic API 参考

功能

• 列出 Paddle 目录中的产品
• 创建新产品
• 列出产品的价格
• 为产品创建新价格
• 列出客户
• 列出交易
• 列出订阅
• 创建用于财务分析的自定义报告

安装

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

• 沙箱环境: https://sandbox-vendors.paddle.com/authentication-v2
• 生产环境: https://vendors.paddle.com/authentication-v2

您可以使用 npx 运行 Paddle MCP 服务器，命令如下：

npx -y @paddle/paddle-mcp --api-key=PADDLE_API_KEY --environment=(sandbox|production)

将 PADDLE_API_KEY 替换为您的 API 密钥，并传递正确的值作为 environment。

要在像 Claude Desktop、Cursor 或 Windsurf 这样的客户端中运行服务器，请在您的 MCP 配置中添加以下内容：

{
  "mcpServers": {
    "paddle": {
      "command": "npx",
      "args": ["-y", "@paddle/paddle-mcp", "--api-key=PADDLE_API_KEY", "--environment=(sandbox|production)"]
    }
  }
}

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

• Claude Desktop
• Cursor
• Windsurf

开发

1. 安装依赖项：

   pnpm install
   

2. 构建服务器：

   pnpm build
   

3. 更新客户端以使用本地构建：

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

调试

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

1. 使用 inspector 运行服务器：

   pnpm inspector
   

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

3. 包含 --api-key 和 --environment 参数。

了解更多

• Paddle 开发者文档
• Paddle API 参考
• 注册 Paddle Billing