mirror of
https://github.com/Memo-2023/mana-monorepo.git
synced 2026-05-24 03:16:44 +02:00
refactor: restructure
monorepo with apps/ and services/ directories
This commit is contained in:
Wuesteon
parent
25824ed0ac
commit
ff80aeec1f
4062 changed files with 2592 additions and 1278 deletions
|
|
@ -1,207 +0,0 @@
|
|||
# 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:
|
||||
|
||||
```json
|
||||
{
|
||||
"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)
|
||||
|
||||
```bash
|
||||
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
|
||||
|
||||
```bash
|
||||
# Erstelle ~/.claude.json falls nicht vorhanden
|
||||
touch ~/.claude.json
|
||||
```
|
||||
|
||||
### 2. Stripe MCP hinzufügen
|
||||
|
||||
Füge folgendes zu `~/.claude.json` hinzu:
|
||||
|
||||
```json
|
||||
{
|
||||
"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:
|
||||
|
||||
```markdown
|
||||
"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
|
||||
|
||||
```markdown
|
||||
"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:
|
||||
|
||||
```bash
|
||||
# .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:
|
||||
|
||||
```bash
|
||||
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!
|
||||
Loading…
Add table
Add a link
Reference in a new issue