💳 stripe-mcp

Stripe Gateway、SaaS請求運用、オーストリア/EU税務コンプライアンスエンジン

stripe-mcp は、自律型AIエージェント（Claude Desktop、Antigravity IDE、OpenManus）と人間のオペレーターを、Stripeの支払処理、カスタマーサポート業務、サブスクリプション管理、および**オーストリア/EU域の税務コンプライアンス（VAT 20%/10%/13%、EU ATUリバースチャージ、BAO §132の税務記録保管義務）**につなぐために設計されたFastMCP 3.4+サーバー兼SOTA React Webアプリダッシュボードです。

⚡ クイックスタート

# 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 にアクセスすると、Webアプリのダッシュボードを操作できます。

Related MCP server: Stripe MCP Server

✨ 主な機能

• 💳 顧客・チャージ操作: 顧客の作成、メタデータの更新、チャージの取得、支払い紛争の追跡。

• 🔁 サブスクリプション管理: アクティブな加入者の追跡、一時停止、再開、解約、MRR・チャーンKPIのモニタリング。

• 🛍️ 3DS2チャックアウト生成機能: カード、EPSオンラインバンキング、SEPAダイレクトデビットに対応したStripeのPayment LinksとCheckout Sessionsを生成します。

• 🛡️ 財務安全上限: 不正なエージェントによる返金超過を防ぐ厳格な上限（MAX_REFUND_AMOUNT_EUR = €500.00）を設定。

• 🇦🇹 オーストリアおよびEUの税務コンプライアンス:

  • 標準VAT 20%、軽減税率10% / 13%（UStG 1994）を自動適用。

  • 0%リバースチャージ（ATU\d{8}）のVIES/EU VAT IDの構文検証。

  • BAO §132 に基づく7年間の税務請求書アーカブロックのメタデータ。

• 🖥️ SOTA React Webappダッシュボード（ポート11166）: ダッシュボード、顧客ディレクトリ、サブスクリプションマネージャー、返金スタジオ、請求書スタジオ、Webhook受信箱、ツールワークリーナ、スキル、LLMチャット、設定、ヘルプ、監査ログを備えたらすべてを捕捉するUI。

• ⚡ 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        |
                                        +-------------------------------+

🇦🇹 オーストリア/EUコンプライアンス&オンボーディングルール

1. 二人体制の本人確認ルール（代表者とUBO）: EUの第4次AML指令とオーストリアのKYC規制に基づき、Stripeでは、アカウントの代表人と、25%超の持分を保有する、または共同管理者・共同取締役であるすべての実質的所有者（UBO）の両方の確認が必須です。一般的な法人構成（共同創業者2人のGmbHなど）でも、両者とも身分証証明書と住所証明書を提出する必要があります。

2. 住所確認（Meldezettel / Meldebestätigung）: 発行日が3〜6か月以内の最新のものでなければなりません。写真付き身分証明書（パスポート）と住所証（Meldezettel）は別々の書類である必要があります。

3. オーストリアの增值税法（UStG 1994）: 標準税率20%、軽減税率10%/13%、リバースチャージによる0%のゼロ税率。

4. BAO § 132: 7年間の法定請求書の保存ロックが義務付けられています。

🗺️ サブドキュメントマップ

📄 ライセンス

MITライセンスの下で提供されています。詳細はLICENSEをご覧ください。

💳 stripe-mcp

Stripe Gateway、SaaS請求請求、オーストリア/EU税務コンプライアンスエンジン

stripe-mcp は、自律型AIエージェント（Claude Desktop、Antigravity IDE、OpenManus）と人間のオペレーターを、Stripeの支払処理、カスタマーサポート業務、サブスクリプション管理、**オーストリア/EUの税務コンプライアンス（VAT 20%/10%/13%、EU ATUリバースチャージ、BAO § 132の税務記録保存義務）**へつなぐために設計されたFastMCP 3.4+サーバーおよびSOTA React Webappダッシュボードです。

⚡ クイックスタート

# 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**にアクセスすると、Webアプリのダッシュボードを操作できます。

✨ 主な機能

• 💳 顧客・チャージ操作: 顧客の作成、メタデータの更新、チャージの取得、支払い紛争の追跡。

• 🔁 サブスクリプション管理: アクティブな加入者の追跡、一時停止、再開、解約、MRRとチャーンKPIの監視。

• 🛍️ 3DS2 Checkout生成機能: カード、EPSオンラインバンキング、SEPAダイレクトデビットに対応したStripe Payment Links＆Checkout Sessionを生成します。

• 🛡️ 財務安全上限: MAX_REFUND_AMOUNT_EUR = €500.00という厳格な上限値が、許可されていないエージェントの返金超過を防止します。

• 🇦🇹 オーストリア・EU税務コンプライアンス:

  • 自動的に20%標準VAT、10% / 13%軽減税率（UStG 1994）を適用。

  • VIES/EU VAT IDの構文検証による0%リバースチャージ（ATU\d{8}）対応。

  • BAO § 132に基づく7年間の税務請求書アーカブロック・メタデータ。

• 🖥️ SOTA React Webappダッシュボード（ポート11166）: ダッシュボード、顧客ディレクトリ、サブスクリプションマネージャー、返金スタジオ、請求書スタジオ、Webhook受信箱、ツールワークベンチ、スキル、LLMチャット、設定、ヘルプ、監査ログを備えたユニバーサルなUI。

• ⚡ Mock-until-Onboarded: StripeのRestricted API Key（rk_test_...）が接続されるまで、合成オーストリアデータをそのまま利用できます。

🏗️ アーキテクチャ

G2XP

🇦🇹 オーストリア・EUにおけるコンプライアンスとオンボーディング規則

1. 二人体制の本人確認ルール（代表者とUBO）: EU第5次アンチマネーロンリング指令とオーストリアのKYC規則に基づき、Stripeはアカウント代表者と、超過25%超の株式**または共用務取締役（co-managing director）であるすべてのUBO（実質的受益者）の両方の確認を要求しています。代表的な法人構成（共同創業者2人のGmb etc.）の場合、両者の本人確認書類と住所証明書の提出が必要です。

2. 住所証明書（Meldezettel / Meldebestätigung) 最新のものであり、3か月から6か月以内の日付である必要があります。写真付き身分証証明書（パスポート）と住所証明書（Meldezettel）は、別々の書類でなければなりません。

3. オーストリアの消費税法（UStG 1994）: 標準税率20%、軽減税率10% /19%、リバースチャージ0%のゼロ税率。

4. BAO § 132: 法律で義務付けられた7年間の請求書保存ロック。

🗺️ サブドキュメントマップ

📄 ライセンス

MITライセンスの下で提供されています。詳細はLICENSEをご覧ください。