BroadNet
DergiMühendislik
Mühendislik

Mesajlaşma için MCP: Yapay zeka ajanları SMS ve WhatsApp mesajlarını nasıl güvenli bir şekilde gönderebilir?

Bir MCP sunucusu, mesajlaşma API'sini bir yapay zeka ajanının çağırabileceği araçlara dönüştürür. Bu hem güçlü hem de risklidir: Gönderme aracına sahip bir ajan, gerçek müşterilere mesaj gönderebilir. İşte SMS ve WhatsApp için MCP'nin nasıl çalıştığı, BroadNet sunucusuna nasıl bağlanılacağı ve öncelikle uygulanması gereken güvenlik önlemleri.

BroadNet Mühendislik Ekibi
11 dk okuma
Mühendislik · Sayı 47
11 dk okuma

esajlaşma için bir MCP sunucusu, bir mesajlaşma API'sini Model Context Protocol aracılığıyla bir yapay zeka ajanının keşfedebileceği ve çağırabileceği araçlar olarak sunar; böylece bir asistan talep üzerine bir SMS veya WhatsApp mesajı gönderebilir. BroadNet; WhatsApp, SMS, RCS, Telegram, Push, E-posta, Messenger ve Instagram'a hizmet veren aynı API üzerinden, Streamable HTTP taşıma protokolünü ve bir Bearer token kullanarak https://mcp.broadnet.me/mcp adresinde bir sunucu çalıştırır. Bu kılavuz, sistemin nasıl çalıştığını ve daha da önemlisi, bir ajanın yanlış kişilere mesaj göndermesini nasıl engelleyeceğinizi açıklar.

Önemli çıkarımlar

  • MCP, yapay zeka uygulamalarının harici araçları keşfetmesine ve çağırmasına olanak tanıyan, JSON-RPC 2.0 üzerine inşa edilmiş açık bir protokoldür. Bir mesajlaşma MCP sunucusu; gönderme, şablon ve rapor uç noktalarını araçlara dönüştürür.
  • Uzak sunucular Streamable HTTP taşıma protokolünü kullanır: tek bir HTTPS uç noktası ve her istemci mesajı bir HTTP POST isteğidir. Yerel sunucular genellikle stdio kullanır.
  • BroadNet MCP sunucusu https://mcp.broadnet.me/mcp adresindedir ve Authorization: Bearer başlığı içermeyen tüm istekleri reddeder.
  • Bir token, bir gönderme kimlik bilgisidir. Ajan, tıpkı kendi kodunuzun yapacağı gibi, sahip olduğu izinlerle hareket eder.
  • MCP spesifikasyonu, araç çağrılarını reddedebilecek bir insanın her zaman süreçte (human in the loop) olması GEREKTİĞİNİ (SHOULD) ve sunucuların araç çağrılarına hız sınırı uygulamasının ZORUNLU olduğunu (MUST) belirtir. Her gönderim aracının etrafına rıza kontrolleri, sessiz saatler, gönderim limitleri ve onay adımları kurun.

Model Context Protocol nedir?

MCP spesifikasyonu, MCP'yi "LLM uygulamaları ile harici veri kaynakları ve araçlar arasında sorunsuz entegrasyon sağlayan açık bir protokol" olarak tanımlar. Üç rol arasında JSON-RPC 2.0 mesajlarını kullanır: ana bilgisayarlar (AI uygulaması), istemciler (ana bilgisayar içindeki konnektörler) ve sunucular (araçlar, kaynaklar ve istemler sağlayan servisler). 26 Eylül 2026 itibarıyla, spesifikasyonun en güncel revizyonu 28.07.2026 tarihlidir.

Mesajlaşma için önemli olan kısım araçlardır. Bir istemci bunları tools/list ile listeler, model birini seçer ve istemci tools/call ile çağırır. Spesifikasyon araçları "model kontrollü" olarak adlandırır: ne zaman kullanılacağına model karar verir. Bir gönderim aracının, modelin aşamayacağı koruma bariyerlerine (guardrails) ihtiyaç duymasının nedeni tam olarak budur.

SMS ve WhatsApp için bir MCP sunucusu nasıl çalışır?

İstek yolu beş sıçramadan (hop) oluşur. Tasarımın temel noktası, MCP sunucusunun yeni bir gönderim gücü eklememesidir; halihazırda sahip olduğunuz API'yi, aynı token ve aynı kontroller altında kullanıma sunar.

  1. Bir kullanıcı AI ana bilgisayara şu şekilde bir talep iletir: "WhatsApp üzerinden bu müşteriye teslimat güncellemesini gönder."
  2. Model, MCP istemcisinin çektiği listeden bir WhatsApp gönderim aracı gibi bir araç seçer ve argümanlarını doldurur.
  3. MCP istemcisi, Bearer token ile birlikte https://mcp.broadnet.me/mcp adresine HTTP POST isteği olarak bir tools/call isteği gönderir.
  4. BroadNet MCP sunucusu token'ı doğrular ve ilgili BroadNet API uç noktasına (endpoint) çağrı yapar.
  5. API mesajı WhatsApp'a veya mobil şebekeye yönlendirir ve model tarafından araç sonucu olarak geri iletilen bir sonuç döndürür.

Ürün ekibinin demo kaydında istemci; aralarında send_message, post_sms_send, post_whatsapp_message_send, get_whatsapp_template_list, post_whatsapp_template_send, post_rcs_message_send ve get_report_delivery'nın da bulunduğu 380 BroadNet aracını listeler. Tam liste sunucu sürümüne ve hesabınıza bağlıdır; MCP sunucu dokümantasyonuna bakınız.

Akışla iletilebilir (Streamable) HTTP veya stdio: hangi taşıma yöntemi?

Spesifikasyon iki standart taşıma yöntemi tanımlar. Hangisini kullanacağınız sunucunun çalıştığı yere bağlıdır ve kimlik doğrulama yöntemini bu belirler.

stdioAkışla iletilebilir HTTP
Sunucunun çalıştığı yerAynı makinede, istemci tarafından başlatılan bir alt süreç olarakHTTPS üzerinden erişilen bağımsız bir servis olarak
Mesajların iletim yoluStandart girdi ve çıktı üzerinden yeni satırla ayrılmış JSON-RPCHer bir istemci mesajı, tek bir MCP uç noktasına yapılan bir HTTP POST işlemidir; yanıtlar JSON veya sunucu tarafından gönderilen olaylar (server-sent-events) akışı olarak döner
Kimlik bilgilerinin çalışma şekliSpesifikasyon, stdio sunucularının kimlik bilgilerini ortam değişkenlerinden (environment) okuması gerektiğini belirtirHer istekte bir Authorization: Bearer başlığı bulunmalıdır; belirteçler (tokenlar) asla sorgu dizisine (query string) eklenmemelidir
Tipik kullanımYerel geliştirici araçlarıBir mesajlaşma API gibi birçok istemci tarafından paylaşılan barındırılan hizmetler
BroadNetSunulmamaktadırhttps://mcp.broadnet.me/mcp

HTTP sunucuları için, spesifikasyonun 18.06.2025 tarihli revizyonu sunucuların Origin başlığını doğrulamasını da gerektirir ve her bağlantının kimlik doğrulamasını yapmalarını önerir. En son revizyon (28.07.2026), protokol sürümünü ve istemci yeteneklerini kendi meta verilerinde taşıyarak her isteği kendi içinde bağımsız hale getirir; önceki revizyonlar bir başlatma el sıkışması (handshake) ile oturum açıyordu ve istemciler sunucunun hangi revizyonu kullandığını tespit ederek geri dönüyordu.

Bir yapay zeka ajanını BroadNet'in MCP sunucusuna nasıl bağlarsınız?

  1. BroadNet hesabınızdan bir token alın. BroadAdmin portalında, Integrations (Entegrasyonlar) kısmından MCP Integration (MCP Entegrasyonu) seçeneği geçici bir anahtar oluşturur; kalıcı bir anahtar ise hesap yöneticinizden veya ana hesabınızdan alınır.
  2. Sunucuyu MCP istemcinize ekleyin. Çoğu istemci, aşağıdakine benzer bir JSON yapılandırması kullanır. Alan isimleri istemciden istemciye biraz değişebilir, bu nedenle istemcinizin dokümantasyonunu kontrol edin.
  3. Token'ı gönderdiğiniz (commit ettiğiniz) dosyaların dışında tutun. Aşağıdaki yapılandırmada olduğu gibi, istemcinizin ortam değişkeni (environment-variable) desteğini kullanın.
  4. Araç listesini açın ve ajanın ihtiyaç duymadığı tüm araçları kapatın.
  5. Ajanı müşteri verilerine yaklaştırmadan önce, kendi numaranıza tek bir mesaj göndererek test edin.
snippet
{
"mcpServers": {
"broadnet": {
"type": "http",
"url": "https://mcp.broadnet.me/mcp",
"headers": {
"Authorization": "Bearer ${BROADNET_TOKEN}"
}
}
}
}

Bir istemci kullanmadan bağlantıyı test etmek için başlatma (initialize) isteğini kendiniz gönderin:

snippet
curl -X POST https://mcp.broadnet.me/mcp \
-H "Authorization: Bearer $BROADNET_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize",
"params":{"protocolVersion":"2025-06-18","capabilities":{},
"clientInfo":{"name":"curl","version":"1.0"}}}'

Üst bilgi (header) olmadan sunucu, protokol düzeyinde çağrıyı reddeder. 26 Eylül 2026 tarihinde kontrol edilen, kimliği doğrulanmamış bir başlatma isteğine verilen gerçek yanıt şudur:

snippet
event: message
data: {"jsonrpc":"2.0","id":1,"error":{"code":-32001,
"message":"Authorization bearer token is required. Connect with an
'Authorization: Bearer <BroadNet token>' header."}}

Bir yapay zeka ajanına mesajlaşma API anahtarı vermek güvenli mi?

Yalnızca belirli sınırlar dahilinde güvenlidir. Token bir gönderim kimlik bilgisidir: ona sahip olan herkes veya herhangi bir ajan, hesabınız üzerinden mesaj gönderebilir ve her gönderim bir maliyet oluşturur ve gerçek bir kişiye ulaşır. Ajanlar ayrıca doğal dildeki talimatlara göre hareket ederler ve bu metinlerin bir kısmı dışarıdan gelir: gelen bir müşteri mesajı veya bir web sayfası, modelin izlemeye çalışabileceği talimatlar içerebilir. MCP spesifikasyonu bu konuda nettir. Host'ların (yapay zeka uygulamalarının) herhangi bir aracı (tool) çağırmadan önce kullanıcıdan açık onay alması gerektiğini, araç çağrılarını reddetme yetkisine sahip bir insanın her zaman süreçte (human in the loop) bulunmasının önerildiğini (SHOULD) ve istemcilerin, araç açıklamalarını güvenilir bir sunucudan gelmediği sürece güvenilmez olarak kabul etmesi gerektiğini belirtir.

Bir ajanın müşterilere spam yapmasını hangi koruma mekanizmaları engeller?

Kontrolleri modelin baypas edemeyeceği yerlere yerleştirin: istemci yapılandırmasına, kendi ara yazılımınıza (middleware) veya hesap ayarlarına; isteme (prompt) kısmına değil.

RiskKontrolKonumu
Onay vermemiş birine mesaj göndermekHerhangi bir gönderim aracı çalıştırılmadan önce onay ve abonelikten ayrılma durumunu kontrol edinMiddleware veya CRM sisteminiz
Gece saatlerinde veya yanlış günde gönderim yapmakAlıcı zaman dilimine ve pazar kurallarına göre sessiz saatlerMiddleware sisteminiz
Görevin ihtiyaç duymadığı araçları kullanmakYalnızca gerekli araçları etkinleştirin; şablon, onboarding ve hesap araçlarını devre dışı bırakınMCP istemci aracı ayarları
Kontrolsüz döngüler ve toplu gönderimlerAjan başına gönderim sınırları ve hız limitleri; teknik şartname, sunucuların araç çağrılarını hız limitine tabi tutmasını gerektirirAra yazılımınız ve sunucu
Yeniden deneme sonrası yinelenen mesajlarDönen mesaj kimliğini (ID) saklayın ve yeniden göndermeden önce durumunu kontrol edinAjan mantığınız (idempotency kılavuzuna bakın)
İnceleme yapılmadan gönderilen pazarlama mesajlarıHer türlü pazarlama veya çok alıcılı gönderim için insan onayıMCP istemci onay istemleri
Gelen mesajlarda gizlenen talimatlarGelen metni veri olarak değerlendirin; bir kullanıcı isteği olmadan asla gönderim tetiklenmesine izin vermeyinYapay zeka ana bilgisayarındaki istem tasarımı ve onay kuralları
Sızdırılmış tokenDeneyler için geçici anahtarlar, ortam değişkenleri; ifşa durumunda iptal edin ve yeniden oluşturunBroadNet hesap yöneticisi
Denetim izi yokGirdileri ve sonuçları içeren tüm araç çağrılarını günlüğe kaydedinMCP istemcisi; spesifikasyon, istemcilerin araç kullanımını günlüğe kaydetmesi gerektiğini belirtiyor

BroadNet API'nin idempotens başlığı yoktur, bu nedenle zaman aşımından sonra yapılacak bir yeniden deneme mesajın iki kez gönderilmesine neden olabilir. Güvenli yöntem, API tarafından döndürülen mesaj kimliğini saklamak ve yeniden göndermeden önce iletim durumunu kontrol etmektir; idempotens ve yeniden denemeler kılavuzlarımız bunun nasıl yapılacağını göstermektedir.

Hangi mesajlaşma işlemleri insan onayı gerektirmelidir?

İşlemÖnerilen varsayılanNeden
İletim raporlarını okuyun, şablonları listeleyinOtomatikSalt okunur; müşteriye hiçbir şey ulaşmaz
Talep eden, bilinen bir müşteriye gönderilen tek bir işlem mesajıGönderim sınırı dahilinde otomatik veya tek tıkla onayDüşük risk, yüksek değer, kolay denetim
Her türlü pazarlama mesajıHer zaman insan onayıOnay, içerik ve maliyet riski
Birden fazla alıcıya yapılan tüm gönderimlerHer zaman insan onayıBir hata katlanarak artar
WhatsApp şablonları oluşturma veya göndermeİnsan onayıŞablonlar Meta tarafından incelenir ve markanızı temsil eder
Hesap, faturalandırma veya onboarding araçlarıDevre dışıBir yapay zeka ajanı, üzerinde çalıştığı hesabı değiştirmemelidir

MCP veya düz bir REST API: bir yapay zeka ajanı hangisini kullanmalı?

Her ikisi de aynı platforma ulaşır. Fark, hangi API çağrısının yapılacağına kimin karar vereceğidir.

BroadNet MCP sunucusuBroadNet REST API
Çağrıyı kimin seçtiğiAraç listesindeki modelKodunuz
Uç Noktahttps://mcp.broadnet.me/mcphttps://api.broadnet.me, örneğin POST /sms/sendSms
Kimlik DoğrulamaYetkilendirme: Bearer tokenYetkilendirme: Bearer token
İstemci kütüphanesiUzak sunucuları ve özel bir Authorization başlığını destekleyen herhangi bir MCP istemcisiTek bir resmi SDK, @broadnet/cpaas-sdk (TypeScript/Node.js); diğer istemcileri OpenAPI spesifikasyonundan oluşturun
Şunlar için en iyisidirAsistanlar, operasyonel yardımcılar, doğal dilde gerçekleştirilen anlık görevlerSabit mantığa sahip üretim akışları: OTP, uyarılar, kampanyalar

Mantıklı bir ayrım: Bir kişinin ajanı yönlendirdiği ve bir onay isteminin kabul edilebilir olduğu durumlarda MCP kullanın; her seferinde aynı şekilde çalışması gereken akışlar için ise hızlı başlangıç ve curl oluşturucu ile birlikte REST API kullanın. API referansımız, MCP araçlarının arkasındaki uç noktaları belgeler.

Sıkça sorulan sorular

Mesajlaşma için MCP sunucusu nedir?

Bir yapay zeka ajanının Model Context Protocol aracılığıyla keşfedebileceği ve çağırabileceği araçlar olarak; SMS gönderme, WhatsApp mesajı gönderme veya iletim raporu alma gibi mesajlaşma API özelliklerini sunan sunucudur.

BroadNet MCP sunucu URL'si nedir?

https://mcp.broadnet.me/mcp. MCP Streamable HTTP taşıma protokolünü kullanır ve her istekte BroadNet token'ınızın bulunduğu bir Authorization: Bearer başlığı gerektirir.

Hangi yapay zeka istemcileri buna bağlanabilir?

Streamable HTTP üzerinden uzak bir sunucuya bağlanabilen ve özel bir Authorization başlığı gönderebilen tüm MCP istemcileri bağlanabilir. BroadNet demo videosu Cursor kullanmaktadır.

Ajan gerçek mesajlar gönderebilir mi?

Evet. Araçlar, tıpkı kendi API çağrılarınız gibi, token'ınızın izinleriyle hareket eder. Her gönderimi gerçekmiş gibi değerlendirin: yalnızca ajanın ihtiyaç duyduğu araçları etkinleştirin ve gönderimlerden önce onay isteyin.

MCP ile Bearer kimlik doğrulaması nasıl çalışır?

HTTP taşıma protokolleri için istemci, aynı oturum içinde olsa bile her istekte Authorization: Bearer ifadesinin ardından token'ı gönderir ve bunu asla URL sorgu dizisinde (query string) kullanmaz. BroadNet sunucusu, bu başlık olmadan gelen istekleri reddeder.

stdio ile Streamable HTTP arasındaki fark nedir?

stdio, sunucuyu yerel bir alt süreç olarak çalıştırır ve standart giriş ile çıkış üzerinden yeni satırla ayrılmış JSON-RPC alışverişi yapar. Streamable HTTP ise sunucuyu, her istemci mesajının tek bir uç noktaya yapılan bir HTTP POST isteği olduğu bir web servisi olarak çalıştırır.

Bir yapay zeka ajanının müşterilere spam yapmasını nasıl engellerim?

Modelin dışında rıza kontrollerini, sessiz saatleri ve gönderim sınırlarını uygulayın, yalnızca ihtiyacınız olan araçları etkinleştirin, pazarlama ve çok alıcılı gönderimler için insan onayı gerektirin ve her araç çağrısını günlüğe kaydedin.

MCP mı yoksa REST API mi kullanmalıyım?

Bir kişi bir ajanı doğal dille yönlendiriyorsa MCP kullanın. Kodunuzun model yerine neyin gönderileceğine karar verdiği OTP ve uyarılar gibi sabit üretim akışları için REST API veya TypeScript SDK kullanın.

Kaynaklar

İlgili okumalar: Müşteri mesajlaşmasında yapay zeka ajanları ve kurumsal bir ajan tabanlı yapay zeka platformu seçimi.

Bu faydalı mıydı?

İçerikleri nasıl yazıyor ve gözden geçiriyoruz

Yazan

BroadNet Mühendislik Ekibi

Mühendislik ekibi hattı yönetir: SMPP bağlantıları, SS7 yığınları, yönlendirme motorları ve ayda bir milyar mesaj gönderimini mümkün kılan o temel altyapı. Yazılmaya değer bir konu olduğunda burada paylaşırlar.

Okumaya devam edin

Dergiden üç yazı daha.

Tüm yazıları görüntüleyin
K
Mühendislik

Kod ile SMS nasıl gönderilir: Tek bir REST çağrısı ile Python, PHP, Node.js, Java, Go ve C#

Kod üzerinden SMS göndermek, tek bir kimlik doğrulamalı HTTPS POST işlemidir: bir Bearer token, gönderici adı, hedef numara, mesaj ve mesaj türünü içeren bir JSON gövdesi ve karşılığında alınan bir mesaj kimliği. İşte aynı isteğin Python, PHP, Node.js, Java, Go ve C# dillerindeki örnekleri, ayrıca hata yönetimi ve canlı ortam tavsiyeleri.

BroadNet Editoryal Ekibi
9m
Y
Regülasyon

Yapay zeka destekli telefon aramaları yasal mı? 2026 yılı için AB, ABD ve BAE'de yapay zeka sesli asistan arama kuralları

Evet, yapay zeka sesli asistanlar belirli koşullar altında arama yapabilir. AB, 2 Ağustos 2026 tarihinden itibaren yapay zeka beyanını zorunlu kılmaktadır, ABD, TCPA kapsamında yapay zeka seslerini "yapay" olarak değerlendirmektedir ve BAE, otomatik pazarlama aramalarına yalnızca katı telepazarlama kuralları dahilinde izin vermektedir. Senaryolar ve bir kontrol listesi içeren karşılaştırmalı bir kılavuz.

BroadNet Mevzuat ve Düzenleme İşleri
12m
S
Mühendislik

SMS'e e-posta gönderimi: e-posta-SMS ağ geçidinin çalışma prensibi, kullanım alanları ve güvenliği

Bir e-posta-SMS ağ geçidi, bir telefon numarasına yönlendirilen e-postayı metin mesajına dönüştürür; böylece yalnızca e-posta gönderebilen izleme araçları, yardım masaları ve eski sistemler SMS üzerinden kişilere ulaşabilir. İşte bu sistemin nasıl çalıştığı, bir API'den ne zaman daha avantajlı olduğu ve sahte e-postalara karşı nasıl korunacağı.

BroadNet Editoryal Ekibi
7m
Dergi, e-posta ile

Ayda bir yazı. Başka hiçbir şey.

Abone olun; mühendislik, mevzuat veya sektörle ilgili bir sonraki içeriği yayınlandığı gün size gönderelim. Drip kampanyaları, ürün tanıtımları veya üçüncü taraflarla paylaşım yoktur. Tek tıkla abonelikten çıkabilirsiniz.

Ayda bir e-posta gönderiyoruz. İstediğiniz zaman abonelikten çıkabilirsiniz. Şuna göz atın: gizlilik politikası.

Neler alacaksınız?
  • Tık tuzağı olmayan, kapsamlı içerikler
    Tek bir konuya odaklanmış, altı ila on bir dakikalık okuma süreli yazılar.
  • Platformu işletenler yazıyor
    Mühendisler, mevzuat sorumluları ve kurum içi ürün yazarları tarafından hazırlanır.
  • Bölge odaklı
    Düzenleyici kurumlar, operatörler ve kanal karması üzerine MENA merkezli bir bakış açısı.
  • Ayda bir kez
    Drip kampanyası yok. Sadece paylaşacak bir şey olduğunda tek bir makale.
Okumayı bırakın. Uygulamaya başlayın.

Yazdıklarımızın çoğu, sahada edindiğimiz deneyimlere dayanıyor.

Eğer bu yazı size haklı geliyorsa, muhtemelen konuşmalıyız. Kullanım durumunu, hacimleri ve pazarları getirin; biz de size rota, fiyatlandırma ve arayabileceğiniz referans bir müşteri ile geri dönelim.

$ curl -X POST https://api.broadnet.me/sms/sendSms