Yapay zeka ajanlarını MCP ile BroadNet'e bağlayın.

MCP sunucusunun ne olduğu

Model Bağlam Protokolü (MCP), yapay zeka asistanlarının harici araçları keşfetmesine ve çağırmasına olanak tanıyan açık bir standarttır. BroadNet MCP sunucusu uzak bir MCP sunucusudur: istemciniz HTTPS üzerinden sunucuya bağlanır, sunulan araçları listeler ve sizin adınıza bunları çağırır.

Araçlar, API referansında ve OpenAPI spesifikasyonunda belgelenen BroadNet API ile eşleşir — mesaj gönderme, WhatsApp şablonlarıyla çalışma ve iletim raporlarını okuma gibi. Ajan, tıpkı kendi kodunuz gibi, kendisine verdiğiniz token'ın yetkileriyle hareket eder.

İki MCP sunucusu: bilgi ve mesajlaşma

BroadNet iki adet MCP sunucusu çalıştırır. Bu sayfada açıklanan mesajlaşma sunucusu hesabınız üzerinde işlem yapar. Bilgi sunucusu ise herkese açıktır: bir temsilci giriş yapmadan BroadNet'in kapsama alanı, gönderici adı kuralları, yayınlanmış liste fiyatları, düzenlemeler ve şirket bilgileri hakkında soru sorabilir.

Bilgi sunucusunu bir terminal üzerinden deneyin: önce el sıkışma işlemini başlatın, ardından bir araç çağrısı yapın.

curl -X POST https://www.broadnet.me/mcp \
  -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"}}}'

curl -X POST https://www.broadnet.me/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2025-06-18" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"sender_id_rules","arguments":{"country":"ae"}}}'

Uç nokta ve kimlik doğrulama

Her hesap için tek bir uç nokta mevcuttur: https://mcp.broadnet.me/mcp.. Her istek, Authorization başlığında BroadNet token'ınızı taşımalıdır.

Token'ı BroadNet hesabınızdan alırsınız. Demoda bu token, BroadAdmin portalında Integrations → MCP Integration altında “Get temporary key” seçeneği ile oluşturulur; portal, kalıcı bir anahtarın hesap yöneticiniz veya ana hesabınız tarafından verildiğini belirtir.

Üstbilgisi (header) olmayan bir istek protokol düzeyinde reddedilir — bu, sunucunun kimliği doğrulanmamış bir başlatma çağrısına verdiği gerçek yanıttır:

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 MCP istemcisi bağlayın

Çoğu MCP istemcisi, sunucu URL'si ve istek üstbilgilerini içeren JSON yapılandırması kullanır. Tipik bir giriş şu şekildedir:

{
  "mcpServers": {
    "broadnet": {
      "type": "http",
      "url": "https://mcp.broadnet.me/mcp",
      "headers": {
        "Authorization": "Bearer ${BROADNET_TOKEN}"
      }
    }
  }
}

Bir istemci olmadan bağlantıyı test etmek için MCP başlatma 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"}}}'

Demoda gösterilenler

Ürün ekibinin kaydı, MCP istemcisi olarak Cursor'ı kullanarak tüm akışı beş adımda gösteriyor:

1. 1
   Oturum aç

   BroadNet hesabınızla BroadAdmin portalına giriş yapın.

2. 2
   Anahtar ve konfigürasyonu alın

   Açık Entegrasyonlar → MCP Entegrasyonu, geçici bir anahtar oluşturun ve hazır istemci yapılandırmasını kopyalayın.

3. 3
   Sunucuyu istemciye ekleyin

   MCP istemcisinde yeni bir MCP sunucusu ekleyin ve yapılandırmayı mcp.json dosyasına yapıştırın — Bearer başlığı ile https://mcp.broadnet.me/mcp URL'si.

4. 4
   Araçları inceleyin

   Müşteri bağlantı kurar ve her biri açılıp kapatılabilen BroadNet araçlarını listeler.

5. 5
   Düz bir dille sorun

   Kullanıcı, ajandan bir numaraya WhatsApp mesajı göndermesini ister. Ajan WhatsApp gönderim aracını seçer, API mesajın kabul edildiğini belirten HTTP 200 yanıtını verir ve mesaj işletme hesabından WhatsApp olarak ulaşır.

Kayıtta müşteri 380 adet BroadNet aracından bahsetmektedir; bunlar arasında send_message, post_sms_send, post_whatsapp_message_send, get_whatsapp_template_list, post_whatsapp_template_send, post_rcs_message_send, post_telegram_message_send, post_instagram_message_send, post_messenger_message_send, post_push_message_send ve get_report_delivery yer almaktadır. Tam liste sunucu sürümüne ve hesabınıza bağlıdır.

Aynı kaydın seslendirilmiş bir versiyonu bir özet kartı ekler: tek bir MCP uç noktası ve her temsilci için aynı kopyala-yapıştır adımları.

Güvenlik notları

• Token bir gönderim kimlik bilgisidir

  Buna sahip olan herkes hesabınızdan mesaj gönderebilir. Bir şifre gibi saklayın, asla paylaşılan veya commit edilen bir dosyada tutmayın.

• Deneyler için geçici anahtarları tercih edin

  Denemeler yaparken geçici bir anahtar kullanın; yalnızca üretim ajanı için kalıcı bir anahtar talep etmek üzere hesap yöneticinizle görüşün.

• Sadece ihtiyacınız olan araçları etkinleştirin

  MCP müşterileri, bireysel araçları kapatmanıza olanak tanır. Sadece SMS gönderen bir ajan; şablon, katılım (onboarding) veya hesap araçlarına ihtiyaç duymaz.

• Sürece bir insan dahil edin

  Ajanlar doğal dildeki talimatlara göre hareket eder. Özellikle çok sayıda alıcıya mesaj gönderen araçlardan önce, istemcinin onay istemesini sağlayın.

• Sızdırılan bir belirteci iptal edin

  Bir token ifşa olursa, iptal etmek ve yenisini oluşturmak için hesap yöneticinizle veya BroadNet destek ekibiyle iletişime geçin.

İlgili

Sorular