# Paddle 计费服务器
## 基本信息
- Slug: `paddlehq-paddle-mcp-server`
- Source: modelscope
- Publisher: @PaddleHQ/paddle-mcp-server
- Categories: 金融 / ecommerce-and-retail
- Hosted: No
- License: Apache License 2.0
- Source URL: https://www.modelscope.cn/mcp/servers/@PaddleHQ/paddle-mcp-server
## 简介
一种模型上下文协议服务器，提供与Paddle计费API交互的工具，使用户能够管理产品、价格、客户、交易、订阅并创建自定义财务报告。
## 安装提示

```bash
npx -y @paddle/paddle-mcp --api-key=PADDLE_API_KEY --environment=(sandbox|production)
```

## MCP Server 详情

# Paddle Billing 的 MCP 服务器

[Paddle Billing](https://www.paddle.com/billing?utm_source=dx&utm_medium=paddle-mcp-server) 是一个以开发者为中心的商户记录平台。我们通过一个统一的 API 处理支付、税务、订阅和指标等所有事务。

这是一个 [Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction) 服务器，提供与 Paddle API 交互的工具。

> **重要提示：** 此 MCP 服务器适用于 Paddle Billing。它不支持 Paddle Classic。如需使用 Paddle Classic，请参阅：[Paddle Classic API 参考](https://developer.paddle.com/classic/api-reference/1384a288aca7a-api-reference?utm_source=dx&utm_medium=paddle-mcp-server)

## 功能

- 列出 Paddle 目录中的产品
- 创建新产品
- 列出产品的价格
- 为产品创建新价格
- 列出客户
- 列出交易
- 列出订阅
- 创建用于财务分析的自定义报告

## 安装

要使用 MCP 服务器，您需要一个 API 密钥。您可以在 **Paddle > 开发者工具 > 身份验证** 中创建和管理 API 密钥：

- 沙箱环境: https://sandbox-vendors.paddle.com/authentication-v2
- 生产环境: https://vendors.paddle.com/authentication-v2

您可以使用 `npx` 运行 Paddle MCP 服务器，命令如下：

```bash
npx -y @paddle/paddle-mcp --api-key=PADDLE_API_KEY --environment=(sandbox|production)
```


将 `PADDLE_API_KEY` 替换为您的 API 密钥，并传递正确的值作为 `environment`。

要在像 Claude Desktop、Cursor 或 Windsurf 这样的客户端中运行服务器，请在您的 MCP 配置中添加以下内容：

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


有关详细的设置指南，请参阅：

- [Claude Desktop](https://modelcontextprotocol.io/quickstart/user)
- [Cursor](https://docs.cursor.com/context/model-context-protocol)
- [Windsurf](https://docs.codeium.com/windsurf/mcp)

## 开发

1. 安装依赖项：

   ```bash
   pnpm install
   ```

2. 构建服务器：

   ```bash
   pnpm build
   ```

3. 更新客户端以使用本地构建：
   ```json
   {
     "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 运行服务器：

   ```bash
   pnpm inspector
   ```

2. 在浏览器中打开提供的 URL 以查看和调试 MCP 请求和响应。

3. 包含 `--api-key` 和 `--environment` 参数。

## 了解更多

- [Paddle 开发者文档](https://developer.paddle.com?utm_source=dx&utm_medium=paddle-mcp-server)
- [Paddle API 参考](https://developer.paddle.com/api-reference/overview?utm_source=dx&utm_medium=paddle-mcp-server)
- [注册 Paddle Billing](https://login.paddle.com/signup?utm_source=dx&utm_medium=paddle-mcp-server)