Mcp сервер для Paddle Billing

Что такое Paddle MCP Server?

Paddle MCP Server — это мощный инструмент, предназначенный для упрощения взаимодействия с Paddle API. Он позволяет разработчикам управлять различными аспектами своих учетных записей Paddle, включая каталоги продуктов, выставление счетов, подписки и отчетность. Этот сервер служит мостом между вашими приложениями и услугами Paddle, позволяя бесшовную интеграцию и автоматизацию задач.

Особенности Paddle MCP Server

• Интеграция API: Легко подключайтесь к Paddle API для выполнения операций, таких как создание продуктов, управление подписками и обработка платежей.
• Совместимость с AI-ассистентами: Взаимодействуйте с Paddle с помощью AI-ассистентов, таких как Claude, или через AI-IDE, такие как Cursor, повышая продуктивность и эффективность.
• Комплексное управление: Управляйте всем своим каталогом продуктов, процессами выставления счетов и моделями подписок из одного интерфейса.
• Инструменты отчетности: Генерируйте подробные отчеты для анализа продаж, поведения клиентов и других ключевых метрик для принятия обоснованных бизнес-решений.
• Открытый исходный код: Paddle MCP Server доступен для общественности, позволяя разработчикам вносить свой вклад в его развитие и настраивать его под свои конкретные нужды.

Как использовать Paddle MCP Server

1. Установка: Начните с клонирования репозитория с GitHub. Используйте команду:

   git clone https://github.com/PaddleHQ/paddle-mcp-server.git
   

2. Конфигурация: Настройте свои ключи API Paddle и конфигурируйте настройки сервера в соответствии с вашими требованиями.
3. Запуск сервера: Запустите сервер, используя соответствующую команду для вашей среды. Убедитесь, что все зависимости установлены.
4. Вызовы API: Используйте предоставленные конечные точки API для взаимодействия с Paddle. Вы можете создавать, читать, обновлять и удалять ресурсы по мере необходимости.
5. Мониторинг и отчетность: Используйте встроенные инструменты отчетности для мониторинга ваших продаж и подписок, внося необходимые корректировки.

Часто задаваемые вопросы

В: Какие языки программирования поддерживает Paddle MCP Server?

О: Paddle MCP Server разработан так, чтобы быть независимым от языка, позволяя интеграцию с любым языком программирования, который может делать HTTP-запросы.

В: Является ли Paddle MCP Server бесплатным для использования?

О: Да, Paddle MCP Server является открытым исходным кодом и бесплатен для использования. Вы можете изменять и распространять его на условиях лицензии Apache-2.0.

В: Могу ли я внести вклад в Paddle MCP Server?

О: Абсолютно! Вклады приветствуются. Вы можете отправлять проблемы, запросы на функции или пулл-реквесты в репозиторий на GitHub.

В: Как мне сообщить об ошибке?

О: Если вы столкнулись с какими-либо проблемами, пожалуйста, сообщите о них на странице проблем репозитория Paddle MCP Server на GitHub.

В: Где я могу найти дополнительную документацию?

О: Дополнительная документация и ресурсы доступны на Портале разработчиков Paddle.

MCP Server for Paddle Billing

Paddle Billing is the developer-first merchant of record. We take care of payments, tax, subscriptions, and metrics with one unified API that does it all.

This is a Model Context Protocol (MCP) server that provides tools for interacting with the Paddle API.

Important: This MCP server works with Paddle Billing. It does not support Paddle Classic. To work with Paddle Classic, see: Paddle Classic API reference

Features

• List products in your Paddle catalog
• Create new products
• List prices for products
• Create new prices for products
• List customers
• List transactions
• List subscriptions
• Create custom reports for financial analysis

Installation

To use the MCP server, you'll need an API key. You can create and manage API keys in Paddle > Developer tools > Authentication:

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

To run the server in a client like Claude Desktop, Cursor or Windsurf, add the following to your MCP config:

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

Replace PADDLE_API_KEY with your API key, and pass the correct value as environment.

For detailed setup guides, see:

• Claude Desktop
• Cursor
• Windsurf

Development

1. Install dependencies:

   pnpm install
   

2. Build the server:

   pnpm build
   

3. Update client to use the local build:

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

Debugging

To debug the MCP server, you can use the MCP Inspector tool:

1. Run the server with the inspector:

   pnpm inspector
   

2. Open the provided URL in your browser to view and debug the MCP requests and responses.

3. Include the --api-key and --environment arguments.

Learn more

• Paddle developer docs
• Paddle API reference
• Sign up for Paddle Billing