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.
- Bir kullanıcı AI ana bilgisayara şu şekilde bir talep iletir: "WhatsApp üzerinden bu müşteriye teslimat güncellemesini gönder."
- Model, MCP istemcisinin çektiği listeden bir WhatsApp gönderim aracı gibi bir araç seçer ve argümanlarını doldurur.
- MCP istemcisi, Bearer token ile birlikte https://mcp.broadnet.me/mcp adresine HTTP POST isteği olarak bir tools/call isteği gönderir.
- BroadNet MCP sunucusu token'ı doğrular ve ilgili BroadNet API uç noktasına (endpoint) çağrı yapar.
- 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.
| stdio | Akışla iletilebilir HTTP | |
|---|---|---|
| Sunucunun çalıştığı yer | Aynı makinede, istemci tarafından başlatılan bir alt süreç olarak | HTTPS üzerinden erişilen bağımsız bir servis olarak |
| Mesajların iletim yolu | Standart girdi ve çıktı üzerinden yeni satırla ayrılmış JSON-RPC | Her 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 şekli | Spesifikasyon, stdio sunucularının kimlik bilgilerini ortam değişkenlerinden (environment) okuması gerektiğini belirtir | Her istekte bir Authorization: Bearer başlığı bulunmalıdır; belirteçler (tokenlar) asla sorgu dizisine (query string) eklenmemelidir |
| Tipik kullanım | Yerel geliştirici araçları | Bir mesajlaşma API gibi birçok istemci tarafından paylaşılan barındırılan hizmetler |
| BroadNet | Sunulmamaktadır | https://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?
- 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.
- 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.
- 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.
- Araç listesini açın ve ajanın ihtiyaç duymadığı tüm araçları kapatın.
- Ajanı müşteri verilerine yaklaştırmadan önce, kendi numaranıza tek bir mesaj göndererek test edin.
{ "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:
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:
event: messagedata: {"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.
| Risk | Kontrol | Konumu |
|---|---|---|
| Onay vermemiş birine mesaj göndermek | Herhangi bir gönderim aracı çalıştırılmadan önce onay ve abonelikten ayrılma durumunu kontrol edin | Middleware veya CRM sisteminiz |
| Gece saatlerinde veya yanlış günde gönderim yapmak | Alıcı zaman dilimine ve pazar kurallarına göre sessiz saatler | Middleware sisteminiz |
| Görevin ihtiyaç duymadığı araçları kullanmak | Yalnızca gerekli araçları etkinleştirin; şablon, onboarding ve hesap araçlarını devre dışı bırakın | MCP istemci aracı ayarları |
| Kontrolsüz döngüler ve toplu gönderimler | Ajan 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ı gerektirir | Ara yazılımınız ve sunucu |
| Yeniden deneme sonrası yinelenen mesajlar | Dönen mesaj kimliğini (ID) saklayın ve yeniden göndermeden önce durumunu kontrol edin | Ajan 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 talimatlar | Gelen metni veri olarak değerlendirin; bir kullanıcı isteği olmadan asla gönderim tetiklenmesine izin vermeyin | Yapay zeka ana bilgisayarındaki istem tasarımı ve onay kuralları |
| Sızdırılmış token | Deneyler için geçici anahtarlar, ortam değişkenleri; ifşa durumunda iptal edin ve yeniden oluşturun | BroadNet hesap yöneticisi |
| Denetim izi yok | Girdileri ve sonuçları içeren tüm araç çağrılarını günlüğe kaydedin | MCP 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ılan | Neden |
|---|---|---|
| İletim raporlarını okuyun, şablonları listeleyin | Otomatik | Salt 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 onay | Düşü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önderimler | Her 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 sunucusu | BroadNet REST API | |
|---|---|---|
| Çağrıyı kimin seçtiği | Araç listesindeki model | Kodunuz |
| Uç Nokta | https://mcp.broadnet.me/mcp | https://api.broadnet.me, örneğin POST /sms/sendSms |
| Kimlik Doğrulama | Yetkilendirme: Bearer token | Yetkilendirme: Bearer token |
| İstemci kütüphanesi | Uzak sunucuları ve özel bir Authorization başlığını destekleyen herhangi bir MCP istemcisi | Tek bir resmi SDK, @broadnet/cpaas-sdk (TypeScript/Node.js); diğer istemcileri OpenAPI spesifikasyonundan oluşturun |
| Şunlar için en iyisidir | Asistanlar, operasyonel yardımcılar, doğal dilde gerçekleştirilen anlık görevler | Sabit 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
- Model Context Protocol, Şartname özeti (revizyon 2026-07-28), erişim tarihi 26 Eylül 2026.
- Model Context Protocol, Transports (2025-06-18) ve Transports (2026-07-28), 26 Eylül 2026 tarihinde erişildi.
- Model Context Protocol, Authorization (2025-06-18), 26 Eylül 2026 tarihinde erişildi.
- Model Context Protocol, Tools (2026-07-28), 26 Eylül 2026 tarihinde erişildi.
- BroadNet, MCP sunucu dokümantasyonu ve 26 Eylül 2026 tarihinde https://mcp.broadnet.me/mcp üzerinde gerçekleştirilen canlı bir test.
İlgili okumalar: Müşteri mesajlaşmasında yapay zeka ajanları ve kurumsal bir ajan tabanlı yapay zeka platformu seçimi.
