Rehberler

AI asistanları (MCP)

Claude Code, Cursor ya da Codex'ten tek istekle sat: kendi anahtarınla yerel bir MCP sunucusu üzerinden ürünler, fiyatlar, ödeme bağlantıları ve test ödemeleri.

Markdown olarak aç

perly-pay-mcp, asistanının Perly Pay'i senin yerine kurmasını sağlar: bir ürün ve fiyat oluşturmak, bir ödeme bağlantısı paylaşmak, onu test modunda ödemek ve neyin geldiğini göstermek. Senin bilgisayarında çalışır ve kendi anahtarınla yalnızca Perly Pay API'siyle konuşur. Arada bize ait hiçbir şey yok.

Kurulum

1
Test anahtarını al
Dashboard → Developers → API keys: sk_test_…. Onunla geliştir — gerçek para hareket etmez.
2
Sunucuyu ekle
Claude Code'da tek satır ya da Cursor veya Codex yapılandırmasında birkaç satır. Node 20 ya da daha yenisi gerekir.
3
İste
"Bir saatlik danışmanlığı ödeme bağlantısıyla $49'a sat, sonra test modunda öde ve ödemeyi göster."

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

Anahtarı git'e koyma: projedeki yapılandırma dosyası çoğu zaman commit'lenir.

Değişken	Nedir
`PERLY_PAY_SECRET_KEY`	Geliştirirken `sk_test_…`. `sk_live_…` yalnızca okur (aşağıya bakın).
`PERLY_PAY_API`	Varsayılan `https://pay.perly.io`.
`PERLY_PAY_WEBHOOK_SECRET`	İsteğe bağlı: `verify_webhook_signature` için `whsec_…`.

Araçlar

API'nin kendi tanımından üretilir, bu yüzden her argüman API'nin kabul ettiğidir. Tutarlar sent cinsinden tam sayıdır: 4900, $49.00 demek.

Araçlar	Ne için
`create_product`, `list_products`, `update_product`, `create_price`, `list_prices`, `update_price`	ürünler ve fiyatlar
`create_payment_link`, `list_payment_links`, `update_payment_link`	ödeme bağlantıları
`create_invoice`, `list_invoices`, `retrieve_invoice`, `cancel_invoice`, `create_checkout_session`, `retrieve_checkout_session`	faturalar ve ödeme
`create_customer`, `list_customers`, `retrieve_customer`	müşteriler
`create_subscription`, `list_subscriptions`, `retrieve_subscription`	abonelikler
`check_entitlement`, `list_entitlements`, `consume_entitlement_credits`, `list_credit_usage`	erişim ve krediler
`list_payments`, `retrieve_payment`, `list_receipts`, `retrieve_receipt`, `list_events`	ödemeler, makbuzlar, olaylar
`create_refund`, `list_refunds`	iadeler
`create_webhook_endpoint`, `list_webhook_endpoints`, `delete_webhook_endpoint`	webhook'lar
`simulate_payment`	test modu
`verify_webhook_signature`, `pay_links`	senin bilgisayarında

simulate_payment bir faturayı öder ya da bir ödeme bağlantısıyla satın alıp öder; böylece teslimat, makbuzlar ve webhook'lar gerçek bir alıcıdaki gibi çalışır. pay_links, yalnızca senin yapabileceğin işler için panel sayfalarını verir.

Neyi yapmaz

Canlı anahtarla yalnızca okur. Yazan her araç reddedilir: yeni fatura, ödeme oturumu, ürün, fiyat, müşteri, bağlantı ve abonelik; değişiklik, iptal, iade, kredi harcama ve webhook. Araç nedenini söyler; bunu panelde ya da uygulamanızın kendi kodunda yaparsınız. Neden: bir alıcının yazdığı metin asistana ulaşabilir ve sunucuya gelen hiçbir şey canlı bir değişikliği modelin değil sizin onayladığınızı kanıtlayamaz.
Cüzdanlar, API anahtarları, faturan, canlı moda geçiş ve iki faktörlü giriş için araç yok. Bunları panelde sen yaparsın; pay_links sayfaları verir.
Geri alınamayan işlemler — fatura iptali, iade açma, webhook silme — confirm: true bekler; asistan bunu yalnızca senin onayından sonra gönderir.
Gizli anahtarın asla tekrarlanmaz, ne yanıtta ne de günlükte.

Canlı moda geçiş

1
Cüzdanını bağla
Açık anahtarını ya da adresini, panelde. Seed ifadesini ya da özel anahtarı asla istemeyiz. Bkz. Cüzdanlar.
2
Canlı modu aç
Panelde, cüzdan bağlanır bağlanmaz.
3
Anahtarı değiştir
Uygulamanın sunucusunda sk_test_… yerine sk_live_… koy. Asistanda test anahtarı kalabilir.