PayPal MCP Server의 개요
PayPal은 https://mcp.paypal.com에서 서버를 호스팅하고, https://mcp.sandbox.paypal.com에 샌드박스를 둡니다. 공식 MCP 레지스트리의 PayPal 항목에는 /mcp(Streamable HTTP)와 /sse 경로가 올라 있습니다. 반면 2026년 6월 30일에 마지막으로 갱신된 개발자 문서는 여전히 /http와 /sse를 안내합니다. 이 경로는 mcp-remote를 거쳐 PayPal 로그인이나, 앱의 client ID와 secret으로 만든 bearer 토큰으로 사용합니다.
로컬 버전은 npx -y @paypal/mcp --tools=all(Node 18 이상)로 실행하며, PAYPAL_ACCESS_TOKEN과 SANDBOX 또는 PRODUCTION으로 설정한 PAYPAL_ENVIRONMENT가 필요합니다. 마지막 npm 릴리스는 2025년 10월 28일의 1.8.1이고, 그 뒤로 GitHub 저장소에는 커밋이 없습니다.
30개의 도구는 인보이스(생성, 발송, 독촉, 취소, QR 코드), 주문, 결제와 환불, 분쟁, 배송 추적, 카탈로그 상품, 구독 플랜과 구독, 거래 목록 조회를 다룹니다.
PayPal MCP Server 설치 방법
https://mcp.paypal.com/mcpPayPal MCP Server, 쓸 만한 가치가 있습니까?
서류상으로 이 서버는 PayPal 판매자가 맡기고 싶어 하는 일을 처리합니다. 인보이스를 작성해 보내고, 미결제 건을 독촉하고, 주문을 조회하고, 환불을 실행하고, 분쟁을 검토합니다. 샌드박스 엔드포인트가 있다는 점은 반갑습니다. 실제 돈을 건드리기 전에 프롬프트를 시험해 볼 수 있습니다.
실제로는 방치된 프로젝트처럼 보입니다. 오픈소스 패키지는 2025년 10월의 1.8.1 버전 이후 바뀌지 않았고, 저장소의 스타는 13개입니다. 2026년 7월에 올라온 열린 issue는 호스팅형 서버의 OAuth 인증 엔드포인트가 프로덕션과 샌드박스 모두에서 모든 요청에 HTTP 500을 돌려준다고 보고합니다. 또 다른 열린 issue에 따르면 create_invoice는 자체적으로 공개한 스키마에 맞춰 만든 인수도 거부합니다. 레지스트리와 문서는 엔드포인트 경로에서 서로 다릅니다. 10월 26일에 문서에 나온 /http 경로로 단순 요청을 보내자 404가 돌아왔고, /mcp는 인증 요구로 응답했습니다. 따라서 설정할 경로는 레지스트리 쪽입니다.
로컬 방식은 토큰이 있으면 여전히 작동하지만 번거롭습니다. 프로덕션 액세스 토큰은 8시간 동안 유효하므로, 누군가 client ID와 secret으로 PAYPAL_ACCESS_TOKEN을 다시 발급해야 합니다. 토큰에는 REST 앱이 가진 권한이 그대로 담깁니다. --tools 플래그 말고는 읽기 전용 모드나 도구 필터가 없습니다.
돈을 움직이는 서버치고 안전장치가 부족합니다. 사람의 승인 단계가 없습니다. create_refund, pay_order, accept_dispute_claim은 즉시 실행되며, 분쟁을 수락하면 그 분쟁에서 지는 것입니다. 클라이언트에서 도구별 승인을 켜 두십시오. 호출 한 번으로 분쟁과 그 $15 수수료를 내줄 수 있는 서버라면, 이 공백은 도구 개수보다 더 중요합니다.
제 역할을 하는 곳
PayPal로 인보이스를 보내는 2인 조경 업체
PayPal 대시보드 대신 채팅에서 인보이스를 만들어 보내기
에이전트에게 특정 고객과 금액으로 인보이스 초안을 작성하게 하고, 검토한 뒤 보냅니다. 서버는 무료입니다. 결제된 인보이스마다 PayPal checkout 결제는 표준 3.49%와 고정 수수료, 카드는 2.99%와 고정 수수료가 듭니다.
소규모 온라인 쇼핑몰의 개발자
샌드박스에서 주문과 환불을 대조하는 에이전트의 시제품 만들기
수명이 짧은 토큰으로 SANDBOX를 대상으로 npx @paypal/mcp를 실행하고 list_transactions, get_order, create_refund를 시험합니다. 프로덕션으로 옮기기 전에 몇 시간마다 토큰을 갱신하는 방법과 호출별 승인을 준비해 두십시오.
구독 박스 회사의 운영 관리자
매일 아침 열린 분쟁 검토하기
list_disputes와 get_dispute로 분류에 쓸 요약을 받습니다. accept_dispute_claim은 수동 승인 뒤에 두십시오. 수락하면 그 건에서 지는 것이기 때문입니다. 표준 요금에서 미국의 분쟁 수수료는 건당 $15입니다.
도입 전 확인할 점
- 설정
- 호스팅형: mcp-remote를 샌드박스 또는 프로덕션 엔드포인트로 지정하고 브라 우저에서 PayPal에 로그인하거나 bearer 토큰을 넘깁니다. 로컬형: Developer Dashboard에서 받은 액세스 토큰으로 npx -y @paypal/mcp --tools=all을 실행합니다. Claude Desktop, Cursor, Cline, GitHub Copilot용 설정이 문서화되어 있습니다.
- 연동
- 30개의 도구: 인보이스 7개, 주문과 결제와 환불 5개, 분쟁 3개, 배송 추적 2개, 카탈로그 상품 4개, 구독과 플랜 8개, 그리고 list_transactions입니다. 쓰기 도구는 대부분 즉시 실행됩니다.
- 데이터와 개인정보
- 서버는 PayPal REST 앱이나 로그인한 계정이 할 수 있는 일은 환불과 결제를 포함해 무엇이든 할 수 있습니다. 호스팅형 서버는 모든 요청을 봅니다. PayPal은 MCP 전용 보관 조건을 공개하지 않으며, 저장소에는 보안 정책이 없습니다. 이를 요청하는 열린 issue가 있습니다.
- 대규모 사용 시 비용
- 서버 이용료는 없습니다. 서버가 만드는 거래에는 표준 PayPal 수수료가 붙습니다. 미국 인보이스 기준으로 PayPal checkout은 3.49%와 고정 수수료, 카드는 2.99%, 분쟁은 건당 $15입니다. PayPal은 API 요청 한도를 공개하지 않으며, 남용으로 판단한 트래픽은 HTTP 429로 제한합니다.
- 제한
- list_transactions 외에는 보고 기능이 없고, 지급(payout)이나 잔액 도구도 없습니다. 호스팅형 OAuth는 실패한다는 보고가 있고, 프 로덕션 토큰은 8시간 후에 만료됩니다.
좋은 점
- 안전하게 시험할 수 있는 샌드박스 엔드포인트
- 인보이스, 환불, 분쟁, 구독에 걸친 30개의 도구
- 호스팅형과 로컬형 선택지
아쉬운 점
- 2025년 10월 이후 npm 릴리스와 커밋이 없습니다
- 호스팅형 OAuth가 2026년 7월부터 고장 났다는 보고가 있습니다
- 환불, 결제, 분쟁 수락에 승인 단계가 없습니다
- 로컬 토큰은 8시간 후에 만료됩니다
추천 대상
어시스턴트에게 인보이스 관리와 거래 조회를 맡기고 싶은 PayPal 판매자.
PayPal MCP Server 대안
PayPal MCP Server: 자주 묻는 질문
- PayPal MCP Server, 쓸 만한 가치가 있습니까?
- PayPal의 자체 서버는 판매자에게 필요한 작업을 제대로 짚고 있습니다. 다만 로컬 패키지는 1년째 멈춰 있고, 7월에 올라온 열린 issue는 호스팅형 로그인이 실패한다고 보고합니다. 평점은 5점 만점에 3.4점입니다.
- PayPal MCP Server의 가격은 얼마입니까?
- 연결은 무료입니다. 일반적인 PayPal 수수료가 적용됩니다.
- PayPal MCP Server의 단점은 무엇입니까?
- 2025년 10월 이후 npm 릴리스와 커밋이 없습니다; 호스팅형 OAuth가 2026년 7월부터 고장 났다는 보고가 있습니다; 환불, 결제, 분쟁 수락에 승인 단계가 없습니다; 로컬 토큰은 8시간 후에 만료됩니다.
- PayPal MCP Server에 적합한 사람은 누구입니까?
- 어시스턴트에게 인보이스 관리와 거래 조회를 맡기고 싶은 PayPal 판매자.
- 팀이나 프로덕션 환경에서 PayPal MCP Server의 비용은 얼마입니까?
- 서버 이용료는 없습니다. 서버가 만드는 거래에는 표준 PayPal 수수료가 붙습니다. 미국 인보이스 기준으로 PayPal checkout은 3.49%와 고정 수수료, 카드는 2.99%, 분쟁은 건당 $15입니다. PayPal은 API 요청 한도를 공개하지 않으며, 남용으로 판단한 트래픽은 HTTP 429로 제한합니다.
- PayPal MCP Server에 회사 데이터를 맡겨도 안전합니까?
- 서버는 PayPal REST 앱이나 로그인한 계정이 할 수 있는 일은 환불과 결제를 포함해 무엇이든 할 수 있습니다. 호스팅형 서버는 모든 요청을 봅니다. PayPal은 MCP 전용 보관 조건을 공개하지 않으며, 저장소에는 보안 정책이 없습니다. 이를 요청하는 열린 issue가 있습니다.
- PayPal MCP Server의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 Stripe MCP 및 Square MCP Server입니다.
답변 확인일: 2026년 10월 26일.