💳 stripe-mcp

Платёжный шлюз Stripe, операции SaaS-биллинга и движок налогового комплаенса Австрии/ЕС

stripe-mcp — это сервер FastMCP 3.4+ и веб-дашборд на React уровня SOTA, предназначенные для подключения автономных ИИ-агентов (Claude Desktop, Antigravity IDE, OpenManus) и живых операторов к обработке платежей Stripe, операциям поддержки клиентов, управлению подписками и австрийскому/европейскому налоговому комплаенсу (НДС 20%/10%/13%, Reverse Charge EU ATU и хранение фискальных записей по BAO § 132).

⚡ Быстрый старт

# 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).

• 🛍️ Генератор Checkout 3DS2: создание Stripe Payment Links и Checkout-сессий с поддержкой карт, интернет-банкинга EPS и прямых дебетов SEPA.

• 🛡️ Финансовые предохранительные лимиты: жёсткий предел (MAX_REFUND_AMOUNT_EUR = €500.00), блокирующий несанкционированные перерасходы возвратов агентами.

• 🇦🇹 Налоговый комплаенс Австрии и ЕС:

  • Автоматический стандартный НДС 20%, пониженные ставки 10%/13% (UStG 1994).

  • Проверка синтаксиса VIES/EU VAT ID для нулевой ставки 0% при Reverse Charge (ATU\d{8}).

  • BAO § 132 — метаданные об обязательном блокировании архива фискальных счетов на 7 лет.

• 🖥️ Веб-дашборд на React уровня SOTA (порт 11166): универсальный интерфейс «всё в одном»: Dashboard, каталог клиентов, менеджер подписок, студия возвратов, студия счетов, входящие вебхуки, рабочее место инструментов, навыки, LLM-чат, настройки, справка и журналы аудита.

• ⚡ Mock-until-Onboarded: работает из коробки с синтетическими австрийскими данными до подключения вашего Stripe Restricted API Key (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        |
                                        +-------------------------------+

🇦🇹 Комплаенс Австрии и ЕС и правила подключения

1. Правило проверки двух лиц (представитель и UBO): согласно 5-й директиве ЕС об отмывании денег и австрийским требованиям KYC, Stripe требует проверки и представителя аккаунта, и всех конечных бенефициарных владельцев (UBO), владеющих долей более 25% или являющихся соуправляющими директорами. Для стандартных корпоративных структур (например, GmbH с двумя сооснователями) оба лица должны предоставить подтверждение личности и адреса.

2. Подтверждение адреса (Meldezettel / Meldebestätigung): документ должен быть актуальным (выданным за 3–6 месяцев до подачи). Фотоудостоверение (загранпаспорт) и подтверждение адреса (Meldezettel) должны быть отдельными документами.

3. Австрийский налоговый закон (UStG 1994): стандартная ставка 20%, пониженные 10%/13%, и 0% Reverse Charge (нулевая ставка).

4. BAO § 132: обязательное блокирование архива фискальных счетов на срок 7 лет.

🗺️ Карта поддокументации

📄 Лицензия

Распространяется под лицензией MIT. Подробнее см. LICENSE.