Paddle Billing

🚀 Paddle 账单 MCP サーバー

Paddle 账单 は開発者向けの merchant of record（ライセンスを持つ商家）です。私たちは支払い、税務、サブスクリプション、指標の処理を担当し、統一された API を通じてすべての機能を実現します。

これは モデルコンテキストプロトコル (MCP) サーバーで、Paddle API とのやり取りを行うツールを提供します。

⚠️ 重要な注意

この MCP サーバーは Paddle 請求書に対応しています。Paddle の旧バージョンはサポートされていません。Paddle の旧バージョンを使用する場合は、Paddle 旧 API リファレンス を参照してください。

✨ 主な機能

• Paddle の商品カタログにある商品を一覧表示する
• 新しい商品を作成する
• 商品の価格を一覧表示する
• 商品に新しい価格を設定する
• 顧客を一覧表示する
• 取引を一覧表示する
• サブスクリプションを一覧表示する
• 財務分析用のカスタムレポートを作成する

📦 インストール

MCP サーバーを使用するには、API キーが必要です。API キーは Paddle > 開発ツール > 認証 で作成および管理できます。

• サンドボックス: 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 インスペクターツールを使用できます。

1. インスペクターツールを使用してサーバーを実行します。

pnpm inspector

2. ブラウザで提供された URL を開き、MCP のリクエストとレスポンスを表示およびデバッグします。
3. --api-key と --environment パラメーターを含めてください。

📚 ドキュメント

• Paddle 開発ドキュメント
• Paddle API リファレンス
• Paddle 請求書の登録