MCP

engagelab-sms-mcp เป็นเซิร์ฟเวอร์ MCP (Model Context Protocol) ที่ช่วยให้ผู้ช่วย AI ส่งข้อความ SMS ผ่านแพลตฟอร์ม EngageLab ได้ เมื่อเพิ่มเข้าไปในไคลเอนต์ที่รองรับ MCP (เช่น Cursor, Claude Desktop เป็นต้น) AI สามารถส่ง SMS ตามเทมเพลตในนามของคุณได้

ข้อกำหนดเบื้องต้น

Node.js 18+
บัญชี EngageLab พร้อมข้อมูลรับรอง SMS API (dev_key และ dev_secret)
มีเทมเพลต SMS ที่ได้รับอนุมัติแล้วอย่างน้อยหนึ่งรายการ

คำแนะนำ: สามารถสร้างและจัดการข้อมูลรับรอง API ได้ที่หน้า API Keys ในคอนโซล EngageLab

การกำหนดค่า

Cursor

ไปที่ Settings > MCP คลิก Add new MCP server แล้ววางการกำหนดค่าต่อไปนี้:

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

โค้ดนี้โชว์เป็นหน้าต่างลอย

แทนที่ <your_dev_key> และ <your_dev_secret> ด้วยข้อมูลรับรองจริงจากคอนโซล EngageLab

Claude Desktop

เปิด Settings > Developer > Edit Config แล้วเพิ่มสิ่งต่อไปนี้ใน 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>"
      }
    }
  }
}

โค้ดนี้โชว์เป็นหน้าต่างลอย

ไคลเอนต์ MCP อื่นๆ

ไคลเอนต์ MCP ใดๆ ที่รองรับทรานสปอร์ต stdio ก็ใช้เซิร์ฟเวอร์นี้ได้ ตั้งคำสั่งเป็น npx -y engagelab-sms-mcp และส่งตัวแปรสภาพแวดล้อมที่จำเป็น

เครื่องมือที่มี

send_sms

ส่งข้อความ SMS ผ่าน EngageLab โดยใช้เทมเพลตที่อนุมัติแล้ว

พารามิเตอร์คำขอ:

ฟิลด์	ประเภท	จำเป็น	คำอธิบาย
to	string[]	ใช่	รายการหมายเลขโทรศัพท์ปลายทาง (แนะนำรูปแบบสากล เช่น `+8618700001111`)
template.id	string	ใช่	ID เทมเพลต SMS ของ EngageLab ที่ได้รับอนุมัติแล้ว
template.params	object	ใช่	ค่าตัวแปรของเทมเพลต เช่น `{"code": "123456"}`

ตัวอย่างคำขอ:

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

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

โค้ดนี้โชว์เป็นหน้าต่างลอย

พารามิเตอร์การตอบกลับ:

ฟิลด์	ประเภท	คำอธิบาย
success	boolean	ว่าคำขอได้รับการยอมรับหรือไม่
plan_id	string	plan ID ของ EngageLab สำหรับติดตาม
total_count	number	จำนวนผู้รับทั้งหมดที่ส่งคำขอ
accepted_count	number	จำนวนผู้รับที่ยอมรับให้จัดส่ง
message_id	string	ตัวระบุข้อความ (ถ้ามี)
message	string	คำอธิบายสถานะหรือข้อผิดพลาด
code	number	รหัสตอบกลับของ EngageLab (0 = สำเร็จ)

ตัวแปรสภาพแวดล้อม

ตัวแปร	จำเป็น	ค่าเริ่มต้น	คำอธิบาย
ENGAGELAB_DEV_KEY	ใช่	—	dev key ของ EngageLab
ENGAGELAB_DEV_SECRET	ใช่	—	dev secret ของ EngageLab
ENGAGELAB_BASE_URL	ไม่	`https://smsapi.engagelab.com`	URL ฐานของ API
ENGAGELAB_REQUEST_TIMEOUT_MS	ไม่	`10000`	หมดเวลาคำขอเป็นมิลลิวินาที
ENGAGELAB_MAX_RETRIES	ไม่	`1`	จำนวนครั้งสูงสุดในการลองใหม่เมื่อล้มเหลว

การแก้ปัญหา

เซิร์ฟเวอร์เริ่มทำงานไม่สำเร็จพร้อมข้อความ "Missing required environment variable"

ตรวจสอบให้แน่ใจว่าตั้งค่า ENGAGELAB_DEV_KEY และ ENGAGELAB_DEV_SECRET ในบล็อก env ของการกำหนดค่าไคลเอนต์ MCP ถูกต้อง

send_sms คืนค่ารหัสข้อผิดพลาด 3002 ("invalid template id format")

ตรวจสอบว่า ID เทมเพลตตรงกับเทมเพลตที่อนุมัติในคอนโซล EngageLab

send_sms คืนค่าข้อผิดพลาดพารามิเตอร์เทมเพลต

ยืนยันว่าคีย์ใน template.params ตรงกับชื่อตัวแปรที่กำหนดในเทมเพลต EngageLab ของคุณทุกประการ

ไม่ได้รับ SMS

ใช้รูปแบบหมายเลขโทรศัพท์สากล (เช่น +8618700001111)
ยืนยันว่าเทมเพลตได้รับอนุมัติและไม่ถูกระงับ