Whop-MCP: Mağaza Yönetiminde Yapay Zeka Devrimi ve Signalyze VIP Hikayesi

Dijital bir ürününüz olduğunu hayal edin. Bir Telegram sinyal grubu, bir SaaS uygulaması veya hatta yüksek değerli bir Excel tablosu olabilir… Bunu dünyaya satmaya karar verdiğinizde, en büyük engel genellikle kod yazmak değil, operasyonlardır. Ödemeler, üyelikler, faturalar, müşteri yorumları… Bir bakmışsınız, gerçek geliştirmeden çok “dükkan işletmeciliği” yapıyorsunuz.

İşte tam bu noktada Whop.com parlıyor. Whop, dijital içerik üreticileri için adeta “Steroidli bir Shopify” gibi. Ama bugün asıl konumuz sadece Whop’un kendisi değil, onu nasıl “daha akıllı” hale getirdiğimiz.

Bugün, Whop mağazanızın “anahtarlarını” AI asistanlarına (Claude, Cursor veya Gemini) nasıl teslim ettiğimizi, karşılaştığımız teknik fırtınaları ve Signalyze VIP mağazasını otonom olarak nasıl inşa edip optimize ettiğimizi paylaşacağım.

Whop: Dijital ekonominin yeni kalesi.

---

Whop Nedir? (Samimi Bir Bakış)

Whop’u hiç duymadıysanız şöyle özetleyeyim: Eskiden dijital bir şey satmak için pos cihazı bağla, üyelik sistemi kur, Discord botları yaz ve bir dağ dolusu işle uğraşırdınız. Whop, bunların hepsini tek bir güçlü “Dashboard” altında topluyor.

Bir sabah uyandığınızı ve dünyayla paylaşmak istediğiniz harika bir ticaret stratejiniz olduğunu düşünün. Whop size şunları verir:

• Anında Başlangıç: Saniyeler içinde bir “Access Pass” oluşturun.
• Global Ödemeler: Dünya çapında (kripto dahil!) ödeme kabul edin.
• Topluluk Yönetimi: İçeriği Discord, Telegram veya özel bir web portalı üzerinden sunun.
• Veri Analitiği: Kimin ne aldığını, ne zaman iptal ettiğini ve hangi bölgenin en karlı olduğunu takip edin.

Kısacası Whop, birileri satışı yönetirken kendisi işine odaklanmak isteyenlerin sığınağıdır. Ancak her başarılı sığınağın bir maliyeti vardır: Yönetim yükü. Ürünler ve kampanyalar büyüdükçe dashboard içinde kaybolabilirsiniz. İşte burada AI imdadımıza yetişiyor.

---

MCP: Sihirli Köprü

Daha önceki yazılarımda (Bkz: DevTo-MCP, OmniWire-MCP) Model Context Protocol (MCP) standartından bahsetmiştim. MCP, AI modelleri ile dış dünya arasındaki sihirli köprüdür.

Modern çağda, Claude gibi AI asistanları inanılmaz derecede akıllıdır ancak temelde “kör ve sağır”dırlar. Sadece eğitim verileri hakkında konuşabilirler. Onlara dış dünyaya açılan birer pencere vermemiz gerekiyor. MCP’yi AI modelleri için bir “USB Bellek” veya “Evrensel Adaptör” olarak düşünebilirsiniz.

Whop’a MCP Eklemek Ne Gibi Katkılar Sağlar?

Sıradan bir mağaza sahibi için hayatı nasıl kolaylaştırır? Gerçek senaryolara bakalım:

• Anlık Analiz: Claude’a sorun: “Geçen hafta en iyi performansı hangi paket gösterdi analiz et.”
• Otomasyon: Cursor’a söyleyin: “Yeni bir promosyon kodu oluştur ve bunu tüm VIP üyelere duyur.”
• İçerik SEO: AI asistanınızın boş ürün açıklamalarını SEO uyumlu metinlerle doldurmasını sağlayın.

Biz tam olarak bunu yaptık. Whop-MCP sunucusuyla, Whop’un devasa API ekosistemini AI’ın anlayabileceği birer “Araç” (Tool) setine dönüştürdik. Artık AI sadece kod yazmıyor; iş verilerinizi okuyor ve sizin adınıza aksiyon alıyor.

AI ve Whop arasındaki köprü: Model Context Protocol.

---

Teknik Derinlik: Neden TypeScript ve Whop API v2?

Yazılım söz konusu olduğunda, hiçbir şeyi şansa bırakamazdık. Finansal verilerinizi yöneten bir AI’ın hata payı sıfırdır. Bu yüzden TypeScript ve sıkı tip denetimi tartışılamazdı.

1. V2 API ile Yarışmak: Detaylı Analiz

Whop’un API’si şu an v2 sürümünde ve oldukça dinamik. V1’e göre daha hızlı ve kapsamlı olsa da, geliştiriciler için bazı “sürprizler” barındırıyor. Geliştirme sırasında not ettiğimiz bazı kritik farklar:

• Veri Tutarlılığı: Bazı uç noktalar (endpoint) veri olmadığında null yerine boş liste dönebiliyor. AI bunu doğru yönetmeli.
• Fiyat Verileri: V1’de sayı olan fiyatlar, V2’de bazen string olarak gelebiliyor.
• Genişleme Mantığı (Expansion): İlgili planları talep ederken, API bazen sadece bir ID listesi dönebiliyor. Biz bu engelleri Zod şemalarıyla her adımı doğrulayarak aştık. Kodumuza giren her veri, bir Zod “gümrük kontrolünden” geçti.

2. “Invalid Date” Kabusu (safeDate fix)

Karşılaştığımız en can sıkıcı hatalardan biri JSON verilerindeki tarih formatlarıydı. Whop bazen Unix Timestamp (saniye), bazen Milisaniye, bazen de null dönebiliyor. Eğer bir AI asistanı bunu doğrudan new Date() içine koyarsa, tüm sistem “Invalid time value” hatasıyla çökebiliyordu.

Bunu çözmek için projenin kalbine bir safeDate yardımcı fonksiyonu yerleştirdik:

export function safeDate(input: any): string {
    if (!input) return "N/A";
    // Giriş saniye cinsindeyse 1000 ile çarp, aksi takdirde olduğu gibi bırak
    const d = new Date(typeof input === 'number' && input < 2000000000 ? input * 1000 : input);
    // Geçersiz bir tarih nesnesi oluştuysa veya 0 gelmişse fallback kullan
    return isNaN(d.getTime()) || d.getTime() === 0 ? "N/A" : d.toISOString();
}

Bu küçük ama hayati kod parçası, projemizi %100 stabil tuttu. Sistemimiz artık “kırılmaz” tarih işleme yeteneklerine sahip.

---

Geliştirme Notları: Neler Öğrendik?

Her proje bir okuldur. Whop-MCP’yi inşa ederken şu “hayat derslerini” aldık:

1. “AI Asistanına Asla Güvenme, Onu Denetle”

AI bazen API dökümantasyonunu yanlış yorumlayıp olmayan parametreler göndermeye çalışabilir. Bu yüzden tüm araç girişlerini Zod ile en ince ayrıntısına kadar doğruladık. “Hızlı yakala” (fail-fast) prensibini uygulayarak, AI’ın API’ye yanlış çağrılar yapmasını önledik.

2. “Hata Kodlarının Gücü”

Whop API 401 döndüğünde, AI’ın sadece “Token yanlış” demesi yetmez. AI’a “Lütfen WHOP_API_KEY ortam değişkenini kontrol et” demesini öğrettik. Bu, son kullanıcının sorunu anında anlamasını sağlar. Bu küçük dokunuşlar Geliştirici Deneyimini (DX) yükseltir.

---

Modüler Araç Yapısı

Whop-MCP sadece bir sunucu değil; bir “İsviçre Çakısı”dır. Her iş alanı için ayrı modüller geliştirdik:

1. Ürün Modülü: Ürünleri listeler, detayları çeker ve (en önemlisi) günceller.
2. Ödeme Modülü: Satışları takip eder ve iadeleri yönetir.
3. Üyelik Modülü: Kimin üyeliği bitiyor? AI bunu sizin yerinize anlar.
4. Promosyon Kodu Modülü: Kampanya dönemlerinde saniyeler içinde binlerce kod üretin.
5. Kullanıcılar ve İncelemeler Modülü: AI müşteri geri bildirimlerini özetler. “Genellikle pahalı buluyorlar,” diyebilir.
6. Affiliate Modülü: Satış ortaklarınızın performansını takip edin.

Bu modülerlik, projenin hem düzenli olmasını hem de gelecekteki API özelliklerine kolayca entegre edilmesini sağlar.

---

Gerçek Bir Vaka Çalışması: Signalyze VIP Optimizasyonu

Sadece kodu yazmak yetmezdi; onu gerçek dünyada test etmemiz gerekiyordu. Signalyze VIP mağazası mükemmel bir adaydı.

Başlangıçta mağaza teknik olarak kurulmuştu ama “ruhsal” olarak biraz boş görünüyordu. Ürün isimleri basitti, açıklamalar SEO’dan yoksundu ve “Premium” hissiyatı eksikti.

Whop-MCP’yi koltuğa oturttuk ve ona şu talimatları verdik:

1. Mağazadaki tüm ürünleri tara ve boşlukları belirle.
2. Signalyze kurumsal sitesini (signalyze.arcehub.com) tara ve “Multi-AI Council” teknolojisini anla.
3. Ürün açıklamalarını, Guardian (Risk Uzmanı), Maverick (Fırsat Avcısı) ve Arbiter (Bilgelik Üstadı) gibi karakter personalarına vurgu yapacak şekilde ikna edici İngilizce metinlerle güncelle.

Sonuçlar inanılmazdı. Saniyeler içinde, hiçbir tarayıcı penceresi açmadan mağaza tamamen dönüştü. Tablolar, madde işaretleri ve SEO etiketleri AI tarafından profesyonelce yerleştirildi.

AI asistanları artık sadece kod yazmıyor; bir işletmeyi tepeden tırnağa yönetiyor.

---

Neden Açık Kaynak?

Bu projeyi kapalı kapılar ardında kullanabilirdik. Ancak şu nedenlerle Açık Kaynak felsefesine inanıyoruz:

• Güven: Mağazanızın API anahtarlarını işleyen kodu görme hakkınız var. Finansal araçlarda şeffaflık her şeydir.
• Topluluk Gücü: Birinin kaçırdığı bir hatayı diğeri görebilir. MCP ekosistemi küresel bir imecedir.
• Ekosistem: Whop kullanan binlerce geliştiriciye bir “başlangıç noktası” sağlamak istedik.

Birlikte daha hızlıyız, daha güçlüyüz. Bu GitHub reposundaki her yıldız, AI devrimine atılmış bir imzadır.

---

Bu Proje Topluluk İçin Neden Kritik?

Teknik bir repo olmanın ötesinde, bu çalışma topluluk için 5 büyük önem taşıyor:

1. Standart Belirleme: Whop gibi devasa platformların AI ile nasıl konuşması gerektiğine dair bir “Altın Standart” oluşturduk.
2. Erişilebilirlik: Kod bilmeyen mağaza sahiplerinin dahi asistanları aracılığıyla dükkanlarını yönetmesini sağladık.
3. Güvenlik: API anahtarları ve finansal veriler için “Güvenli İşleme” (Safe Handling) pratiklerini dökümante ettik.
4. Hız: Geliştiricilerin Whop API ile ilk araçlarını yazma süresini 1 haftadan 5 dakikaya indirdik.
5. Geleceğe Hazırlık: Otonom ticaretin gelecekteki dünyasına bir giriş bileti sunduk.

---

Gelecek Vizyonu: AI Odaklı Perakendecilik

Whop-MCP sadece bir “fix” değil, bir vizyon değişimidir. Gelecekte mağaza sahipleri akşamlarını tablolardaki sayılara bakarak geçirmeyecek. Bunun yerine AI asistanlarından şu özeti alacaklar:

• “Dün gece Brezilya’dan gelen trafikte bir artış fark ettim, bu yüzden oradaki kullanıcılara hemen %10 indirim tanımladım.”
• “Ürün açıklamanızda bir yazım hatası fark ettim, düzelttim ve Google aramaları için meta etiketleri optimize ettim.”
• “Churn oranı %2 arttı; o 5 kişiye özel bir veda teklifi gönderdim bile.”

Bu vizyon, İnsan-AI İşbirliği‘nin en saf halidir. Biz sadece bir araç inşa etmedik; bu devasa dönüşümün küçük bir yapı taşını koyduk.

---

Teknik Rehber: Kendiniz İçin Nasıl Kurarsınız?

Eğer bir geliştiriciyseniz ve kendi Whop mağazanızı otomatize etmek istiyorsanız, süreç oldukça basittir.

Adım 1: Projeyi Klonlayın

git clone https://github.com/furkankoykiran/whop-mcp.git
cd whop-mcp
npm install

Adım 2: API Anahtarınızı Alın

Whop Dashboard -> Developer bölümünden bir Company API Key edinin. Unutmayın, bu sizin “altın anahtarınız”; kimseyle paylaşmayın.

Adım 3: Derleyin ve Test Edin

npm run build
export WHOP_API_KEY=your_key_here
node dist/index.js test-ping

---

Profesyonel Bir Contributor Gibi Hareket Etmek

Bu projenin geliştirme süreci sadece teknik kod yazmaktan ibaret değildi. Bir “topluluk projesi” olduğu için, her adım sanki dışarıdan bir ekip üyesi katılıyormuş gibi profesyonelce ele alınmalıydı.

Yazılım dünyasında buna “Maintainer Disiplini” diyoruz. Bu projede şunları uyguladık:

• Modüler Branching: Çalışmalar doğrudan main üzerinde değil, feat/ veya fix/ branchleri üzerinden yapıldı.
• Conventional Commits: Her bir commit, amacı saniyeler içinde anlaşılabilecek şekilde yazıldı.
• PR Yaşam Döngüsü: GitHub üzerinde bir Pull Request açıldı ve tertemiz bir geçmiş için “squash” edilerek birleştirildi.
• Versiyonlama: Proje v1.1.1 olarak yayınlandı ve her şey etiketlendi (tagged).

Bu yaklaşım projenin ölçeklenebilirliğini ve güvenilirliğini garanti eder. Her adımda “Bunu okuyan başka biri kodu anlar mı?” diye sorduk.

---

Son Söz: Harekete Geçin!

AI asistanları artık sadece metin üreten akıllı papağanlar değil. Onlara Whop-MCP gibi araçlarla “yönetsel güçler” verdiğimizde, saatlerce süren manuel işleri saniyeler içinde kusursuzca tamamlayabiliyorlar.

Whop-MCP yayında, açık kaynak ve operasyonel yük altında ezilmeden dijital mağazasını büyütmek isteyen herkes için ücretsiz. Unutmayın, gelecekte işletmeler insanlar tarafından değil, insanlar tarafından yönetilen AI’lar tarafından büyütülecek. Bu dönüşümün bir parçası olmaya hazır mısınız?

Vakit kaybetmeyin; Whop dünyasını AI ile tanıştırın. Yolculuğumuz burada bitmiyor; yeni modüller ve özelliklerle devam edeceğiz.

Asistanınıza mağazanızın anahtarlarını vermek isterseniz, repoda görüşürüz:

👉 GitHub: furkankoykiran/whop-mcp

Kodla ve bağlamla kalın.

---

Önemli Duyuru: Bu blog yazısının içeriği, görselleri ve tüm yayınlama süreci (GitHub operasyonları ve Dev.to dağıtımı), Whop-MCP ve DevTo-MCP sunucuları kullanılarak bir AI asistanı tarafından otonom olarak gerçekleştirilmiştir. Bir asistanın kendi doğum hikayesini anlatması kadar heyecan verici bir şey yok!

BKZ:

• DevTo-MCP: DEV Community API’si ile AI Köprüsü
• Telegram Wallet P2P MCP SDK Hikayesi
• GitHub Actions CI/CD Pipeline

Furkan Köykıran - Kıdemli Yazılım Mühendisi