stripe-mcp는 자율 AI 에이전트(Claude Desktop, Antigravity IDE, OpenManus)와 실제 운영자를 Stripe 결제 처리, 고객 지원 운영, 구독 관리 및 **오스트리아/EU 지역 세무 규정 준수(VAT 20%/10%/13%, EU ATU 역과세(Reverse Charge), BAO § 132 회계 기록 보존)**와 연결하도록 설계된 FastMCP 3.4+ 서버이자 최신(SOTA) React 웹 앱 대시보드입니다.
# Navigate to repository
cd D:\Dev\repos\stripe-mcp
# Install dependencies via uv
uv sync
# Launch Backend (Port 11165) & React Webapp (Port 11166)
.\start.ps1실행 후 http://127.0.0.1:11166 을 열어 웹앱 대시보드와 상호작용하십시오.
Related MCP server: Stripe MCP Server
💳 고객 및 결제 작업: 고객 생성, 메타데이터 업데이트, 결제 내역 조회, 분쟁 추적을 지원합니다.
🔁 구독 관리: 활성 구독자 추적, 일시정지, 재개, 취소, 그리고 MRR·이탈(churn) KPI 모니터링을 지원합니다.
🛍️ 3DS2 체크아웃 생성기: 카드, EPS 온라인 뱅킹, SEPA 직접 결제를 지원하는 Stripe Payment Links 및 Checkout Sessions를 생성합니다.
🛡️ 금융 안전 상한: 허가되지 않은 에이전트의 초과 환불 행위를 차단하는 엄격한 하드 리밋(MAX_REFUND_AMOUNT_EUR = €500.00)을 적용합니다.
🇦🇹 오스트리아 및 EU 세무 규정 준수:
20% 표준 VAT, 10%/13% 감면세율 자동 적용(UStG 1994).
0% 역과세 대상에 대한 VIES/EU VAT ID 문법 검증(ATU\d{8}).
BAO § 132 에 따른 7년 회계 기록 보관 락(잠금).
🖥️ SOTA React 웹앱 대시보드(Port 11166): 대시보드, 고객 디렉터리, 구독 관리자, Refund Studio, 초대장 스튜디오, Webhook 인박스, 도구 워크벤치, Skills, LLM 채팅, 설정, 도움말, 감사 로그를 모두 갖춘 통합(all-in-one) UI입니다.
⚡ 온보딩 전까지 Mock 동작(Mock-until-Onboarded): Stripe 제한 API 키(rk_test_...) 연동 전까지 합성 오스트리아 데이터로 바로 동작합니다.
+-----------------------------------------------------------------------+
| AI AGENT HOST |
| (Claude Desktop / Antigravity IDE / OpenManus / Cursor) |
+-----------------------------------------------------------------------+
|
(FastMCP stdio / HTTP /mcp)
v
+-----------------------------------------------------------------------+
| stripe-mcp FastMCP 3.4+ SERVER |
| (Port 11165 REST/MCP) |
| |
| +------------------------+ +-------------------------------------+ |
| | austria_tax.py Engine | | Portmanteau Tools | |
| | - 20%/10%/13% VAT | | - manage_stripe_customers | |
| | - ATU Syntax Checker | | - manage_stripe_subscriptions | |
| | - Reverse Charge | | - manage_stripe_payments | |
| | - BAO § 132 Metadata | | - manage_stripe_checkout | |
| +------------------------+ +-------------------------------------+ |
+-----------------------------------------------------------------------+
| |
(Stripe REST API) (SSE & REST /api)
v v
+-----------------------+ +-------------------------------+
| Stripe Cloud Platform| | React + Vite Webapp Dashboard |
| - API Gateway | | (Port 11166) |
| - Webhooks Ingest | | - Hero & KPIs (MRR/VAT) |
| - EPS / SEPA / PSD2 | | - Mock-until-onboarded |
+-----------------------+ | - Catch-them-all Pages |
+-------------------------------+2인 검증 규칙(대표자 및 실적자): EU 제5차 자금세탁방지 지침 및 오스트리아 KYC 규정에 따라 Stripe는 계좌 대표자 그리고 >25% 의결권/지분 또는 공동 관리직을 보유한 모든 최종 실소유자(한계 소유자)를 모두 확인해야 합니다. 표준 기업 구조(예: 공동 창업자가 있는 LLC 등)의 경우, 두 사람 모두 신분증과 주소지를 제출해야 합니다.
주소 증명서(Meldezettel / Meldebestätigung): 3~6개월 이내 신발부의 서류여만 합니다. 신분증(여권)과 주소 증명은 별도 문서로 제출해야 합니다.
오스트리아 세법(UStG 1994): 20% 표준, 10%/13% 감면, 0% 역과세.
BAO § 132: 의무적으로 7년간 장부·인보이스 보존 잠금을 적용합니다.
영역 | 문서 링크 | 설명 |
🖥️ 웹앱 대시보드 | React 18, Vite, TailwindCSS 대시보드 안내 및 설정. | |
🐍 Python 백엔드 | 핵심 FastMCP 서버, 툴, 세무 엔진 참조. | |
📚 마스터 문서 스택 | 온보딩, 구성, 툴, 문제 해결 가이드 색인. | |
📖 시스템 및 도움말 설명서 | 전체 Stripe 시스템 설명서, 작업장 통합 맵, KYC 규칙. | |
🚀 온보딩 런북 | 단계별 계정 등록 및 주소 확인 verfahren 가이드. | |
⚙️ 구성(configuration) | 환경 변수 및 금융 상한액 설정. | |
🛠️ 툴 참조 | 모든 툴의 파라미터 스키마 및 반환 타입 완전 참조. | |
📝 MCPB 프롬프트 | MCPB 3-4-100 프롬프트 평가 및 검증. | |
🧪 테스트 스위트 | Pytest 테스트 스위트 및 규정 준수 검증. | |
🔧 스크립트 | 유지보수 및 MCPB 패키징 스크립트. |
MIT 라이선스에 따라 배포됩니다. 자세한 사항은 LICENSE 를 참조하세요.
This server cannot be deployed
Stripe payments for AI agents. Create links, verify, manage customers.
Luxembourg payments for AI agents — cards / Apple Pay via Stripe. Never holds funds.
Austria payments for AI agents — EPS via Stripe. Never holds funds.
Estonia payments for AI agents — cards / Apple Pay via Stripe. Never holds funds.