İçeriğe geç
OmniChannels.ai

WhatsApp MCP Sunucusu: AI Agent'ları WhatsApp ve SMS'e Bağlayın

WhatsApp MCP sunucusu, Claude, Cursor ve diğer AI agent'ların WhatsApp ile SMS göndermesini nasıl sağlar: kurulum, guardrail'ler, onay ve örnek senaryolar.

Güncelleme 9 dk okuma

Yazar: OmniChannels.ai Editorial Team · İnceleyen: BroadNet Messaging Solutions Team

Entegrasyon

Kısa yanıt

WhatsApp MCP sunucusu, mesajlaşma işlemlerini bir AI agent'ın Model Context Protocol üzerinden keşfedip çağırabileceği araçlar olarak sunar. https://mcp.broadnet.me/mcp adresindeki OmniChannels.ai MCP sunucusuyla Claude Code veya Cursor gibi bir istemci Bearer token ile kimlik doğrular; SMS ve WhatsApp mesajları gönderebilir, şablonları listeleyebilir ve iletim raporlarını okuyabilir. Agent hesabınızın izinleriyle çalıştığı için guardrail'ler önemlidir.

Bu sayfada
  1. WhatsApp MCP sunucusu nedir?
  2. OmniChannels.ai MCP sunucusu nasıl çalışır?
  3. Claude, Cursor veya başka bir istemciyi nasıl bağlarım?
  4. Bir AI agent WhatsApp ve SMS ile neler yapabilir?
  5. Bir AI agent'ın yanlış kişilere mesaj göndermesini nasıl önlerim?
  6. Hangi WhatsApp ve SMS kuralları hâlâ geçerli?
  7. Örnek senaryo: Bir destek ekibi iletim durumu asistanı ekliyor
  8. MCP ne zaman yanlış seçimdir?
  9. OmniChannels.ai nasıl yardımcı olur?

Öne çıkan noktalar

  • MCP (Model Context Protocol), bir AI istemcisinin uzak bir sunucudaki araçları listelemesini ve çağırmasını sağlayan açık bir standarttır; OmniChannels.ai sunucusu araçlarını kodunuzun kullanacağı aynı REST API'ye eşler.
  • Streamable HTTP üzerinden tek bir uç nokta, https://mcp.broadnet.me/mcp, ve tek bir başlık, Authorization: Bearer <token>, Claude Code, Cursor, VS Code, Claude Desktop ve diğer istemcileri bağlar.
  • Gönderim araçları olan bir agent gerçek insanlara mesaj gönderebilir ve gerçek bakiye harcayabilir; bu yüzden yalnızca ihtiyaç duyduğu araçları etkinleştirin ve her gönderimden önce insan onayı isteyin.
  • WhatsApp kuralları agent'lar için de geçerlidir: opt-in, müşteri hizmetleri penceresi dışında onaylı şablonlar ve SMS için gönderici kimliği kuralları.
  • Denerken geçici bir anahtar, yalnızca gözden geçirilmiş bir canlı agent için kalıcı bir anahtar kullanın.

Bu rehber, her entegrasyonu elle yazmadan bir AI agent'ın WhatsApp ve SMS mesajları göndermesini veya takip etmesini isteyen geliştiriciler ve teknik liderler için hazırlandı. WhatsApp MCP sunucusunun ne olduğunu, bir tanesinin nasıl bağlanacağını, agent gerçek müşterilere dokunmadan önce hangi guardrail'lerin konacağını ve MCP'nin nerede yanlış araç olduğunu açıklar.

WhatsApp MCP sunucusu nedir?

WhatsApp MCP sunucusu; bir şablon göndermek veya bir iletim raporunu okumak gibi mesajlaşma işlemlerini bir AI istemcisinin keşfedip çağırabileceği araçlar olarak sunan bir hizmettir. AI asistanlarını harici araçlara ve verilere bağlamak için açık bir standart olan Model Context Protocol (MCP) ile konuşur.

MCP olmadan bir asistana mesaj gönderme yeteneği vermek, her model veya framework için özel bir fonksiyon yazmak demektir. MCP ile istemci tek bir URL'ye bağlanır, sunucuya hangi araçların bulunduğunu sorar ve kullanıcının talebi gerektirdiğinde onları çağırır. MCP sunucuları sözlük maddemiz kısa tanımı verir.

Gözden kaçması kolay iki nokta:

  • MCP, WhatsApp'ın kurallarını atlamaz. Sunucu, diğer her entegrasyon gibi aynı WhatsApp Business Platform işlemlerini çağırır; bu yüzden şablonlar, opt-in ve müşteri hizmetleri penceresi yine geçerlidir.
  • Agent, token'ı kadar güvenlidir. Araçlar, verdiğiniz anahtarın izinleri, gönderici kimlikleri ve bakiyesiyle çalışır.

OmniChannels.ai MCP sunucusu nasıl çalışır?

Tek bir uç noktada, Bearer token ile kimlik doğrulayan uzak bir MCP sunucusudur. Araçları geliştirici belgelerinde belgelenen aynı REST API'ye eşlenir; yani bir agent'ın yapabildiği, kendi kodunuzun o token ile yapabileceğidir.

Ayar Değer
Uç nokta https://mcp.broadnet.me/mcp
Aktarım MCP Streamable HTTP
Kimlik doğrulama Her istekte Authorization: Bearer <token>
Üzerinde çalıştığı Hesabınız: kanallar, gönderici kimlikleri, şablonlar ve bakiye
Tipik araç alanları Her kanalda gönderim (SMS, WhatsApp, RCS, Telegram, Messenger, Instagram, Push), WhatsApp şablonlarını listeleme ve gönderme, iletim raporlarını okuma

Tam araç listesi sunucu sürümüne ve hesabınıza bağlıdır; bu yüzden bir blog yazısından değil istemcinizden okuyun. Token olmadan yapılan bir istek protokol düzeyinde reddedilir; bu faydalı bir duman testidir.

Claude, Cursor veya başka bir istemciyi nasıl bağlarım?

Uç noktayı ve başlığı istemcinizin MCP yapılandırmasına eklersiniz ve token'ı bir ortam değişkeninde veya gizli girdide tutarsınız; böylece asla bir depoya düşmez.

Beş adımda bağlanın

  1. Bir anahtar alın. Yönetici portalında Entegrasyonlar'ı, ardından MCP Entegrasyonu'nu açın ve Geçici anahtar al'ı seçin. Canlı bir agent için kalıcı anahtar hesap yöneticinizden veya ana hesaptan gelir.
  2. Gizli bilgi olarak saklayın. Örneğin kabuğunuzda BROADNET_TOKEN olarak dışa aktarın.
  3. Sunucuyu istemcinize ekleyin. Claude Code için:
claude mcp add --transport http omnichannels https://mcp.broadnet.me/mcp \
  --header "Authorization: Bearer $BROADNET_TOKEN"
  1. Araçları kontrol edin. Claude Code'da /mcp komutu sunucuyu ve araçlarını gösterir. Cursor, VS Code ve Claude Desktop'ta yapılandırma istemcinin kendi MCP ayar dosyasında bulunur.
  2. İlk gerçek prompt'tan önce agent'ın ihtiyaç duymadığı her şeyi kapatın.

İstemci biçimleri sürümler arasında değişir; bu yüzden Cursor, VS Code ve Claude Desktop için kesin parçalar belgelerde yer alır; Claude Code, Cursor ve n8n için adım adım sayfalar vardır. Claude Code'un kendi MCP belgeleri komutları için başvuru kaynağıdır.

Herhangi bir istemci olmadan test etmek için uç noktaya token'ınızla MCP initialize isteğini gönderin. Belgeler tam curl komutunu gösterir.

Bir AI agent WhatsApp ve SMS ile neler yapabilir?

Bağlı araçların izin verdiği her şeyi: gönderme, sorgulama ve raporlama. Pratik değer, kodda tutmanız gereken yüksek hacimli akışlarda değil, mesajlaşmanın çevresindeki esnek, insan diliyle yapılan görevlerdedir.

Bir agent'a uyan örnek prompt'lar:

  • "OmniDemo'dan 447700900123 numarasına teknisyenin saat 15:00'te geleceğini söyleyen bir SMS gönder."
  • "Arapça onaylı WhatsApp şablonlarımı listele."
  • "order_update WhatsApp şablonunu INV-400 sipariş numarasıyla 971500000000 numarasına gönder."
  • "Dünkü ekstre kampanyasında kaç mesaj başarısız oldu ve neden?"
  • "Sonbahar lansmanımız için bir RCS kartı taslağı hazırla ve bir şey göndermeden önce bana göster."

İyi kullanım senaryoları, kabaca güvenlik sırasıyla:

Kullanım senaryosu Gereken araçlar Risk
Destek personelinden iletim soruları ("bu müşteri SMS'i aldı mı?") Salt okunur rapor araçları Düşük
Bir entegrasyon kurarken yalnızca kendi numaralarınıza test mesajı gönderen geliştirici asistanı Gönderim araçları, yalnızca test numaraları Düşük ile orta
Şablon sorgulama ve inceleme için metin taslağı hazırlama Şablon listeleme araçları Düşük
Bir insan onayladıktan sonra tek seferlik bildirimler gönderen operasyon asistanı Gönderim araçları artı onay Orta
Müşterilere gönderen otonom agent Gönderim araçları, onay yok Yüksek; gözden geçirilmiş bir tasarım gerekir

İletim sorularını yanıtlayan dahili bir asistanın hiç gönderim aracına ihtiyacı yoktur. Onları kaldırın.

Bir AI agent'ın yanlış kişilere mesaj göndermesini nasıl önlerim?

Agent'a şirket telefonu olan yeni bir çalışan gibi davranın: sınırlı izinler, başlangıçta gözetim ve yaptıklarının kaydı. Belgeler korumaları listeler; işte gerekçeleriyle birlikte.

  1. En az ayrıcalık. Yalnızca görevin ihtiyaç duyduğu araçları etkinleştirin. İletim sorularını yanıtlayan bir agent'ın gönderim araçlarına ihtiyacı yoktur; OTP gönderen bir agent'ın şablon veya hesap araçlarına ihtiyacı yoktur.
  2. Döngüde insan. İstemciyi gönderen herhangi bir araçtan önce ve çok alıcıya gönderimlerden her zaman önce onay isteyecek şekilde yapılandırın. Claude Code'da izin kuralları MCP araçlarına mcp__<server>__<tool> olarak atıf yapar; böylece okuma araçlarının serbestçe çalışmasına izin verirken gönderim araçları yine onay ister.
  3. Denemeler için geçici anahtarlar. Test ederken geçici bir anahtar, yalnızca gözden geçirilmiş bir canlı agent için kalıcı anahtar kullanın.
  4. Önce test numaraları. Davranışlarına güvenene kadar yeni agent'ları kendi doğrulanmış numaralarınıza yöneltin.
  5. Günlükleri izleyin. Agent'ın gönderdiklerini, özellikle ilk haftalarda, iletim raporlarınızdan gözden geçirin.
  6. Hızla iptal edin. Bir anahtar ifşa olursa hesap yöneticinizden veya destek ekibimizden iptal edip yenisini vermesini isteyin.
  7. Onaya saygı gösterin. Agent'lar diğer her gönderici gibi aynı opt-in, gönderici kimliği ve kanal kurallarını izlemelidir.

Prompt injection özel bir değinmeyi hak eder. Bir agent gelen bir müşteri mesajı veya bir web sayfası gibi güvenilmez metin okuyorsa o metin talimatlar içerebilir. Güvenilmez içerik okuyan bir agent'a gözetimsiz gönderim araçları erişimi vermeyin. Okuma ve göndermeyi ayrı adımlarda tutun ve gönderimi bir kişi onaylasın.

Hangi WhatsApp ve SMS kuralları hâlâ geçerli?

Hepsi. Agent yalnızca bir başka göndericidir.

  • Opt-in. Meta'nın WhatsApp Business Mesajlaşma Politikası, insanların sizden haber almayı kabul etmiş olmasını gerektirir. Bir elektronik tablodaki herkese mesaj gönderebilen bir agent bunu değiştirmez.
  • Şablonlar ve pencere. Serbest biçimli WhatsApp mesajları yalnızca müşteri hizmetleri penceresi içinde mümkündür; dışında onaylı bir şablon gerekir. 24 saatlik müşteri hizmetleri penceresi rehberimize ve WhatsApp API belgelerine bakın.
  • Maliyet. Meta teslim edilen mesaj başına kategoriye göre ücret alır ve bir agent hızla hacim üretebilir. Gönderebileceği miktarı sınırlayın ve maliyetleri WhatsApp fiyat hesaplayıcımızla modelleyin.
  • SMS gönderici kimlikleri. SMS birçok ülkede kayıtlı bir gönderici kimliği gerektirir. Agent, hesabınızda onaylı gönderici kimliklerini kullanır.

Örnek senaryo: Bir destek ekibi iletim durumu asistanı ekliyor

BAE'li bir çevrimiçi perakendeci olan "Souq Rafiq" (kurgusal), destek personelinin panolar açmadan "müşteri mesajımızı aldı mı?" sorusunu yanıtlamasını istiyor.

  • Kurulum: bir yönetici geçici bir anahtar üretir ve iki destek lideri için Claude Desktop'ı MCP sunucusuna bağlar.
  • Araçlar: yalnızca rapor okuma araçları etkin. Gönderim araçları kapalı.
  • Kullanım: bir lider şunu sorar: "Dünkü ekstre kampanyasında kaç mesaj başarısız oldu ve neden?" Agent iletim raporunu okur ve nedenleri duruma göre özetler.
  • Gözden geçirme: iki hafta sonra yönetici iletim raporlarını kontrol eder, hiçbir şey gönderilmediğini teyit eder ve küçük bir canlı asistan için kalıcı anahtar ister.
  • Sonraki adım: asistanın kaçırılmış bir bildirimi yeniden göndermesine izin vermek için ekip, onayı açık tek bir gönderim aracını etkinleştirir ve önce onu bir test numarası grubuyla sınırlar.

MCP ne zaman yanlış seçimdir?

Deterministik ve yüksek hacimli her şey için REST API'yi, OpenAPI belirtimini veya SDK'yı kullanın.

  • OTP ve işlemsel akışlar. Bir giriş kodu, onu başka sözcüklerle ifade edebilecek bir modelden değil, kontrol ettiğiniz koddan gelmelidir. REST hızlı başlangıcına bakın.
  • Toplu kampanyalar. Konuşmaya dayalı bir prompt değil, gözden geçirilmiş bir dosyayla kampanya araçlarını veya toplu uç noktaları kullanın.
  • Gözetimsiz müşteri sohbeti. Müşteriye dönük bir agent; tasarlanmış bir konuşma akışı, bilgi, insanlara devir ve izleme gerektirir. Bu bir AI agent ürünüdür, bir geliştiricinin MCP oturumu değil.
  • Bu rehberin sınırları. İstemci yapılandırma biçimleri ve araç listesi sürümler arasında değişir. İkisini de belgelerde ve istemcinizde teyit edin.

OmniChannels.ai nasıl yardımcı olur?

OmniChannels.ai, https://api.broadnet.me adresindeki REST API'nin yanında https://mcp.broadnet.me/mcp adresindeki MCP sunucusunu sunar; SMS, WhatsApp, RCS, Messenger, Instagram, Telegram, E-posta ve Push boyunca tek bir Bearer token modeli vardır. BroadNet resmi bir Meta Business Solution Provider'dır ve AI agent ürünü İngilizce ile Arapçayı, bir insan temsilciye devri ve MCP ile araç kullanımını destekler; bkz. AI agent'lar. Test erişimi kendi doğrulanmış numaralarınıza gider. MCP rehberi ve geliştirici genel bakışıyla başlayın.

Sık sorulan sorular

MCP sunucusu nedir?

MCP sunucusu, açık bir standart olan Model Context Protocol aracılığıyla AI istemcilerine araçlar sunan bir programdır. İstemci bağlanır, araçları listeler ve kullanıcının talebi gerektirdiğinde çağırır. Uzak bir MCP sunucusu sağlayıcının altyapısında çalışır; bu yüzden kod kurmak yerine bir URL'ye bağlanır ve kimlik doğrularsınız.

Claude WhatsApp mesajı gönderebilir mi?

Claude tek başına WhatsApp'a ulaşamaz; ancak MCP destekleyen bir Claude istemcisi bir mesajlaşma MCP sunucusunun araçlarını çağırabilir. OmniChannels.ai MCP sunucusu bağlıyken Claude Code veya Claude Desktop, araç ayarlarınıza ve Meta'nın kurallarına tabi olarak hesabınızdan onaylı bir WhatsApp şablonu veya SMS gönderebilir.

Bir AI agent'ın mesaj göndermesine izin vermek güvenli mi?

Yalnızca guardrail'lerle güvenlidir. Asgari araç kümesini etkinleştirin, gönderimler için insan onayı isteyin, önce kendi doğrulanmış numaralarınıza karşı test edin, denerken geçici anahtarlar kullanın ve iletim raporlarını gözden geçirin. Agent token'ınızın izinleriyle çalışır; izin verirseniz bakiye harcayabilir ve gerçek insanlara ulaşabilir.

Bir agent'ın birine mesaj göndermesi için WhatsApp şablonu gerekir mi?

Evet, müşteri hizmetleri penceresi dışında. Meta serbest biçimli mesajlara yalnızca müşterinin açtığı bir pencere aktifken izin verir; aksi halde işletme onaylı bir şablon göndermelidir. Bir agent onaylı şablonlarınızı listeleyip birini adıyla gönderebilir, ancak anında yeni onaylı bir şablon icat edemez.

MCP sunucusu REST API'nin yerini alır mı?

Hayır. Araçlar aynı token ve izinlerle aynı REST API'ye eşlenir. Bir AI istemcisinin işlemleri kendisi keşfedip çağırmasını istediğinizde MCP'yi, OTP akışları ve sipariş bildirimleri gibi deterministik canlı kod için REST API'yi, OpenAPI belirtimini veya SDK'yı kullanın.

MCP anahtarını nasıl alırım?

Yönetici portalında oturum açın, Entegrasyonlar sonra MCP Entegrasyonu'nu açın ve Geçici anahtar al'ı seçin. Canlı bir agent için kalıcı anahtarı hesap yöneticiniz veya ana hesap verir. Test erişimi kendi doğrulanmış numaralarınıza gider ve anında self-servis kayıt yoktur.

Kaynaklar

  1. Model Context Protocol belirtimi (2025-06-18)
  2. Claude Code'u MCP ile araçlara bağlama — Claude Code belgeleri
  3. WhatsApp Business Mesajlaşma Politikası
  4. WhatsApp Business Platform'da fiyatlandırma — Meta for Developers