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 Key ในคอนโซล 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[]	ใช่	รายการหมายเลขโทรศัพท์ปลายทาง แนะนำให้ใช้รูปแบบสากล (เช่น `+6581234567`)
template.id	string	ใช่	ID เทมเพลต SMS ของ EngageLab ที่ผ่านการตรวจสอบแล้ว
template.params	object	ใช่	ค่าของตัวแปรเทมเพลต เช่น `{"code": "123456"}`

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

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

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

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

พารามิเตอร์ที่ส่งกลับ:

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

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

ตัวแปร	จำเป็น	ค่าเริ่มต้น	คำอธิบาย
ENGAGELAB_DEV_KEY	ใช่	—	EngageLab dev key
ENGAGELAB_DEV_SECRET	ใช่	—	EngageLab dev secret
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

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