Paddle MCP Server

🚀 Paddle 請求書を処理する MCP サーバーの使用

Paddle 請求書 は、開発者向けの merchant of record（ライセンスを持つ事業者）です。私たちは、統一された API を通じて、支払い、税金、サブスクリプション、指標の処理を担当します。

これは、Model Context Protocol (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 キーに置き換え、正しい環境値（sandbox または production）を指定してください。

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 ドキュメント