prime-agent-stripe-mcp

Offizielle Stripe MCP-Integration für Prime Agent.

Prime Agent verbindet sich mit dem offiziellen Remote-MCP-Server von Stripe unter https://mcp.stripe.com. Der Agent kann dann Stripe-Ressourcen über dieselbe API-Oberfläche wie andere MCP-Clients einsehen und verwalten.

[!NOTE] Der MCP-Server von Stripe befindet sich in der öffentlichen Vorschau. Er stellt sowohl Lese- als auch Schreibwerkzeuge bereit. Belassen Sie die Verbindung während der Entwicklung im Testmodus.

┌─────────────────────────────────┐                      ┌─────────────────────────────────┐
│ │ from stripe import         │  │                      │ │ mcp.stripe.com              │ │
│ │   stripe                   │  │                      │ │ API · billing · reporting   │ │
│ │ await stripe.list_tools()  │──┼   OAuth 2.1 + PKCE   │ │ products · customers        │ │
│ │ await stripe.call_tool(    │  │                      │ │ subscriptions · events      │ │
│ auth.json: mcp:stripe           │                      │ │ documentation search        │ │
└─────────────────────────────────┘                      └─────────────────────────────────┘

Warum diese Integration

• Stripe-gehosteter Server — kein selbst gehosteter Proxy und kein Stripe-API-Schlüssel in diesem Repository.

• Prime-Agent-nativ — das Modul erweitert McpIntegration und stellt das Live-Tool-Inventar aus dem Python-Kernel bereit.

• OAuth 2.1 mit PKCE — die Browser-Freigabe wird ausschließlich in der privaten auth.json von Prime Agent unter mcp:stripe gespeichert.

• Testmodus-freundlich — autorisieren Sie das Liminal-Stripe-Konto und verwenden Sie während der Entwicklung ausschließlich Testmodus-Ressourcen.

Related MCP server: stripe-mcp

Installation

Erfordert Prime Agent mit seinem Python-Kernel und Python 3.10 oder neuer.

1. Klonen Sie das Repository und verlinken Sie das Skill am vorgesehenen Ort:

   git clone https://github.com/gbrlpzz/prime-agent-stripe-mcp.git ~/prime-agent-stripe-mcp
   rm -rf ~/.agents/skills/stripe
   ln -s ~/prime-agent-stripe-mcp ~/.agents/skills/stripe

2. Installieren Sie das Paket im Editable-Modus in die Kernel-Umgebung von Prime Agent:

   uv pip install --python ~/.prime/agent/kernel-venv/bin/python -e ~/prime-agent-stripe-mcp

3. Fügen Sie den Remote-Server einmal zu den MCP-Einstellungen von Prime Agent hinzu:

   {
     "mcpServers": {
       "stripe": {
         "type": "http",
         "url": "https://mcp.stripe.com",
         "oauth": true
       }
     }
   }

4. Laden Sie Prime Agent neu und autorisieren Sie das Stripe-Konto:

   /reload
   /mcp login stripe

Genehmigen Sie das Liminal-Stripe-Konto, nicht ein persönliches oder Produktionskonto, das außerhalb dieses Entwicklungsworkflows bleiben sollte. Prime Agent speichert die Zugangsdaten als mcp:stripe. Sie werden niemals in dieses Repository geschrieben.

Verwendung

from stripe import stripe, auth_status

print(auth_status())               # credential state, no token values
tools = await stripe.list_tools()  # live Stripe MCP inventory
# Inspect the live schema before calling a read or write tool.
result = await stripe.call_tool("<live-tool-name>", {"<live-argument>": "..."})

auth_status() gibt ein kleines Dict ohne Geheimnisse zurück:

{"enabled": True, "expires_fresh": True, "type": "oauth"}

Toolnamen und Parameter gehören zu Stripe und können sich während der öffentlichen Vorschau ändern. Rufen Sie zuerst list_tools() auf, oder verwenden Sie die Methoden, die automatisch aus dem Live-Inventar gebunden werden.

Der Server enthält Tools für die Stripe-API-Discovery, API-Lese- und Schreiboperationen, Kontoinformationen, Billing-Ressourcen, Dokumentation und Reporting. Schreiboperationen verändern Stripe-Daten. Bitten Sie um eine menschliche Bestätigung, bevor Sie etwas erstellen, aktualisieren, stornieren, erstatten oder löschen.

Fallback für die Token-Aktualisierung

Prime Agent aktualisiert das gespeicherte Token automatisch. Auf Hosts, auf denen das nicht verfügbar ist, rufen Sie den Fallback auf Modulebene auf:

from stripe import refresh

refresh()  # exchanges the stored refresh token; rewrites auth.json with mode 600

Liminal-Entwicklungsworkflow

1. Fügen Sie Ihren persönlichen Benutzer als Teammitglied des Liminal-Stripe-Kontos hinzu.

2. Autorisieren Sie diese Integration als dieser Benutzer.

3. Stellen Sie sicher, dass sich das Stripe-Dashboard im Testmodus befindet.

4. Erstellen Sie ausschließlich Testprodukte, Testpreise, Testkunden und Testabonnements.

5. Konfigurieren Sie die Supabase-Funktion stripe-webhook separat mit dem resultierenden Test-Webhook-Signaturgeheimnis. Die MCP-Zugangsdaten ersetzen nicht das serverseitige STRIPE_SECRET_KEY bzw. STRIPE_WEBHOOK_SECRET.

Fehlerbehebung

Entwicklung

python3 tests/test_skill.py                             # standalone suite, no Prime Agent needed
~/.prime/agent/kernel-venv/bin/python -m pytest tests/  # inside Prime Agent's kernel

CI führt die eigenständige Testsuite bei jedem Push auf main aus.

Sicherheit

• In diesem Repository und seiner Git-Historie befinden sich keine Zugangsdaten.

• OAuth-Tokens befinden sich ausschließlich in der privaten auth.json von Prime Agent.

• Das Modul kommuniziert nur mit https://mcp.stripe.com und dem OAuth-Autorisierungsserver von Stripe.

• Führen Sie alle Entwicklungsänderungen ausschließlich im Stripe-Testmodus durch.

• Fügen Sie Stripe-Geheimwerte oder privates Schlüsselmaterial niemals in Quellcode, Tests, Dokumentation oder Git-Historie ein.

Lizenz

MIT — siehe LICENSE. Stripe ist eine Marke von Stripe, Inc.; dies ist eine unabhängige Client-Integration für den offiziellen MCP-Server von Stripe (siehe NOTICE).