managarten/apps/uload/docs/stripe/CLAUDE_CODE_MCP_SETUP.md

Stripe MCP Server für Claude Code einrichten

Übersicht

Claude Code unterstützt MCP Server auf drei Ebenen:

1. Project Scope (.mcp.json) - Für dieses Projekt
2. User Scope (~/.claude.json) - Global für alle Projekte
3. Local Scope - Nur für aktuelle Session

✅ Project Setup (bereits erledigt!)

Die .mcp.json Datei im Projekt wurde bereits konfiguriert:

{
	"mcpServers": {
		"stripe": {
			"command": "npx",
			"args": [
				"-y",
				"@stripe/mcp",
				"--tools=all",
				"--api-key=${STRIPE_SECRET_KEY:-sk_test_REPLACE_WITH_YOUR_KEY}"
			]
		}
	}
}

API Key setzen (2 Optionen):

Option 1: Environment Variable (empfohlen)

export STRIPE_SECRET_KEY=sk_test_YOUR_ACTUAL_KEY

Option 2: Direkt in .mcp.json ersetzen

Ersetze sk_test_REPLACE_WITH_YOUR_KEY mit deinem echten Key.

Global Setup (für alle Projekte)

1. Globale Config erstellen

# Erstelle ~/.claude.json falls nicht vorhanden
touch ~/.claude.json

2. Stripe MCP hinzufügen

Füge folgendes zu ~/.claude.json hinzu:

{
	"mcpServers": {
		"stripe-global": {
			"command": "npx",
			"args": ["-y", "@stripe/mcp", "--tools=all", "--api-key=sk_test_YOUR_GLOBAL_KEY"]
		}
	}
}

3. Claude Code neustarten

Nach Änderungen an MCP Konfigurationen solltest du Claude Code neustarten.

Verfügbare Stripe Tools

Mit dem MCP Server hast du Zugriff auf:

Customers

• customers.create - Kunden erstellen
• customers.read - Kunden abrufen
• customers.update - Kunden aktualisieren
• customers.delete - Kunden löschen
• customers.list - Alle Kunden auflisten

Products & Prices

• products.create - Produkte erstellen
• products.update - Produkte bearbeiten
• prices.create - Preise definieren
• prices.list - Preise auflisten

Subscriptions

• subscriptions.create - Abos erstellen
• subscriptions.update - Abos ändern
• subscriptions.cancel - Abos kündigen
• subscriptions.list - Abos auflisten

Payments

• paymentLinks.create - Payment Links generieren
• checkout.sessions.create - Checkout Sessions erstellen

Invoices

• invoices.read - Rechnungen abrufen
• invoices.list - Rechnungen auflisten

Test-Befehle für Claude Code

Sage mir einfach:

"Verwende den Stripe MCP Server um ein Test-Produkt zu erstellen"

Ich sollte antworten können mit:

✅ Produkt erstellt: prod_xyz123

Für ulo.ad spezifisch

"Verwende den Stripe MCP Server um folgendes für ulo.ad zu erstellen:

1. Produkt 'ulo.ad Pro' mit Beschreibung
2. Monatspreis 9,99€
3. Jahrespreis 99€ (2 Monate gratis)
4. Speichere alle IDs in .env.stripe"

Sicherheitshinweise

Test vs Production Keys

• Test Mode: Keys beginnen mit sk_test_
• Live Mode: Keys beginnen mit sk_live_ oder rk_live_ (restricted)

Restricted Keys erstellen

Für Production solltest du einen Restricted Key verwenden:

1. Stripe Dashboard → API Keys → Restricted Keys
2. Create Restricted Key
3. Nur diese Permissions aktivieren:
   • Customers: Write
   • Products: Write
   • Prices: Write
   • Subscriptions: Write
   • Checkout Sessions: Write

Environment Variables

Nutze Environment Variables statt Keys direkt in Config:

# .env.local
STRIPE_SECRET_KEY=sk_test_xxx

# Dann in .mcp.json
"--api-key=${STRIPE_SECRET_KEY}"

Troubleshooting

"MCP server stripe not found"

→ Claude Code neustarten nach Config-Änderung

"Invalid API key provided"

→ Prüfe ob Key mit sk_test_ oder sk_live_ beginnt

Server startet nicht

Test manuell:

npx -y @stripe/mcp --tools=all --api-key=sk_test_YOUR_KEY

Permissions Error

→ Verwende Restricted Key mit korrekten Permissions

Status Check

Um zu prüfen ob alles funktioniert:

1. In Claude Code: "List alle verfügbaren MCP Server"
2. Stripe Test: "Verwende Stripe MCP um die API zu testen"

Nächste Schritte

1. ✅ Project MCP Config (.mcp.json) - Bereits erledigt!
2. ⏳ Stripe API Key in Environment setzen
3. ⏳ Test mit einem Produkt erstellen
4. ⏳ Alle ulo.ad Produkte automatisch anlegen lassen

Zusammenfassung

• Project Setup: ✅ Fertig in .mcp.json
• Global Setup: Optional in ~/.claude.json
• API Key: Muss noch gesetzt werden
• Tools: Alle Stripe-Funktionen verfügbar

Nach dem Setzen des API Keys kann ich direkt mit der Stripe API arbeiten und alle Produkte, Preise und Konfigurationen für ulo.ad automatisch erstellen!