Paddle Billing

🚀 Paddle 賬單 MCP 服務器

Paddle 賬單是面向開發者的持牌商家，負責處理付款、稅收、訂閱和指標等事務，通過一個統一的 API 來實現所有功能。本項目是一個模型上下文協議 (MCP) 服務器，提供了與 Paddle API 交互的工具。

🚀 快速開始

Paddle 賬單是面向開發者的持牌商家，通過統一 API 處理付款、稅收、訂閱和指標等事務。本 MCP 服務器可與之交互，助力開發者工作。

⚠️ 重要提示

此 MCP 服務器適用於 Paddle 賬單，不支持 Paddle 經典版本。如需使用 Paddle 經典版本，請參閱：Paddle 經典 API 參考

✨ 主要特性

• 列出您 Paddle 產品目錄中的商品
• 創建新商品
• 列出商品的價格
• 為商品創建新的價格
• 列出客戶
• 列出交易
• 列出訂閱
• 創建自定義報告以進行財務分析

📦 安裝指南

要使用 MCP 服務器，您需要一個 API 密鑰。您可以在 Paddle > 開發工具 > 認證 中創建和管理 API 密鑰：

• 沙盒環境: https://sandbox-vendors.paddle.com/authentication-v2
• 生產環境: https://vendors.paddle.com/authentication-v2

使用 npx 運行

您可以使用 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

💻 使用示例

基礎用法

在客戶端中運行服務器的配置示例：

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

高級用法

在開發環境中更新客戶端以使用本地構建的配置示例：

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

📚 詳細文檔

開發步驟

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 檢查工具：

1. 使用檢查工具運行服務器：

pnpm inspector

2. 在瀏覽器中打開提供的 URL 以查看和調試 MCP 請求和響應。
3. 包括 --api-key 和 --environment 參數。

更多信息

• Paddle 開發文檔
• Paddle API 參考
• 註冊 Paddle 賬單