Cloudflare Üzerinde Çalışan Salt Okunur WhatsApp MCP Sunucusu

whatsapp-mcp: Yapay Zeka Ajanınızın WhatsApp Mesajlarınızı Okumasını Sağlayın#

whatsapp-mcp, kendi Cloudflare hesabınızda çalışan küçük ve salt okunur (read-only) bir Model Context Protocol (MCP) sunucusudur. Telefonunuzu tıpkı WhatsApp Web bağlar gibi bir kez eşleştirirsiniz; bu andan itibaren MCP protokolünü destekleyen herhangi bir istemci (Claude Code, Claude Desktop vb.) sohbetlerinizde arama yapabilir ve mesajlarınızı okuyabilir. Sunucu mesajları okuyabilir, arayabilir ve telefon numaralarına verdiğiniz isimleri hatırlayabilir; ancak hiçbir şekilde mesaj gönderemez. Bu tasarım, üretim ortamında Production MCP Entegrasyonu ve MCP Sunucusu Geliştirme süreçlerinde yetki sınırlandırması (least privilege) ilkesinin ne kadar kritik olduğunu gösteren harika bir mimari örnektir.

Ajanınıza şu tarz sorular sorabilirsiniz:

"Dana uçuşlar hakkında ne söyledi?"
"Tüm sohbetlerimde kira sözleşmesinden bahsedilen her mesajı bul."
"Bu hafta aile grubunda kaçırdığım konuşmaları özetle."

Nasıl Çalışır?#

Telefonunuz ana veri kaynağı (source of truth) olarak kalmaya devam eder. Sunucu, yapay zeka ajanınızın konuştuğu bağlı bir cihaz (linked device) gibi davranır. WhatsApp'a sürekli bağlı kalmaz; yalnızca ajanınız bir şey sorduğunda ve günde bir kez bağlanarak son bağlantıdan bu yana WhatsApp'ın kuyruğa aldığı verileri toplar, kendi veritabanına yazar ve bağlantıyı kapatır. Böylece telefonunuz normal şekilde çalışmayı ve bildirim almayı sürdürür.

Mesajlarınız kendi Cloudflare hesabınızdaki bir Durable Object içinde yer alan SQLite veritabanında tutulur ve verileriniz başka hiçbir yere gitmez. Yazılım geliştirme açısından bu yaklaşım, durum bilgisi olan (stateful) sunucusuz mimarilerin ve uç (edge) bilişim kaynaklarının kişisel veri gizliliğini koruyarak nasıl verimli kullanılabileceğini gösterir.

Kurulum#

Kurulum için Workers Paid planında bir Cloudflare hesabına, Node 20 veya daha yeni bir sürüme ve telefonunuza ihtiyacınız vardır. Öncelikle depoyu klonlayıp bağımlılıkları yükledikten sonra şu üç temel adımı izlersiniz:

1. Oturum açma belirteçleri (token) için alan oluşturma: npx wrangler kv namespace create OAUTH_KV komutunu çalıştırın ve ekrana yazdırılan kimliği wrangler.jsonc dosyasına yapıştırın.
2. Telefon eşleştirme sayfası için parola belirleme: npx wrangler secret put OWNER_PASSWORD komutuyla en az 12 karakterli güvenli bir parola tanımlayın.
3. Dağıtım (Deploy): npm run deploy komutuyla sunucuyu yayına alın.

Wrangler size https://whatsapp-mcp.adiniz.workers.dev benzeri bir URL verir. Bu adresi açtığınızda karşınıza kalan iki adım çıkar:

WhatsApp'ı Bağlayın: WhatsApp üzerinden (Ayarlar, Bağlı Cihazlar, Cihaz Bağla) QR kodunu tarayın. İşlemi doğrudan telefon üzerinden yapıyorsanız ve ekranı tarayamıyorsanız telefon numarası seçeneğini kullanın. İlk bağlantı geçmiş mesajlarınızı içe aktarır; sayfa ilerleme durumunu gösterir ve bu sırada sayfayı kapatabilirsiniz.
Ajanınızı Bağlayın: Claude Code içinde claude mcp add --transport http whatsapp https://your-url/mcp komutunu çalıştırın, ardından /mcp yazıp belirlediğiniz parolayla giriş yapın. Diğer istemcileri de aynı /mcp adresine yönlendirebilirsiniz. Kendi alan adınızı kullanmak isterseniz wrangler.jsonc dosyasının altındaki yorum satırlarını inceleyebilirsiniz.

Workers Paid Planı Hakkında Not#

Büyük bir mesaj geçmişini içe aktarmak tek seferde çok fazla verinin çözülmesini (decode) gerektirir ve Cloudflare Workers üzerindeki varsayılan CPU sınırı bunun için yetersiz kalır. wrangler.jsonc dosyası bu sınırı yükseltir ve sınırın artırılması aylık birkaç dolar olan ücretli planı gerektirir. Ücretsiz planda deniyorsanız limits bloğunu kaldırmanız gerekir; ancak bu durumda ilk veri aktarımının kırılgan olabileceğini göz önünde bulundurmalısınız.

Bilinmesi Gerekenler#

Bu mimari, kişisel verileri üçüncü parti servislere açmadan kendi bulut altyapınızda Hazır MCP Sunucuları ve Ekosistem araçlarıyla güvenli ajan entegrasyonu kurmanın pratik bir yolunu sunar.