🚀 WhatsApp-MCP Nedir ve Hangi Problemi Çözüyor?
Günümüzde mobil cihazlarımızda kullandığımız yapay zeka asistanları, dijital hayatımızın merkezinde yer alıyor. Ancak kişisel iletişim kanallarımızla entegrasyon kurmak istediğimizde karşımıza büyük engeller çıkıyor. Resmi API'ler genellikle WhatsApp Business gerektiriyor ya da Baileys gibi kütüphaneleri çalıştırmak için sürekli açık, maliyetli fiziksel sunuculara ihtiyaç duyuluyor. Bağımsız geliştirici zoozla, tam da bu noktada ortaya çıkan boşluğu doldurmak için whatsapp-mcp projesini geliştirdi.
Bu araç; herhangi bir ek sunucu masrafı yapmadan, tamamen kendi Cloudflare hesabınızda çalışarak kişisel WhatsApp hesabınızı MCP (Model Context Protocol) destekleyen tüm yapay zeka istemcilerine (Claude Desktop, Claude Code vb.) açıyor. Böylece asistanınıza "Dana uçuşlar hakkında ne demişti?" veya "Bu hafta aile grubunda kaçırdığım önemli detayları özetle" gibi komutlar verebiliyorsunuz. Proje, kişisel gizliliği ön planda tutarak verilerinizi üçüncü taraf sunucularda değil, doğrudan kendi bulut altyapınızda saklıyor.
⚡ Öne Çıkan Özellikler ve Mimari Yapı
Projenin arkasındaki mimari, geleneksel bot yaklaşımlarından oldukça farklı. Telefonunuz her zaman gerçeğin tek kaynağı (source of truth) olarak kalmaya devam ediyor. Sunucu, WhatsApp ile sürekli aktif bir bağlantı kurmak yerine, yalnızca yapay zeka ajanınız bir veri talep ettiğinde veya günde bir kez arka planda tetikleniyor. WhatsApp'ın o ana kadar kuyruğa eklediği mesajları çekip Cloudflare hesabınızdaki Durable Objects içinde yer alan şifreli bir SQLite veritabanına kaydediyor ve ardından bağlantıyı kapatıyor.
Sistemin en kritik özelliklerinden biri, WhatsApp'ın bağlı cihazlara her zaman tam kişi isimlerini iletmemesi sorununu çözmek için Google hesabınızla entegre olabilmesidir. Bu sayede telefon numaraları kişi isimleriyle eşleştirilir ve arama fonksiyonları kusursuz çalışır. Kurulum aşamasında ise Cloudflare Wrangler CLI kullanılarak hızlıca bir OAUTH_KVnamespace oluşturulur ve güvenli bir OWNER_PASSWORD tanımlanarak sistem canlıya alınır. Workers Paid plan gereksinimi ise ilk büyük tarihçe içe aktarımındaki yoğun CPU yükünü aşmak için akıllıca konumlandırılmıştır.
💡 Neden Radarımıza Girdi? (Editör Notu)
Weezir Radar ekibi olarak bu projeyi seçmemizin temel sebebi, yapay zeka ajanlarının kişisel iş akışlarımızdaki entegrasyon sınırlarını zorlayan cesur bir "gri alan" projesi olmasıdır. Resmi olmayan WhatsApp Web protokollerini (Baileys kütüphanesi aracılığıyla) Cloudflare Workers gibi modern, sunucusuz bir ekosistemle buluşturması mühendislik açıdan büyüleyicidir. Sürekli açık sunucu maliyetini ortadan kaldırması ve verilerin tamamen kullanıcının kendi kontrolündeki bulut alanında kalması, gizlilik odaklı bağımsız geliştiriciler için mükemmel bir ilham kaynağı oluşturuyor.
Elbette topluluk tartışmalarında da değinildiği gibi; bu tür çözümler WhatsApp'ın kullanım şartlarını zorladığı için hesap banlanma riski gibi pratik dezavantajlar barındırır. Ancak projenin sadece mesajları okuma (asla göndermeme) prensibiyle tasarlanmış olması, güvenlik risklerini minimuma indiriyor. Kişisel verilerinin güvenliğinden ödün vermeden akıllı yapay zeka asistanlarıyla tam entegre çalışmak isteyen ileri düzey geliştiriciler için kaçırılmayacak bir deneyim sunuyor.
🚀 Nasıl Denenir, Fiyatlandırma ve Kaynaklar
Proje tamamen açık kaynaklıdır ve bireysel kullanım için MIT lisansıyla sunulmaktadır. Denemek için Node.js 20+ sürümüne ve aktif bir Cloudflare hesabına ihtiyacınız var. Kod deposunu klonlayıp bağımlılıkları yükledikten sonra terminal üzerinden şu adımları izleyebilirsiniz:
git clone https://github.com/finereli/whatsapp-mcp
cd whatsapp-mcp
npm install
# KV namespace ve şifre tanımlama
npx wrangler kv namespace create OAUTH_KV
npx wrangler secret put OWNER_PASSWORD
# Dağıtım
npm run deployDağıtım sonrasında size verilen Cloudflare Workers URL'sini tarayıcınızda açarak WhatsApp QR kodunu taratabilir ve hızlıca entegrasyonu tamamlayabilirsiniz. Detaylı dokümantasyon, kaynak kodlar ve güncellemeler için resmi GitHub Deposunu ziyaret edebilirsiniz.