Paddle MCP 서버
Paddle MCP 서버
개요
Paddle MCP 서버는 Paddle Billing과 Model Context Protocol (MCP) 간의 통합을 제공하는 공식 서버입니다. Paddle은 개발자를 위한 판매 대행 서비스(merchant of record)로, 결제, 세금, 구독 및 지표를 단일 통합 API로 관리합니다. 이 MCP 서버를 통해 AI 어시스턴트가 Paddle API에 접근하여 상품 카탈로그, 결제 및 구독 관리 등의 기능을 수행할 수 있습니다.
특징
- 상품 카탈로그 관리: Paddle 카탈로그에 있는 상품 목록 조회 및 새 상품 생성
- 가격 관리: 상품 가격 목록 조회 및 새 가격 생성
- 고객 관리: 고객 목록 조회 및 정보 관리
- 트랜잭션 관리: 모든 거래 내역 조회
- 구독 관리: 구독 목록 조회 및 관리
- 재무 분석: 재무 분석을 위한 사용자 지정 보고서 생성
API
리소스
- 상품(Products)
- 가격(Prices)
- 고객(Customers)
- 거래(Transactions)
- 구독(Subscriptions)
- 보고서(Reports)
도구
상품 관리
- list-products: Paddle 카탈로그의 모든 상품을 조회합니다
- 입력: 선택적 필터링 매개변수
- 출력: 상품 목록
- create-product: 새 상품을 생성합니다
- 입력: 상품 정보(이름, 설명, 세부 정보 등)
- 출력: 생성된 상품 정보
가격 관리
- list-prices: 상품의 모든 가격을 조회합니다
- 입력: 상품 ID(선택적)
- 출력: 가격 목록
- create-price: 상품에 새 가격을 생성합니다
- 입력: 상품 ID, 가격 정보(금액, 통화, 청구 주기 등)
- 출력: 생성된 가격 정보
고객 관리
- list-customers: 모든 고객을 조회합니다
- 입력: 선택적 필터링 매개변수
- 출력: 고객 목록
거래 관리
- list-transactions: 모든 거래를 조회합니다
- 입력: 선택적 필터링 매개변수(날짜 범위, 상태 등)
- 출력: 거래 목록
구독 관리
- list-subscriptions: 모든 구독을 조회합니다
- 입력: 선택적 필터링 매개변수(고객 ID, 상태 등)
- 출력: 구독 목록
보고서 관리
- create-report: 재무 분석을 위한 사용자 지정 보고서를 생성합니다
- 입력: 보고서 매개변수(기간, 유형, 집계 방법 등)
- 출력: 생성된 보고서 데이터
사용 방법
사전 요구사항
- Paddle API 키
- Paddle 계정
설치 및 구성
- API 키 준비
-
API 키는 Paddle > Developer tools > Authentication에서 생성하고 관리할 수 있습니다:
- Sandbox: https://sandbox-vendors.paddle.com/authentication-v2
- Live: https://vendors.paddle.com/authentication-v2
-
MCP 클라이언트 설정
- Claude Desktop, Cursor 또는 Windsurf와 같은 클라이언트에서 서버를 실행하려면 MCP 설정에 다음을 추가하세요:
{ "mcpServers": { "paddle": { "command": "npx", "args": [ "-y", "@paddle/paddle-mcp", "--api-key=PADDLE_API_KEY", "--environment=(sandbox|production)" ] } } } PADDLE_API_KEY를 API 키로 대체하고,environment값으로 적절한 환경(sandbox 또는 production)을 지정하세요.
주의사항
- 이 MCP 서버는 Paddle Billing에서 작동합니다.
- Paddle Classic은 지원하지 않습니다. Paddle Classic을 사용하려면 Paddle Classic API 참조를 참조하세요.