$ claude mcp add --transport sse paypal https://mcp.paypal.com/sse copy
PayPal이 직접 호스팅하는 공식 원격 MCP 서버와 오픈소스 Agent Toolkit(
paypal/agent-toolkit).
왜 필요한가?
인보이스 발행이나 결제, 환불을 처리하려면 PayPal 대시보드나 API를 직접 다뤄야 했습니다. PayPal MCP를 연결하면 Claude Code에서 인보이스, 주문, 결제, 구독을 대화로 처리할 수 있습니다.
무엇을 할 수 있나
PayPal 공식 문서가 안내하는 대표 작업입니다.
- 인보이스 생성 — “[email protected]에게 $500 인보이스를 만들고 결제 링크를 줘”
- 거래 내역 조회 — “지난달 거래 내역을 보여주고 총 매출을 요약해줘”
- 주문, 결제 — “$99 주문을 만들고 승인되면 결제를 캡처해줘”
- 환불 — “거래 X를 환불하고 환불 상태를 확인해줘”
- 구독 관리 — “월 $20 구독 플랜을 만들고 고객 구독을 생성해줘”
- 분쟁 관리 — “열린 분쟁을 보여주고 분쟁 #123의 클레임을 수용해줘”
근거: developer.paypal.com/community/blog/paypal-model-context-protocol, docs.paypal.ai/developer/tools/ai/mcp-quickstart.
핵심 기능
- 인보이스 — 생성, 목록, 발송, 알림, 취소, QR 코드
- 주문, 결제 — 주문 생성, 조회, 결제 캡처
- 환불 — 환불 생성, 상세 조회
- 구독 — 플랜 생성, 구독 생성, 수정, 취소
- 분쟁, 배송 추적, 카탈로그, 리포팅
연결 방법
원격(SSE):
claude mcp add --transport sse paypal https://mcp.paypal.com/sse
로컬:
claude mcp add paypal --env PAYPAL_ACCESS_TOKEN=YOUR_TOKEN --env PAYPAL_ENVIRONMENT=SANDBOX -- npx -y @paypal/mcp --tools=all
알아두면 좋은 점
- 원격은 PayPal 로그인 기반 OAuth(개발자 대시보드의 Client ID, Secret), 로컬은 액세스 토큰 직접 전달
- 프로덕션(
mcp.paypal.com)과 샌드박스(mcp.sandbox.paypal.com) 엔드포인트가 분리되어 있음 - 라이선스 — Apache-2.0(
paypal/agent-toolkit), 원격 서버는 호스팅 서비스 - 실 자금이 움직이므로 먼저 샌드박스에서 검증을 권장