Anleitungen

AI-Assistenten (MCP)

Verkaufen Sie aus Claude Code, Cursor oder Codex mit einer Bitte: Produkte, Preise, Zahlungslinks und Testzahlungen über einen lokalen MCP-Server mit Ihrem eigenen Schlüssel.

Als Markdown ansehen

perly-pay-mcp lässt Ihren Assistenten Perly Pay für Sie einrichten: ein Produkt und einen Preis anlegen, einen Zahlungslink teilen, ihn im Testmodus bezahlen und zeigen, was angekommen ist. Er läuft auf Ihrem Rechner und spricht nur mit der API von Perly Pay, mit Ihrem Schlüssel. Nichts von uns sitzt dazwischen.

Einrichten

1
Testschlüssel holen
Dashboard → Developers → API keys: sk_test_…. Bauen Sie damit – echtes Geld bewegt sich nicht.
2
Server hinzufügen
Eine Zeile in Claude Code oder ein paar in der Konfiguration von Cursor oder Codex. Node 20 oder neuer nötig.
3
Bitten
„Verkaufe eine einstündige Beratung für $49 über einen Zahlungslink, bezahle sie dann im Testmodus und zeig mir die Zahlung.“

claude mcp add perly-pay --env PERLY_PAY_SECRET_KEY=sk_test_… -- npx -y perly-pay-mcp

Legen Sie den Schlüssel nicht in git: Eine Konfigurationsdatei im Projekt wird oft committet.

Variable	Was es ist
`PERLY_PAY_SECRET_KEY`	`sk_test_…`, solange Sie bauen. `sk_live_…` liest nur (siehe unten).
`PERLY_PAY_API`	Standard: `https://pay.perly.io`.
`PERLY_PAY_WEBHOOK_SECRET`	Optional: `whsec_…` für `verify_webhook_signature`.

Tools

Erzeugt aus der Beschreibung der API selbst, daher ist jedes Argument eines, das die API annimmt. Beträge sind ganze Zahlen in Cent: 4900 sind $49.00.

Tools	Wofür
`create_product`, `list_products`, `update_product`, `create_price`, `list_prices`, `update_price`	Produkte und Preise
`create_payment_link`, `list_payment_links`, `update_payment_link`	Zahlungslinks
`create_invoice`, `list_invoices`, `retrieve_invoice`, `cancel_invoice`, `create_checkout_session`, `retrieve_checkout_session`	Rechnungen und Checkout
`create_customer`, `list_customers`, `retrieve_customer`	Kunden
`create_subscription`, `list_subscriptions`, `retrieve_subscription`	Abos
`check_entitlement`, `list_entitlements`, `consume_entitlement_credits`, `list_credit_usage`	Zugang und Credits
`list_payments`, `retrieve_payment`, `list_receipts`, `retrieve_receipt`, `list_events`	Zahlungen, Belege, Ereignisse
`create_refund`, `list_refunds`	Erstattungen
`create_webhook_endpoint`, `list_webhook_endpoints`, `delete_webhook_endpoint`	Webhooks
`simulate_payment`	Testmodus
`verify_webhook_signature`, `pay_links`	auf Ihrem Rechner

simulate_payment bezahlt eine Rechnung oder kauft über einen Zahlungslink und bezahlt ihn, sodass Erfüllung, Belege und Webhooks auslösen wie bei einem echten Käufer. pay_links liefert die Dashboard-Seiten für das, was nur Sie tun können.

Was er nicht tut

Mit einem Live-Schlüssel nur lesen. Jedes Tool, das schreibt, wird abgelehnt: neue Rechnungen, Checkout-Sitzungen, Produkte, Preise, Kunden, Links und Abos, Änderungen, Stornos, Erstattungen, Verbrauch von Credits und Webhooks. Das Tool sagt, warum; Sie erledigen es im Dashboard oder im Code Ihrer App. Warum: Text, den ein Käufer tippt, kann den Assistenten erreichen, und nichts, was beim Server ankommt, beweist, dass Sie und nicht das Modell eine Live-Änderung freigegeben haben.
Wallets, API-Schlüssel, Abrechnung, Wechsel in den Live-Modus und Zwei-Faktor-Anmeldung haben keine Tools. Das erledigen Sie im Dashboard; pay_links liefert die Seiten.
Was sich nicht rückgängig machen lässt – eine Rechnung stornieren, eine Erstattung eröffnen, einen Webhook löschen – wartet auf confirm: true, das der Assistent erst nach Ihrem Ja sendet.
Ihr geheimer Schlüssel wird nie wiederholt, weder in einer Antwort noch in einem Log.

Live gehen

1
Wallet verbinden
Ihr öffentlicher Schlüssel oder ihre Adresse, im Dashboard. Wir fragen nie nach einer Seed-Phrase oder einem privaten Schlüssel. Siehe Wallets.
2
Live-Modus einschalten
Im Dashboard, sobald eine Wallet verbunden ist.
3
Schlüssel tauschen
Setzen Sie auf dem Server Ihrer App sk_live_… statt sk_test_…. Der Assistent kann den Testschlüssel behalten.