# Hubungkan agen AI ke BroadNet dengan MCP. - URL kanonis: https://www.broadnet.me/id/developers/mcp - Bahasa: id - Terakhir diperbarui: 2026-10-21 - Penerbit: BroadNet (https://www.broadnet.me) - Versi Markdown dari halaman di atas, dibuat dari halaman yang dirender. Model Context Protocol· /developers/mcp Server BroadNet MCP menyediakan BroadNet messaging API sebagai alat yang dapat dipanggil oleh agen AI. Arahkan klien MCP apa pun yang mendukung server jarak jauh ke satu endpoint, autentikasi dengan token BroadNet Anda, dan agen dapat mengirim serta melacak pesan pada akun Anda. **Endpoint** https://mcp.broadnet.me/mcp **Transportasi** MCP Streamable HTTP **Autentikasi** Authorization: Bearer **Saluran** WhatsApp, SMS, RCS, Telegram, Push, Email, Messenger, Instagram ## 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. Server pengetahuan (publik) Jawaban read-only dari data yang sama dengan situs web ini. Tanpa akun, tanpa token, tanpa data pribadi. **Endpoint** https://www.broadnet.me/mcp **Autentikasi** Tidak ada **Akses** Hanya baca **Alat** search_site, get_facts, check_coverage, sender_id_rules, estimate_price, count_sms_segments, get_regulation, list_answers, get_answer, list_case_studies, get_case_study, get_changelog, get_status **Batas laju** 60 permintaan per menit per IP Server perpesanan (akun Anda) Mengirim dan melacak pesan dengan izin dari token BroadNet Anda. **Endpoint** https://mcp.broadnet.me/mcp **Autentikasi** Authorization: Bearer **Akses** Bertindak pada akun Anda Coba server pengetahuan dari terminal: lakukan handshake inisialisasi, lalu pemanggilan alat. inisialisasi (server pengetahuan) ``` 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"}}}' ``` tools/call (server pengetahuan) ``` 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"}}}' ``` Server pengetahuan menggunakan MCP 2026-07-28 (metadata per-permintaan, server/discover) dan revisi berbasis inisialisasi sebelumnya hingga 2024-11-05. Harga yang ditampilkan adalah tarif daftar indikatif, bukan penawaran; jawaban regulasi adalah panduan perencanaan, bukan nasihat hukum. ## 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: respons tanpa token ``` event: message data: {"jsonrpc":"2.0","id":1,"error":{"code":-32001, "message":"Authorization bearer token is required. Connect with an 'Authorization: Bearer ' header."}} ``` ## Hubungkan klien MCP Sebagian besar klien MCP menggunakan konfigurasi JSON dengan URL server dan header permintaan. Contoh entri tipikal adalah sebagai berikut: mcp.json ``` { "mcpServers": { "broadnet": { "type": "http", "url": "https://mcp.broadnet.me/mcp", "headers": { "Authorization": "Bearer ${BROADNET_TOKEN}" } } } } ``` Nama field sedikit bervariasi di antara klien (beberapa mengharapkan tipe "http" atau "streamable-http", beberapa membaca header dari pengaturan terpisah). Periksa dokumentasi MCP klien Anda, dan jangan sertakan token dalam file yang Anda commit — gunakan dukungan environment-variable klien Anda jika tersedia. Untuk menguji koneksi tanpa klien, kirimkan permintaan inisialisasi MCP Anda sendiri: inisialisasi handshake ``` 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. Rekaman demo (1 menit 10 detik, tanpa suara): masuk ke BroadAdmin, hubungkan Cursor ke server MCP BroadNet, dan kirim pesan WhatsApp dalam bahasa sehari-hari. Versi narasi (1 menit 20 detik, dengan voice-over) dari alur yang sama, dengan kartu ringkasan di bagian awal. ## 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 [Referensi API Endpoint REST di balik alat MCP, dengan Bearer auth.](https://www.broadnet.me/developers/api) [Spesifikasi OpenAPI 3.1 Deskripsi API lengkap yang dapat dibaca mesin.](https://www.broadnet.me/developers/openapi.yaml) [Mulai Cepat Kirim SMS pertama Anda dengan curl atau TypeScript SDK.](https://www.broadnet.me/id/developers/quickstart) [Panduan: agen AI yang aman Bagaimana agen mengirim SMS dan WhatsApp melalui MCP, serta batasan yang harus ditetapkan terlebih dahulu.](https://www.broadnet.me/id/blog/mcp-server-sms-whatsapp-ai-agents) ## Pertanyaan ### Apa URL server BroadNet MCP? https://mcp.broadnet.me/mcp. It uses the MCP Streamable HTTP transport and requires an Authorization: Bearer header with your BroadNet token. ### Klien AI mana yang dapat terhubung? Setiap klien MCP yang dapat terhubung ke server jarak jauh melalui Streamable HTTP dan mengirimkan header Authorization kustom. Rekaman demo menggunakan Cursor. ### Di mana saya mendapatkan tokennya? Dari akun BroadNet Anda. Di portal BroadAdmin, Integrations → MCP Integration akan menerbitkan kunci sementara; kunci permanen diperoleh dari admin akun atau akun utama Anda. ### Dapatkah agen mengirim pesan sungguhan? Ya. Dalam rekaman demo, pengiriman WhatsApp agen mengembalikan HTTP 200 dan pesan tiba di ponsel. Alat-alat ini bekerja dengan izin token Anda, persis seperti panggilan API Anda sendiri, jadi perlakukan setiap pengiriman sebagai pengiriman nyata: aktifkan hanya alat yang dibutuhkan agen dan wajibkan konfirmasi untuk pengiriman. ## Bangun dengan BroadNet Dapatkan akun dan token, lalu hubungkan agen Anda atau hubungi API secara langsung. [Hubungi kami](https://www.broadnet.me/id/contact) [Pusat pengembang](https://www.broadnet.me/id/developers)