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

Dijital bir ürününüz olduğunu hayal edin. Belki bir Telegram sinyal grubu, belki bir SaaS uygulaması, belki de sadece çok değerli bir Excel tablosu… Bunu dünyaya satmak istediğinizde karşınıza çıkan en büyük engel genelde kod yazmak değil, operasyon olur. Ödemeler, üyelikler, faturalar, müşteri yorumları derken bir bakmışsınız kod yazmaktan çok “mağazacılık” yapıyorsunuz.

İşte tam bu noktada devreye Whop.com giriyor. Whop, dijital içerik üreticileri için adeta bir “Shopify on Steroids” gibi. Ama bugün asıl konumuz Whop’un kendisi değil, onu nasıl “akıllandırdığımız”.

Bugün size, AI asistanlarımıza (Claude, Cursor veya Gemini) Whop mağazanızın “anahtarını” nasıl teslim ettiğimizi, karşılaştığımız teknik fırtınaları ve Signalyze VIP mağazasını otonom olarak nasıl ayağa kaldırdığımızı anlatacağım.

Whop: Dijital ekonominin yeni kalesi.

---

Whop Nedir? (Samimi Bir Bakış)

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

Düşünün ki bir sabah uyandınız ve harika bir ticaret stratejiniz var. Bunu insanlara satmak istiyorsunuz. Whop size şu imkanları sunar:

• Hızlı Başlangıç: Saniyeler içinde bir “Access Pass” oluşturabiliyorsunuz.
• Global Ödeme: Ödemeleri dünya çapında (kripto dahil!) kabul edebiliyorsunuz.
• Topluluk Yönetimi: Üyelerinize Discord, Telegram veya özel bir web sayfası üzerinden içerik sunabiliyorsunuz.
• Güçlü Dashboard: Kim ne almış, ne zaman iptal etmiş, en çok hangi bölgeniz kar getirmiş; hepsini görebiliyorsunuz.

Kısacası Whop, “Ben üretimime odaklanayım, satış ve üyelik işlerini birisi halletsin” diyenlerin sığınağı. Ama her başarılı sığınağın bir sorunu vardır: Yönetim yükü. Ürün sayısı arttıkça, kampanyalar sıklaştıkça o dashboard’da kaybolmaya başlarsınız. İşte tam burada Yapay Zeka imdadımıza yetişiyor.

---

İşte MCP Burada Devreye Giriyor!

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 o sihirli köprüdür.

Modern devirde AI asistanları (Claude gibi) çok akıllı ama “kör ve sağır” gibiler. Sadece kendi bildikleri veri setleriyle konuşabiliyorlar. Onlara dış dünyaya açılan birer pencere vermemiz gerekiyor. İşte MCP, AI modellerine takılan bir “USB Bellek” veya “Evrensel Adaptör” gibi çalışır.

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

Ortalama bir mağaza sahibi için hayatı nasıl kolaylaştırır? Birkaç gerçek senaryo düşünelim:

• Hızlı Analiz: Claude’a “Geçen haftanın en çok kazandıran paketini analiz et” diyebilirsiniz.
• Otomasyon: Cursor’a “Yeni bir kampanya kodu oluştur ve bunu tüm VIP üyelere duyur” talimatı verebilirsiniz.
• İçerik Editörü: AI asistanınızın, mağazanızdaki boş ürün açıklamalarını SEO uyumlu İngilizce metinlerle doldurmasını isteyebilirsiniz.

Biz tam olarak bunu yaptık. Whop-MCP sunucusuyla, Whop’un devasa API ekosistemini AI’ın anlayabileceği birer “Tool” haline getirdik. Artık AI, sadece kod yazmıyor, işletmenizin verilerini okuyor ve sizin adınıza aksiyon alabiliyor.

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

---

Teknik Derinlik: Neden TypeScript ve Whop API v2?

Yazılım kısmında şansa yer bırakamazdık. Mağazanızın finansal verileriyle oynayan bir AI’ın hata yapma lüksü yoktur. Bu yüzden TypeScript ve sıkı tip denetimi (Strong Typing) vazgeçilmezimizdi.

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

Whop API’si şu an v2 sürümünde ve oldukça dinamik bir yapıda. V1 API’sine göre çok daha hızlı ve kapsayıcı ancak geliştiriciler için bazı “sürprizler” barındırıyor. Geliştirme sürecinde not aldığımız bazı kritik farklar şunlardı:

• Data Consistency: Bazı endpointler veri varken null değil, empty list dönebiliyor. AI asistanının bunu doğru handle etmesi şart.
• Fiyat Verileri: V1’de sayı gelen fiyatlar, V2’de string olarak gelebiliyor.
• Expansion Mantığı: Veriyi çekerken yanındaki planları da getir dediğinizde, bazen API sadece ID listesi dönebiliyor. Biz bu durumu Zod şemalarıyla her adımda doğrulayarak aştık. Kodun içine giren her veri, sanki bir gümrük kontrolünden geçiyormuş gibi Zod ile validasyon edildi.

2. “Invalid Date” Kabusu (safeDate fix)

Geliştirme sürecinde karşılaştığımız en sinir bozucu hata JSON verilerindeki tarih formatlarıydı. Whop bazen Unix Timestamp (saniye), bazen Milisaniye, bazen de null dönebiliyor. AI asistanı bu veriyi new Date() içine attığında eğer format yanlışsa tüm sistem “Invalid time value” hatasıyla çöküyordu.

Bunu çözmek için projenin tam kalbine bir safeDate utility fonksiyonu yerleştirdik:

export function safeDate(input: any): string {
    if (!input) return "N/A";
    // Eğer girdi saniye cinsindeyse 1000 ile çarp, milisaniye ise dokunma
    const d = new Date(typeof input === 'number' && input < 2000000000 ? input * 1000 : input);
    // Geçersiz bir tarih nesnesi oluştuysa veya 0 gelmişse fallback ver
    return isNaN(d.getTime()) || d.getTime() === 0 ? "N/A" : d.toISOString();
}

Bu küçük ama hayati kod parçası, projenin %100 stabil kalmasını sağladı. Artık sistemimiz “kırılmaz” bir tarih işleme yeteneğine sahip.

---

Geliştirme Sürecinden Notlar: Neler Öğrendik?

Her proje bir okuldur. Whop-MCP geliştirirken biz de şu hayat derslerini aldık:

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

AI bazen API dökümanını yanlış yorumlayıp olmayan bir parametre göndermeye çalışabiliyor. Bu yüzden tüm araçlarımızın girişlerini (Input) Zod ile saniye saniye denetledik. “Fail-fast” prensibini uygulayıp, yanlış bir veri geldiğinde hemen hata döndürerek API’ye yanlış kitleme yapmasını önledik.

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

Whop API 401 döndüğünde AI’ın “Token yanlış” demesi yetmez. AI’a “Lütfen WHOP_API_KEY environment değişkenini kontrol et” demesini öğrettik. Bu sayede son kullanıcı (yani biz) hatayı anında anlayabildik. Bu tür küçük dokunuşlar, geliştirici deneyimini (DX) zirveye taşıyor.

---

Modüler Araç Yapısı (Tool Modules)

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

1. Products Module: Ürünleri listeler, detaylarını çeker ve (en önemlisi) günceller.
2. Payments Module: Satışları takip eder, iadeleri yönetir.
3. Memberships Module: Kimin üyeliği ne zaman bitiyor? AI bunu sizin yerinize anlar.
4. Promo Codes Module: Kampanya dönemlerinde saniyeler içinde binlerce kod üretmenizi sağlar.
5. Users & Reviews Module: Müşterilerinizin ne dediğini AI özetler. “Genelde pahalı bulmuşlar” gibi içgörüler sağlar.
6. Affiliate Module: Satış ortaklarınızın performansını takip eder.

Bu modülerlik sayesinde proje hem çok düzenli hem de gelecekteki yeni API özelliklerine kolayca entegre edilebilir bir yapıda. Her bir modül, kendi içinde bağımsız bir tip tanımı ve test setine sahip.

---

Gerçek Bir Case Study: Signalyze VIP Optimizasyonu

Projeyi sadece yazmak yetmezdi, onu gerçek hayatta test etmemiz gerekiyordu. Signalyze VIP mağazası bu test için harika bir adaydı.

Mağaza ilk başta teknik olarak kurulumunu tamamlamış ancak ruhsal olarak biraz boş kalmıştı. Ürün isimleri basitti, açıklamalar SEO’dan uzaktı ve “Premium” bir hissiyat vermiyordu.

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

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

Sonuç inanılmazdı. Sadece saniyeler içinde, hiçbir browser penceresi açmadan mağaza baştan aşağı değişti. Ürün açıklamalarına tablolardan tutun da, bullet point’lere ve SEO tag’lerine kadar her şey AI tarafından profesyonelce yerleştirildi.

AI asistanı artık sadece kod yazmıyor, bir işletmeyi baştan aşağı yönetiyor.

---

Neden Açık Kaynak?

Biz bu projeyi kapalı kapılar ardında kendimiz için de kullanabilirdik. Ancak Açık Kaynak (Open Source) felsefesine inanıyoruz. Çünkü:

• Güven: Kendi mağazanızın API anahtarını vereceğiniz bir aracın kodunu görmeniz en doğal hakkınız. Şeffaflık, finansal araçlarda her şeydir.
• Topluluk Gücü: Birinin göremediği bir bug’ı diğeri görüp düzeltebilir. MCP ekosistemi global bir imecedir.
• Ekosistem: Whop kullanan binlerce geliştiriciye bir “başlangıç noktası” vermek istedik.

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

---

Neden Bu Proje Topluluk İçin Kritik?

Bu çalışmanın sadece teknik bir repo olmanın ötesinde, topluluk için şu 5 büyük önemi var:

1. Standart Belirleme: Whop gibi devasa platformların AI ile nasıl konuşması gerektiğine dair bir standart (Gold Standard) oluşturduk.
2. Erişilebilirlik: Kodlama bilmeyen mağaza sahiplerinin dahi asistanları aracılığıyla dükkanlarını yönetmesini sağladık.
3. Güvenlik: API anahtarlarının ve finansal verilerin “Safe Handling” pratiklerini dökümante ettik.
4. Hız: Geliştiricilerin Whop API ile ilk tool’larını yazma süresini 1 haftadan 5 dakikaya indirdik.
5. Gelecek Hazırlığı: Gelecekteki otonom ticaret dünyasına şimdiden 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ı dashboard’larında rakamlara bakmak yerine, sabahları AI asistanlarından şu özeti alacaklar:

• “Dün akşam Brezilya’dan gelen trafikte bir artış gördüm, hemen oradaki kullanıcılara özel %10 indirim kuponu tanımladım.”
• “Ürün açıklamanda bir yazım hatası fark ettim, düzelttim ve Google aramaları için meta tag’leri optimize ettim.”
• “Churn oranı %2 arttı, ayrılan 5 kişiye özel bir veda teklifi gönderdim bile.”

İşte bu vizyon, Human-AI Collaboration‘ın en saf halidir. Biz sadece bir araç geliştirmedik, bu dönüşümün küçük bir yapı taşını yerleştirdik.

---

Teknik Rehber: Kendi Sisteminize Nasıl Kurarsınız?

Eğer bir yazılımcıysanız ve kendi Whop mağazanızı otomatize etmek istiyorsanız süreç oldukça basit.

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 anahtar sizin “altın anahtarınız”, onu 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 Rol Almak

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

Yazılım dünyasında buna “Maintainer Disiplini” diyoruz. Biz bu projede:

• Modular Branching: Doğrudan main’e değil, feat/ veya fix/ branch’leri üzerinden çalışıldı.
• Conventional Commits: Her bir commit’in ne yaptığı saniyeler içinde anlaşılabilecek şekilde yazıldı.
• PR Lifecycle: GitHub üzerinde bir Pull Request açıldı ve onay sonrası “squash” edilerek tertemiz bir tarihçe oluşturuldu.
• Versioning: Proje v1.1.1 sürümüyle release edildi ve her şey taglendi.

Bu yaklaşım, projenin ölçeklenebilirliğini ve güvenilirliğini garanti altına alıyor. Her adımda “başka biri gelip bu kodu okusa anlar mı?” sorusunu sorduk.

---

Son Söz ve Teşekkür: Harekete Geçin!

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

Whop-MCP, dijital mağazasını büyütmek isteyen ama operasyonel yük altında ezilmek istemeyen herkes için açık kaynak ve ücretsiz olarak yayında. Unutmayın, gelecekte işletmeleri insanlar değil, insanların yönettiği yapay zekalar büyütecek. Siz de bu dönüşümün bir parçası olmak ister misiniz?

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

Siz de asistanınıza mağazanızın anahtarını vermek isterseniz repoya beklerim:

👉 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 - Senior Software Engineer