Hubungkan agen AI ke BroadNet dengan MCP.

Apa itu server MCP

Model Context Protocol (MCP) adalah standar terbuka yang memungkinkan asisten AI menemukan dan memanggil alat eksternal. Server BroadNet MCP adalah server MCP jarak jauh: klien Anda terhubung ke server tersebut melalui HTTPS, mencantumkan alat yang ditawarkan, dan memanggilnya atas nama Anda.

Alat-alat ini memetakan ke BroadNet API yang sama yang didokumentasikan dalam referensi API dan spesifikasi OpenAPI — mengirim pesan, bekerja dengan templat WhatsApp, dan membaca laporan pengiriman. Agen bertindak dengan izin token yang Anda berikan, persis seperti kode Anda sendiri.

Dua server MCP: pengetahuan dan perpesanan

BroadNet menjalankan dua server MCP. Server perpesanan yang dijelaskan di halaman ini beroperasi pada akun Anda. Server pengetahuan bersifat publik: seorang agen dapat menanyakannya tentang cakupan BroadNet, aturan sender ID, harga daftar yang diterbitkan, regulasi, dan fakta perusahaan tanpa login.

Coba server pengetahuan dari terminal: lakukan handshake inisialisasi, lalu pemanggilan alat.

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"}}}'

Endpoint dan autentikasi

Terdapat satu endpoint untuk setiap akun: https://mcp.broadnet.me/mcp. Setiap permintaan harus menyertakan token BroadNet Anda dalam header Authorization.

Anda mendapatkan token dari akun BroadNet Anda. Dalam demo, token dihasilkan di portal BroadAdmin di bawah Integrations → MCP Integration dengan “Get temporary key”; portal tersebut mencatat bahwa kunci permanen diterbitkan oleh admin akun atau master account Anda.

Permintaan tanpa header akan ditolak pada level protokol — ini adalah balasan aktual server terhadap panggilan inisialisasi yang tidak terautentikasi:

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."}}

Hubungkan klien MCP

Sebagian besar klien MCP menggunakan konfigurasi JSON dengan URL server dan header permintaan. Contoh entri tipikal adalah sebagai berikut:

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

Untuk menguji koneksi tanpa klien, kirimkan permintaan inisialisasi MCP Anda sendiri:

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"}}}'

Apa yang ditampilkan demo

Rekaman tim produk menjelaskan seluruh alur dalam lima langkah, menggunakan Cursor sebagai klien MCP:

1. 1
   Masuk

   Masuk ke portal BroadAdmin dengan akun BroadNet Anda.

2. 2
   Dapatkan kunci dan konfigurasinya

   Integrasi Terbuka → Integrasi MCP, buat kunci sementara dan salin konfigurasi klien yang sudah siap.

3. 3
   Tambahkan server ke klien

   Pada klien MCP, tambahkan server MCP baru dan tempelkan konfigurasi ke mcp.json — URL https://mcp.broadnet.me/mcp dengan header Bearer.

4. 4
   Tinjau alat

   Klien terhubung dan menampilkan alat BroadNet, yang masing-masing dapat diaktifkan atau dinonaktifkan.

5. 5
   Tanyakan dalam bahasa sehari-hari

   Pengguna meminta agen untuk mengirimkan pesan WhatsApp ke sebuah nomor. Agen memilih alat pengiriman WhatsApp, API menjawab HTTP 200 dengan pesan diterima, dan pesan tiba di WhatsApp dari akun bisnis.

Dalam catatan tersebut, klien melaporkan 380 alat BroadNet, di antaranya adalah 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 dan get_report_delivery. Daftar tepatnya bergantung pada versi server dan akun Anda.

Versi narasi dari rekaman yang sama menambahkan kartu ringkasan: satu endpoint MCP, langkah salin-tempel yang sama untuk setiap agen.

Catatan keamanan

• Token adalah kredensial pengiriman

  Siapa pun yang memegangnya dapat mengirim pesan dari akun Anda. Simpan seperti kata sandi, jangan pernah di dalam file bersama atau file yang dikomit.

• Lebih menyukai kunci sementara untuk eksperimen

  Gunakan kunci sementara saat Anda melakukan uji coba, dan mintalah kunci permanen kepada admin akun Anda hanya untuk agen produksi.

• Aktifkan hanya alat yang Anda butuhkan

  Klien MCP memungkinkan Anda menonaktifkan alat individual. Agen yang hanya mengirim SMS tidak memerlukan template, onboarding, atau alat akun.

• Libatkan manusia dalam proses

  Agen bertindak berdasarkan instruksi bahasa alami. Pastikan klien meminta konfirmasi sebelum menggunakan alat yang mengirimkan pesan, terutama ke banyak penerima.

• Cabut token yang bocor

  Jika token terekspos, hubungi admin akun Anda atau dukungan BroadNet untuk mencabutnya dan menerbitkan yang baru.

Terkait

Pertanyaan