Paddlehq Paddle MCP Server

🚀 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 キーに置き換え、正しい環境値を指定してください。

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 账单に登録する