MCP Server for Paddle Billing

Paddle Billing és el merchant de registre orientat als desenvolupadors. Ens encarreguem dels pagaments, impostos, subscripcions i mètriques amb una única API unificada que ho fa tot.

Aquest és un servidor Model Context Protocol (MCP) que ofereix eines per a interactuar amb l'API de Paddle.

Important: Aquest servidor MCP funciona amb Paddle Billing. No admet Paddle Classic. Per treballar amb Paddle Classic, consulta: Paddle Classic API reference

Features

• Llista els productes del teu catàleg Paddle
• Crea nous productes
• Llista els preus dels productes
• Crea nous preus per als productes
• Llista els clients
• Llista les transaccions
• Llista les subscripcions
• Crea informes personalitzats per a l'anàlisi financera

Installation

Per utilitzar el servidor MCP, necessitaràs una clau d'API. Pots crear i gestionar claus d'API a Paddle > Developer tools > Authentication:

• Sandbox: https://sandbox-vendors.paddle.com/authentication-v2
• Live: https://vendors.paddle.com/authentication-v2

Per executar el servidor en un client com Claude Desktop, Cursor o Windsurf, afegeix el següent a la teva configuració MCP:

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

Substitueix PADDLE_API_KEY amb la teva clau d'API, i passa el valor correcte com a environment.

Per a guies de configuració detallades, consulta:

• Claude Desktop
• Cursor
• Windsurf

Development

1. Instal·la les dependències:

   pnpm install
   

2. Construeix el servidor:

   pnpm build
   

3. Actualitza el client per utilitzar la construcció local:

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

Debugging

Per depurar el servidor MCP, pots utilitzar l'eina MCP Inspector:

1. Executa el servidor amb l'inspector:

   pnpm inspector
   

2. Obre l'URL proporcionada al teu navegador per visualitzar i depurar les sol·licituds i respostes MCP.

3. Inclou els arguments --api-key i --environment.

Learn more

• Documentació per a desenvolupadors de Paddle
• Referència de l'API de Paddle
• Registra't a Paddle Billing