AI Agent ile WhatsApp Otomasyonu: Cloudflare Üzerinde MCP Kurulumu

Geliştiricilerin AI agent sistemlerini daha akıllı hale getirmek için kullandığı bir araç olan WhatsApp MCP, son zamanlarda GitHub'da Show HN olarak paylaşılmış ve büyük ilgi görmüş bir proje. Bu rehberde, nasıl çalıştığını, nasıl kurulacağını ve geliştiricilerin kendi AI agent sistemlerini nasıl entegre edebileceğini adım adım anlatacağız.

---

WhatsApp MCP Nedir?

WhatsApp MCP, AI agentlerin WhatsApp mesajlarınızı okuyabilmesi ve işlemesini sağlayan bir servis. Bu, kullanıcıların telefonlarını doğrudan kullanmadan, bir AI asistanın konuşmasını, aramaları ve hatta toplu mesajları analiz edebilmesini sağlar.

Ancak unutulmamalıdır: bu proje resmi değildir. WhatsApp'ın kendi API'si yoktur ve bu çözüm, WhatsApp Web’in kullandığı açık kaynaklı bir kütüphane olan Baileys ile çalışır. Bu, WhatsApp'ın kullanım koşullarına aykırı olabilir, ancak tek bir okuma cihazı olarak çalıştığı için pratikte düşük risklidir.

---

Nasıl Çalışır?

WhatsApp MCP, işlevsel olarak bir bağlı cihaz gibi çalışır. Telefonunuz hâlâ "doğru kaynak"tır. MCP server, telefonunuzla bir bağlantı kurar — tıpkı WhatsApp Web ile olduğu gibi — ve mesajları düzenli olarak çekip kendi veritabanına kaydeder.

Temel Akış:

1. Bağlantı kurulur: Telefonunuzda bir QR kodu taranır.
2. Mesajlar çekilir: MCP, telefonunuzun bize verdiğin mesajları (ve geçmiş mesajları) bir kez alır.
3. Veri depolanır: Mesajlar, Cloudflare'da bir Durable Object içinde SQLite veritabanında saklanır.
4. AI agentler erişebilir: Herhangi bir MCP destekleyen uygulama (örneğin Claude Code), bu veritabanına erişebilir.
5. Yalnızca okuma: MCP mesajlar okuyabilir, ama gönderemez.

---

Kurulum Adımları

Gereksinimler

• Cloudflare hesabı (Workers Paid plan)
• Node.js 20+ sürümü
• Bir telefon (WhatsApp’la birlikte)

1. Projenin Klonlanması

git clone https://github.com/finereli/whatsapp-mcp
cd whatsapp-mcp
npm install

2. Gerekli Yapılandırması Yapın

1. OAUTH_KV depolama alanı oluşturun:

npx wrangler kv namespace create OAUTH_KV

2. Sahip şifresi ekleyin:

npx wrangler secret put OWNER_PASSWORD

12 karakterden uzun bir şifre girin.

3. Projeyi Dağıtın

npm run deploy

Bu komut, Cloudflare'da çalışacak bir URL (https://whatsapp-mcp.your-name.workers.dev) oluşturur.

---

İlk Bağlantı: Telefonunuzu Bağlamak

1. Tarayıcınızda https://whatsapp-mcp.your-name.workers.dev adresini açın.
2. Sayfada "Link WhatsApp" seçeneğini seçin.
3. Telefonunuzda WhatsApp'ta Ayarlar > Bağlı Cihazlar > Cihaz Bağla kısmından bu QR kodunu tarayın.
4. İlk bağlanışta tüm geçmiş mesajlar alınır (bu süreç biraz zaman alabilir).

Eğer telefonunuzdan ekranı tarayamıyorsanız, telefon numarası seçeneğini kullanabilirsiniz.

---

AI Agent ile Bağlantı

AI agentinize MCP’yi bağlamak için:

Claude Code Kullanıyorsanız:

claude mcp add --transport http whatsapp https://your-url/mcp

Daha sonra:

• /mcp komutunu yazın.
• Sahip şifresini girin.

Diğer MCP Uygulamaları İçin:

Aynı /mcp URL’sini kullanarak herhangi bir MCP destekleyen uygulamaya bağlanabilirsiniz.

---

AI Agent’in Yapabileceği İşlemler

MCP, AI agentlere şu işlevleri sunar:

Arama	Açıklama
list_chats	Son mesajlara göre sohbetleri listeler. İsim veya numara ile filtreleyebilirsiniz.
get_messages	Belirli bir sohbetin mesajlarını sayfalar halinde getirir.
search_messages	Tüm mesajlarda, ya da belirli bir sohbet içinde tam metin araması yapar.
unnamed_chats	Sadece numara ile bilinen sohbetleri gösterir (isimleri bilinmeyenler).
set_contact_names	Numaralara isim atar. Bu isimler kalıcıdır ve gruplarda da görünür.
sync_now	Anlık mesaj senkronizasyonu başlatır.
link_status	Bağlı olup olmadığını, son çekiliş zamanını, depolanan mesaj sayısını gösterir.
relink	Mevcut bağlantıyı kaldırıp yeniden bağlanmayı sağlar (yeni QR kodu taranır).

---

Örnek Sorular: AI Agent’i Nasıl Kullanabilirsiniz?

AI agentinize şu tür sorgular sorabilirsiniz:

• Dana, uçuşlar hakkında ne söyledi?
• Aile grubunda geçen hafta neler oldu?
• Kira sözleşmesiyle ilgili herhangi bir mesaj var mı?
• Kısa bir özet ver: son 7 gün içinde hangi sohbetlerde en çok mesaj gönderildi?

---

İsimleri Otomatikleştirmek: "Unnamed Chats" Problemi

WhatsApp, yalnızca kayıtlı kişilerin isimlerini paylaşır. Yani bir çok sohbet sadece numara ile görünür. Bu da AI agentin bu kişileri tanıyamamasına neden olur.

Ancak, MCP bu sorunu çözmek için bir çözüm önerir:

AI Agent, şu adımları yapabilir:

1. unnamed_chats komutu ile numaraları listeler.
2. Bu numaraları Google Contacts veya Gmail gibi bir hizmetle eşleştirmeye çalışır.
3. Bulduğu isimleri set_contact_names ile kaydeder.

MCP, hiçbir şekilde doğrudan kontaklara erişmez. Bu işlem, AI agentin kendisi tarafından yapılır. Bu da gizlilik açısından önemli bir avantajdır.

---

Dikkat Edilmesi Gerekenler

1. Sadece Bir Kullanıcı İçin

Her bir deployment yalnızca bir WhatsApp hesabı ve bir sahibe aittir. Birden fazla kullanıcı için ayrı部署 yapılmaları gerekir.

2. İlk Bağlantıda Tükenen Mesajlar

İlk bağlanışta, WhatsApp’ın yeni bir cihaz için vermesi gereken mesajlar gönderilir. Ancak bu tam değil olabilir. Eğer eksik mesajlar varsa, "relink" komutu ile yeniden bağlanabilirsiniz.

3. Medya İçeriği

Fotoğraflar, ses notları veya belgeler indirilmez. Sadece etiketler olarak görünür: [image], [voice note 12s] gibi.

4. Cloudflare Workers Paid Plan

İlk bağlanış sırasında çok fazla veri işlenir. Bu nedenle, Worker’ın CPU sınırları yeterli değildir. wrangler.jsonc dosyasında CPU limiti artırılmıştır. Bu da ücretli plan gerektirir.

Ücretsiz plan kullanıyorsanız, bu kısıtlamayı kaldırıp ilk bağlantıya dikkatli yaklaşmanız gerekir.

---

Geliştiriciler İçin Ekstra Bilgiler

MCP’yi Kendi Projelerinize Entegre Etme

Eğer bu projeyi kendi AI agent sisteminize entegre etmek istiyorsanız:

• GitHub'da bulunan proje kodunu bir fork edin.
• wrangler.jsonc dosyasını düzenleyerek kendi ayarlarınızı yapın.
• mcp endpoint’ini kendi uygulamanıza entegre edin.
• MCP’nin sunulan araçları (örneğin search_messages, get_messages) kullanarak AI agentinizi geliştirin.

AI Agent Nasıl Geliştirilir?

AI agent, MCP’ye sorgular gönderirken, aynı zamanda bu sorguların sonucunda ne yapması gerektiğini de bilir. Örneğin:

• search_messages ile "kira" içeren mesajları bul.
• Bulunan mesajları okuyup bir özet oluştur.
• Sonuçları kullanıcıya döndür.

Bu tür mantıklar, AI agentinizi çok daha akıllı hale getirir.

---

Sonuç

WhatsApp MCP, geliştiricilerin AI agent sistemlerini WhatsApp verileriyle entegre etmesini sağlar. Cloudflare üzerinde çalıştığı için güvenli ve kolayca yönetilebilir. Ayrıca, sadece okuma yetkisi olduğu için kullanıcıların gizliliği korunur.

Bu projeyi kendi AI sisteminize entegre etmek, kişiselleştirilmiş sohbet analizi, otomatik özetleme, haber akışı izleme gibi çok sayıda uygulama alanı sunar.

---

Hazır Mısınız?

Eğer AI agentlerinizle daha akıllı ve entegre bir deneyim yaşamak istiyorsanız, WhatsApp MCP’yi bugün kurun. GitHub’daki projeyi klonlayın, Cloudflare’da dağıtın ve AI agentinizi mesajlarınızla konuşmaya başlatsın.

Not: Bu çözüm yalnızca kişisel kullanım içindir. Başkalarının hesaplarına erişmek veya mesaj göndermek kesinlikle yasaktır.