Stripe

Overblik

Proxy Stripes hostede MCP-server, så AI-agenter kan arbejde med kunder, betalinger, abonnementer, fakturaer og den bredere Stripe API via stackgate.ai. Værktøjer spejles dynamisk fra https://mcp.stripe.com, herunder meta-værktøjer som stripe_api_read og stripe_api_write.

Dette er adskilt fra stackgate.ai-abonnement (Cashier). Når du forbinder Stripe her, bruges din Stripe-konto — ikke platformens billing-nøgler.

Du kan forbinde flere Stripe-konti (fx én test og én live) under samme integration. AI-klienter bruger altid den standardforbindelse, du vælger under Mine integrationer.

Forudsætninger

• En Stripe-konto med MCP-adgang aktiveret (sandbox og live styres hver for sig)
• En stackgate.ai-konto

Hent legitimationsoplysninger

Mulighed A — OAuth (anbefalet)

1. Åbn Mine integrationer → Stripe i stackgate.ai.
2. Klik Aktivér, derefter Connect Stripe.
3. Angiv et kontonavn og vælg Stripe-miljø (test eller live).
4. Fuldfør Stripes MCP OAuth-samtykkeskærm.
5. For at tilføje en anden konto: brug Connect another Stripe account og gentag.
6. Vælg standardforbindelsen på Stripe-siden — den token bruges til /mcp/stripe og gateway stripe__*-værktøjer.
7. Åbn eventuelt Advanced for at angive et Connect Stripe-Account-id (acct_…) på standardforbindelsen.

Du kan senere tilbagekalde OAuth-sessioner under Stripe brugerindstillinger → OAuth sessions.

Mulighed B — Restricted API-nøgle

1. I Stripe Dashboard → API keys opretter du en Restricted API-nøgle (rk_…) med kun de tilladelser dine agenter behøver.
2. På Stripe-integrationssiden: brug Add Restricted API key, angiv navn, vælg test eller live, og indsæt nøglen.
3. Sæt den forbindelse som standard, hvis MCP-kald skal bruge den.

Foretræk Restricted API-nøgler frem for secret keys (sk_…).

Brug med AI-klienter

• Dedikeret endpoint: POST /mcp/stripe
• Private gateway: stripe__* namespacede værktøjer (spejlet fra upstream)
• Værktøjer kører altid mod standard-Stripe-forbindelsen (ingen connection_id som tool-argument)
• Kør refresh_tools efter forbindelse (eller når Stripe opdaterer værktøjer) for at synkronisere den seneste upstream-værktøjsliste

Upstream-funktioner omfatter API-discovery (stripe_api_search, stripe_api_details), generisk læs/skriv (stripe_api_read, stripe_api_write), ressourcesøgning, dokumentationssøgning, refunds, reports m.m. Se Stripe MCP-dokumentationen.

Fejlfinding

• MCP-adgang nægtet — en administrator skal aktivere MCP under Dashboard → Settings → MCP for den rigtige tilstand (sandbox vs live).
• Tom værktøjsliste — kald refresh_tools efter forbindelse; bekræft at token eller RAK stadig har tilladelser.
• OAuth fejlede / token udløbet — genforbind den Stripe-forbindelse fra Mine integrationer, eller tilføj en Restricted API-nøgle. Dynamic client registration skal bruge scope mcp (ikke mcp:use).
• Forkerte kontodata — bekræft at standardforbindelsen er den konto, du vil bruge (test vs live).
• Rate limits (429) — Stripe håndhæver kontokvoter; prøv igen med backoff eller reducer skrivemængden.
• Forkert Stripe-konto — hub billing-nøgler (STRIPE_KEY / Cashier) bruges ikke her; genforbind den merchant-konto du vil forespørge.
• Connect-platforme — OAuth bruges ikke til connected-account-kald; brug en platform Restricted API-nøgle med Connect-tilladelser, og sæt Advanced → Connected account ID på standardforbindelsen.