适合谁
- 使用Paddle Billing的开发者
- 将AI助手集成到支付和订阅工作流
- 通过自然语言查询Paddle API数据
P
70FMRS · B
Paddle MCP服务器提供与Paddle Billing API的广泛集成，支持众多工具，功能强大。但需要注意权限控制和环境设置，避免误操作。
这是一个Model Context Protocol (MCP)服务器，为LLM和AI代理提供与Paddle API交互的工具。支持Paddle Billing，不支持Paddle Classic。功能几乎与Paddle API相当，允许管理产品目录、查看客户和购买信息、处理订阅和支付流程、调试账单问题、在对话中创建和调整交易、生成财务报告等。
工具能力
list_products
列出产品
create_product
创建产品
get_product
获取产品详情
update_product
更新产品
list_prices
列出价格
create_price
创建价格
get_price
获取价格详情
update_price
更新价格
preview_prices
预览价格
list_discounts
列出折扣
create_discount
创建折扣
get_discount
获取折扣详情
update_discount
更新折扣
list_discount_groups
列出折扣组
create_discount_group
创建折扣组
get_discount_group
获取折扣组详情
update_discount_group
更新折扣组
archive_discount_group
归档折扣组
list_customers
列出客户
create_customer
创建客户
get_customer
获取客户详情
update_customer
更新客户
list_credit_balances
列出客户信用余额
list_addresses
列出客户地址
create_address
创建客户地址
get_address
获取客户地址
update_address
更新客户地址
list_businesses
列出客户业务
create_business
创建客户业务
get_business
获取客户业务
update_business
更新客户业务
list_transactions
列出交易
create_transaction
创建交易
get_transaction
获取交易详情
update_transaction
更新交易
preview_transaction_create
预览交易创建
revise_transaction
修订已开票或完成的交易
get_transaction_invoice
获取交易PDF发票
list_adjustments
列出调整
create_adjustment
创建调整
get_adjustment_credit_note
获取调整PDF信用通知
list_subscriptions
列出订阅
get_subscription
获取订阅详情
update_subscription
更新订阅
cancel_subscription
取消订阅
pause_subscription
暂停订阅
resume_subscription
恢复暂停的订阅
activate_subscription
激活试用订阅
preview_subscription_update
预览订阅更新
create_subscription_charge
为订阅创建一次性收费
preview_subscription_charge
预览订阅一次性收费
list_saved_payment_methods
列出客户保存的支付方式
get_saved_payment_method
获取客户保存的支付方式
delete_saved_payment_method
删除客户保存的支付方式
create_customer_portal_session
创建客户门户会话
list_notification_settings
列出通知设置
create_notification_setting
创建通知设置
get_notification_setting
获取通知设置详情
update_notification_setting
更新通知设置
delete_notification_setting
删除通知设置
list_events
列出事件
list_notifications
列出通知
get_notification
获取通知详情
replay_notification
重放通知
list_notification_logs
列出通知日志
list_simulations
列出模拟
create_simulation
创建模拟
get_simulation
获取模拟详情
update_simulation
更新模拟
list_simulation_runs
列出模拟运行
create_simulation_run
创建模拟运行
get_simulation_run
获取模拟运行详情
list_simulation_run_events
列出模拟运行事件
get_simulation_run_event
获取模拟运行事件
replay_simulation_run_event
重放模拟运行事件
list_reports
列出报告
create_report
创建报告
get_report
获取报告详情
get_report_csv
获取报告CSV文件
list_client_side_tokens
列出客户端令牌
create_client_side_token
创建客户端令牌
get_client_side_token
获取客户端令牌详情
revoke_client_side_token
吊销客户端令牌
安装接入
- 获取Paddle API密钥（在Paddle > Developer tools > Authentication中创建，沙盒或生产环境）。
- 在MCP客户端（如Claude Desktop、Cursor、VS Code、Windsurf）的配置文件中添加服务器配置。可以使用命令行参数或环境变量。
- 根据需要设置环境（sandbox或production）和工具过滤（all、read-only、non-destructive或特定工具列表）。
claude_desktop_config.json
{
"mcpServers": {
"paddle": {
"command": "npx",
"args": [
"-y",
"@paddle/paddle-mcp",
"--api-key=your_api_key",
"--environment=sandbox",
"--tools=non-destructive"
]
}
}
}
选型与风险
不适合谁
- 使用Paddle Classic的用户
- 不需要与Paddle API交互的场景
所需权限
- 需要Paddle API密钥
- 根据工具过滤，可进行读取、非破坏性写入或破坏性操作
风险与副作用
- API密钥泄露可能导致数据泄露或未经授权的操作
- 破坏性工具（如更新、取消、暂停订阅）可能造成不可逆的变更
- 请确保在沙盒环境测试后再用于生产
常见排障
- 检查API密钥是否有效
- 确认环境变量或命令行参数正确（如--environment=sandbox）
- 使用MCP Inspector调试请求和响应
使用场景
管理产品目录和定价
处理订阅、支付和退款
调试账单和订单管理
在对话中创建和调整交易
生成财务报告
支持客户端
Claude Desktop完整支持
Cursor完整支持
VS Code完整支持
Windsurf完整支持