MCP

engagelab-sms-mcp adalah server MCP (Model Context Protocol) yang memungkinkan AI assistant mengirim SMS melalui platform EngageLab. Setelah menambahkan server ini ke klien yang mendukung MCP (seperti Cursor, Claude Desktop, dll.), AI dapat melakukan operasi pengiriman SMS berbasis template untuk Anda.

Prasyarat

Node.js 18+
Memiliki akun EngageLab, dan sudah mendapatkan kredensial SMS API (dev_key dan dev_secret)
Memiliki setidaknya satu template SMS yang sudah lolos peninjauan

Tips: Kredensial API dapat dibuat dan dikelola di halaman API Key pada konsol EngageLab.

Cara Konfigurasi

Cursor

Masuk ke Settings > MCP, klik Add new MCP server, lalu tempel konfigurasi berikut:

{ "mcpServers": { "engagelab-sms": { "command": "npx", "args": ["-y", "engagelab-sms-mcp"], "env": { "ENGAGELAB_DEV_KEY": "<your_dev_key>", "ENGAGELAB_DEV_SECRET": "<your_dev_secret>" } } } }

              
              {
  "mcpServers": {
    "engagelab-sms": {
      "command": "npx",
      "args": ["-y", "engagelab-sms-mcp"],
      "env": {
        "ENGAGELAB_DEV_KEY": "<your_dev_key>",
        "ENGAGELAB_DEV_SECRET": "<your_dev_secret>"
      }
    }
  }
}

Tampilkan blok kode ini di jendela mengambang

Ganti <your_dev_key> dan <your_dev_secret> dengan kredensial aktual yang Anda dapatkan di konsol EngageLab.

Claude Desktop

Buka Settings > Developer > Edit Config, lalu tambahkan pada mcpServers:

{ "mcpServers": { "engagelab-sms": { "command": "npx", "args": ["-y", "engagelab-sms-mcp"], "env": { "ENGAGELAB_DEV_KEY": "<your_dev_key>", "ENGAGELAB_DEV_SECRET": "<your_dev_secret>" } } } }

              
              {
  "mcpServers": {
    "engagelab-sms": {
      "command": "npx",
      "args": ["-y", "engagelab-sms-mcp"],
      "env": {
        "ENGAGELAB_DEV_KEY": "<your_dev_key>",
        "ENGAGELAB_DEV_SECRET": "<your_dev_secret>"
      }
    }
  }
}

Tampilkan blok kode ini di jendela mengambang

Klien MCP Lainnya

Klien MCP apa pun yang mendukung metode transport stdio dapat menggunakan server ini. Atur perintah startup menjadi npx -y engagelab-sms-mcp, dan teruskan environment variable yang diperlukan.

Tool yang Tersedia

send_sms

Mengirim SMS melalui EngageLab menggunakan template yang sudah lolos peninjauan.

Parameter Request:

Field	Tipe	Wajib	Penjelasan
to	string[]	Ya	Daftar nomor ponsel tujuan, disarankan menggunakan format internasional (seperti `+6581234567`)
template.id	string	Ya	ID template SMS EngageLab yang sudah lolos peninjauan
template.params	object	Ya	Nilai variabel template, seperti `{"code": "123456"}`

Contoh Request:

{ "to": ["+6581234567"], "template": { "id": "your-template-id", "params": { "code": "123456" } } }

              
              {
  "to": ["+6581234567"],
  "template": {
    "id": "your-template-id",
    "params": {
      "code": "123456"
    }
  }
}

Tampilkan blok kode ini di jendela mengambang

Parameter Response:

Field	Tipe	Penjelasan
success	boolean	Apakah request diterima
plan_id	string	ID plan EngageLab, untuk pelacakan
total_count	number	Total penerima yang diajukan
accepted_count	number	Jumlah penerima yang diterima untuk pengiriman
message_id	string	Identifier pesan (jika ada)
message	string	Deskripsi status atau error
code	number	Response code EngageLab (0 berarti sukses)

Environment Variable

Variabel	Wajib	Nilai Default	Penjelasan
ENGAGELAB_DEV_KEY	Ya	—	EngageLab dev key
ENGAGELAB_DEV_SECRET	Ya	—	EngageLab dev secret
ENGAGELAB_BASE_URL	Tidak	`https://smsapi.engagelab.com`	Base URL API
ENGAGELAB_REQUEST_TIMEOUT_MS	Tidak	`10000`	Waktu timeout request (milidetik)
ENGAGELAB_MAX_RETRIES	Tidak	`1`	Jumlah maksimum percobaan ulang saat gagal

Pertanyaan Umum

Server gagal dijalankan, muncul pesan "Missing required environment variable"

Harap pastikan ENGAGELAB_DEV_KEY dan ENGAGELAB_DEV_SECRET telah diisi dengan benar pada env di konfigurasi klien MCP.

send_sms mengembalikan kode error 3002 ("invalid template id format")

Harap periksa apakah ID template sesuai dengan template yang sudah lolos peninjauan di konsol EngageLab.

send_sms mengembalikan error terkait parameter template

Harap pastikan nama key pada template.params sepenuhnya cocok dengan nama variabel yang didefinisikan dalam template EngageLab.

SMS tidak diterima

Harap gunakan format nomor telepon internasional (seperti +6581234567).
Pastikan template sudah lolos peninjauan dan tidak dinonaktifkan.