Stripe MCP nedir? Nasıl bağlanır, iade ve iptal yapar mı, API anahtarı geçişi

Asistanına müşterilerini, ödemelerini, faturalarını ya da aboneliklerini sorarsın; Stripe MCP Stripe hesabındaki veriyi okur, izin verirsen Stripe API'si üzerinden iade oluşturma, abonelik iptali, fatura oluşturma ve sonlandırma gibi yazma işlemleri de yapar. Stripe'ın barındırdığı resmî uzak MCP sunucusu (adres https://mcp.stripe.com); Stripe iade ve giden ödeme gibi bazı işlemlerde insan onayı ister. Kimlik doğrulama OAuth ya da "Agent" rozetli ajan API anahtarıyla yapılır; Stripe, 30 Kasım 2026'ya kadar anahtar geçişi yapılmasını istiyor. Test için sandbox seçilebilir. MCP için ayrı bir ücret belgede yok.

Ne yapar: Asistana Stripe verini okutur, izin verirsen işlem yaptırır
Tür: Bağlayıcı (Stripe'ın barındırdığı uzak MCP)
Yapımcı: Stripe
Kimlik: OAuth veya ajan API anahtarı
Test: Sandbox ayrı seçilebilir
Yazma: İade, abonelik iptali: gerçek para hareketi
Ücret: MCP için ayrı ücret belgede yok

Stripe MCP ne işe yarar?

MCP, yapay zekâ programlarının dış araçlara bağlanma standardıdır. Stripe MCP iki grup araç sunar: Stripe API'siyle konuşanlar ve Stripe belgelerini ile destek makalelerini arayanlar. stripe_api_read herhangi bir Stripe API GET yöntemini çağırır (müşteriler, ödeme niyetleri, faturalar, abonelikler, bakiye, ihtilaflar); stripe_api_write ise POST, PATCH, PUT ve DELETE yöntemlerini çağırır.

SenÖdemeyi ya da aboneliği sorarsın

AsistanMCP destekleyen asistan

Stripe MCPmcp.stripe.com, Stripe barındırır

Stripe hesabınMüşteri, ödeme, fatura, abonelik, bakiye

İade ve abonelik iptali gerçek para hareketidir; test için sandbox seçilebilir.

Stripe verisini asistana sormakNe alırsın: Hesap verisi, listelerBağlantı gerekir Stripe'ta asistanla işlem yapmakNe alırsın: Gerçek işlemBağlantı gerekir

Araç sayısı iki kaynakta farklı: Claude dizini 11 araç listeliyor, Stripe'ın kendi belgesi 15 araç sayıyor (Treasury, Atlas ve get_stripe_account_info dahil). Adlar da farklı; hangi istemcide hangi kümenin göründüğü belgelenmemiş.

Kime yarar: Stripe verisini panelde gezmek yerine asistana sormak, fatura ve ödeme bağlantısı hazırlatmak isteyen işletmelere ve geliştiricilere.

Stripe MCP nasıl bağlanır?

İki kimlik doğrulama yolu var: OAuth (kendi Stripe kullanıcı hesabın adına) ve ajan API anahtarı. Komutlar Stripe belgesinden aynen alındı.

Stripe belgesinin "Connect to Claude" düğmesiyle resmî Stripe bağlayıcısını ekle.
Açılan OAuth penceresinde Stripe hesabına giriş yap; canlı hesap ve sandbox ayrı seçilir, her ortam için farklı izin verebilirsin.
Sohbette + › Connectors altından Stripe'ı aç.
Team ve Enterprise'da önce bir Owner bağlayıcıyı çalışma alanına eklemeli.

Ekle› claude mcp add --transport http stripe https://mcp.stripe.com/

Sonra Claude Code içinde /mcp yazıp Stripe'a OAuth ile giriş yap. Ajan API anahtarıyla bağlanacaksan anahtarı komut satırına değil ortam değişkenine koy ve Authorization: Bearer başlığıyla kullan.

Stripe CLI› stripe agent setup

Stripe'ın "Recommended" gösterdiği yol: komut kullandığın ajanları algılayıp Stripe eklentisini kurar (önce npm install -g @stripe/cli@latest).

Codex› codex mcp add stripe --url https://mcp.stripe.com

Cursor için ~/.cursor/mcp.json, VS Code için .vscode/mcp.json dosyasına https://mcp.stripe.com adresi eklenir (belgede kurulum düğmeleri de var).

Stripe: "30 Kasım 2026'ya kadar API anahtarı kimlik doğrulamasını güncelle". Aralık'tan itibaren Stripe MCP tam erişimli gizli anahtarları ve "Agent" etiketsiz kısıtlı anahtarları kabul etmeyecek, 401 dönecek. Anahtarla bağlanıyorsan yeni bir ajan API anahtarı oluştur ya da OAuth'a geç.

Atlas kartındaki yerel @stripe/mcp paketi (0.3.3, MIT) var ama güncel Stripe MCP belgesi yalnız uzak sunucuyu anlatıyor. Cihazın BT tarafından yönetiliyorsa mcp.stripe.com adresine izin verilmesi gerekebilir.

Stripe MCP nasıl kullanılır?

Önce sandbox hesabıyla dene ve yazma isteklerini göndermeden önce ne yapılacağını göstermesini iste.

Okuma"Stripe sandbox hesabımda son 30 günün ödemelerini listele; başarısız olanları ve nedenlerini ayrı göster. Hiçbir şeyi değiştirme."

Ödeme bağlantısı"Sandbox'ta 250 TL tutarında "Danışmanlık saati" için bir ödeme bağlantısı oluştur. Oluşturmadan önce parametreleri bana göster."

İstemcinin araç onayı ayarını aç: Stripe de bunu öneriyor. Yazma araçlarında her çağrıyı kendin onayla.

Stripe MCP hangi istemcilerde çalışır?

Claude (web ve Desktop)Var	Resmî bağlayıcı; Team/Enterprise'da Owner önce ekler.
Claude Code, Codex, Cursor, VS CodeVar	Stripe belgesinde komut ve ayar örnekleri var.
ChatGPTVar	Resmî Stripe eklentisi, OAuth.
Diğer MCP istemcileriKısmen	https://mcp.stripe.com adresi; OAuth yoksa ajan API anahtarı Bearer jeton olarak.

Stripe MCP neye erişir, iade ve iptal yapar mı?

Okur

Müşteriler, ödeme niyetleri, tahsilatlar, iadeler, faturalar, abonelikler, ürünler, fiyatlar, ihtilaflar, ödemeler, bakiye, vergi ayarları, olaylar, webhook uç noktaları; Issuing kartları; Stripe belgeleri ve destek makaleleri.

Yazar

Müşteri, ürün, fiyat, kupon, ödeme bağlantısı, fatura oluşturma; iade oluşturma; abonelik oluşturma, güncelleme ve iptal; faturayı sonlandırma ya da iptal; vergi ayarları, webhook; Treasury ile para gönderme, aktarma, döviz çevirme (genel önizleme); Atlas ile şirket kuruluşu.

Siler

DELETE yöntemi destekleniyor; belgedeki desteklenen yöntem listesinde açıkça silme olarak yalnız bir kupon silme var. Abonelik iptali ve fatura iptali (void) gibi geri alınamayan işlemler listede.

Veri

Okunan hesap verisi kullandığın yapay zekâ hizmetine gider. Veri saklama bölgesi ve süresi belgede yazmıyor.

Stripe, iade ve giden ödeme gibi bazı yazma işlemlerinde insan onayı ister: ajanın verdiği bağlantıyı açıp isteği onaylarsın, 24 saat içinde onaylanmazsa süresi dolar. Ajan etiketli anahtarlarda ayrıca Dashboard onay kuralları (iade ve abonelik iptali için varsayılan kural) devrede. Verdiğin onay gerçek para hareketi yaratır.

Yönetici kontrolü: Stripe yöneticisi ekip için MCP erişimini canlı ve sandbox için ayrı ayrı açıp kapatabilir (Dashboard › MCP ve CLI erişimi ayarları). Oturumlar Dashboard › kullanıcı ayarları › OAuth sessions altından iptal edilir.

stripe/ai deposu (MIT) için GitHub Güvenlik Danışmanlıkları sorgusu boş döndü; bu uzak hizmetin güvenli olduğu anlamına gelmez. OAuth izin adlarının tam listesi incelenen sayfalarda yok.

Stripe MCP ücretsiz mi?

Stripe MCP için ayrı bir ücret kalemi resmî belgede yok. Stripe hesabının ve işlem ücretlerinin koşulları ayrı konudur: stripe.com/pricing sayfasına bak. MCP'nin ücretli plan gerektirip gerektirmediği belgede yazmıyor.

Özellik	Gerekçe
Doğal dilden SQL (analitik)	Stripe Sigma gerekir
Treasury araçları (genel önizleme)	Treasury ürünü gerekir
Atlas şirket kuruluşu	Atlas ürünü

stripe.com/global ülke listesinde Türkiye yok; Stripe'ın resmî sayfalarında Türkiye için ayrı bir açıklama görünmüyor. Bu bir mali ya da hukuki görüş değildir.

Sık sorunlar ve çözümleri

Ne oluyor	Ne yapmalı
Şirket cihazında bağlanmıyor	BT yöneticisinden mcp.stripe.com adresine izin vermesini iste.
Anahtarla 401 hatası (Aralık 2026'dan itibaren)	Tam erişimli gizli anahtar ve Agent etiketsiz kısıtlı anahtar kabul edilmeyecek; yeni ajan API anahtarı oluştur ya da OAuth'a geç.
Ajan iade yaptım diyor ama iade oluşmadı	İnsan onayı bekliyor olabilir: ajanın verdiği bağlantıyı aç ve onayla, sonra işlemi yeniden denet. 24 saatte süresi dolar.
Team Claude'da Stripe'a bağlanamıyorum	Bir Owner önce bağlayıcıyı çalışma alanına eklemeli.

Stripe MCP bağlantısı nasıl kesilir?

OAuth ile bağlandıysan: Dashboard › kullanıcı ayarları › OAuth sessions › istemci › Revoke access.
Ajan API anahtarı kullandıysan: Dashboard'da anahtarın süresini doldur (expire).
Yönetici: Ekip için MCP erişimini ayarlardan kapat.
Claude'da: Customize sonra Connectors altından Stripe bağlantısını kes.

Sık sorulan sorular

Stripe MCP benim adıma iade yapar, abonelik iptal eder mi?

stripe_api_write, Stripe API'nin POST, PATCH, PUT ve DELETE yöntemlerini çağırır; desteklenen listede iade oluşturma ve abonelik iptali var. İade ve giden ödeme gibi işlemler için Stripe insan onayı ister. Onay verdiğin işlem gerçek para hareketi yaratır; önce sandbox'ta dene ve istemcinin araç onayı ayarını aç.

Kısıtlı API anahtarıyla bağlanabilir miyim?

Stripe anahtar yolunda ajan API anahtarı (Agent rozetli kısıtlı anahtar) istiyor. Aralık 2026'dan itibaren Agent etiketsiz kısıtlı anahtarlar ve tam erişimli gizli anahtarlar kabul edilmeyecek; geçiş son tarihi 30 Kasım 2026.

Test modunda deneyebilir miyim?

Stripe sandbox ortamında ödemeler kart ağlarınca işlenmez. MCP'de OAuth sırasında canlı hesap ve sandbox ayrı seçilir; yönetici de ikisini ayrı ayrı yönetir.

Stripe MCP ücretsiz mi?

MCP için ayrı bir ücret kalemi belgede yok. Stripe hesabı ve işlem ücretlerinin koşulları stripe.com/pricing sayfasında.

Türkiye'den kullanılabilir mi?

Stripe'ın ülke listesinde (stripe.com/global) Türkiye yok; Stripe'ın resmî sayfalarında Türkiye için ayrı bir açıklama görünmüyor. Hesap açılabilirliğini Stripe'tan doğrula.

İlgili rehberler

Atlassian Rovo MCP

Canva MCP

Claude Finance eklentisi

Claude for Excel

Figma MCP

Gmail

Kaynaklar

Resmî kaynaklarda net olmayanlar: OAuth izin adlarının tam listesi · MCP için plan ya da ücret koşulu · Claude dizinindeki 11 ve Stripe belgesindeki 15 aracın hangi istemcide göründüğü · Treasury araçlarının Türkiye hesaplarında açık olup olmadığı · veri saklama bölgesi ve süresi · Türkçe ve TL bilgisi. Her biri ilgili bölümde yazılı.