MCP

engagelab-sms-mcp adalah server MCP (Model Context Protocol) yang memungkinkan asisten AI mengirim pesan SMS melalui platform EngageLab. Setelah ditambahkan ke klien yang kompatibel dengan MCP (seperti Cursor, Claude Desktop, dll.), AI dapat mengirim pesan SMS berbasis template atas nama Anda.

Prasyarat

Node.js 18+
Akun EngageLab dengan kredensial SMS API (dev_key dan dev_secret)
Minimal satu template SMS yang telah disetujui

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

Konfigurasi

Cursor

Buka Settings > MCP, klik Add new MCP server, dan tempelkan 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 diperoleh dari konsol EngageLab.

Claude Desktop

Buka Settings > Developer > Edit Config dan tambahkan berikut ini ke 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 transport stdio dapat menggunakan server ini. Atur perintah ke npx -y engagelab-sms-mcp dan berikan variabel lingkungan yang diperlukan.

Alat yang Tersedia

send_sms

Kirim pesan SMS melalui EngageLab menggunakan template yang telah disetujui.

Parameter Permintaan:

Field	Tipe	Wajib	Deskripsi
to	string[]	Ya	Daftar nomor telepon tujuan (format internasional disarankan, mis. `+8618700001111`)
template.id	string	Ya	ID template SMS EngageLab yang telah disetujui
template.params	object	Ya	Nilai variabel template, mis. `{"code": "123456"}`

Contoh Permintaan:

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

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

Tampilkan blok kode ini di jendela mengambang

Parameter Respons:

Field	Tipe	Deskripsi
success	boolean	Apakah permintaan diterima
plan_id	string	ID rencana EngageLab untuk pelacakan
total_count	number	Jumlah total penerima yang dikirim
accepted_count	number	Jumlah penerima yang diterima untuk pengiriman
message_id	string	Pengenal pesan (jika tersedia)
message	string	Deskripsi status atau kesalahan
code	number	Kode respons EngageLab (0 = berhasil)

Variabel Lingkungan

Variabel	Wajib	Default	Deskripsi
ENGAGELAB_DEV_KEY	Ya	—	EngageLab dev key
ENGAGELAB_DEV_SECRET	Ya	—	EngageLab dev secret
ENGAGELAB_BASE_URL	Tidak	`https://smsapi.engagelab.com`	URL dasar API
ENGAGELAB_REQUEST_TIMEOUT_MS	Tidak	`10000`	Batas waktu permintaan dalam milidetik
ENGAGELAB_MAX_RETRIES	Tidak	`1`	Percobaan ulang maksimal untuk kegagalan

Pemecahan Masalah

Server gagal memulai dengan "Missing required environment variable"

Pastikan ENGAGELAB_DEV_KEY dan ENGAGELAB_DEV_SECRET telah diatur dengan benar di blok env pada konfigurasi klien MCP Anda.

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

Verifikasi bahwa ID template cocok dengan template yang telah disetujui di konsol EngageLab.

send_sms mengembalikan kesalahan parameter template

Konfirmasi bahwa kunci di template.params persis cocok dengan nama variabel yang didefinisikan di template EngageLab Anda.

SMS tidak diterima

Gunakan format nomor telepon internasional (mis. +8618700001111).
Konfirmasi bahwa template telah disetujui dan tidak ditangguhkan.