Sinch Engage / MessageMedia MCP server

Sinch Engage MCP Server

ที่เก็บนี้มีซอร์สโค้ดสำหรับเซิร์ฟเวอร์ MCP ของ Sinch Engage (Sinch MessageMedia ในออสเตรเลีย) ซึ่งให้บริการ API ของ Sinch Engage ในรูปแบบเครื่องมือ MCP

ภาพรวมเครื่องมือ

นี่คือรายการเครื่องมือที่มีในเซิร์ฟเวอร์ MCP (หมายเลขโทรศัพท์ทั้งหมดต้องระบุในรูปแบบ E.164 เช่น +61400000000 สำหรับออสเตรเลีย)

การส่งข้อความ

เครื่องมือ	คำอธิบาย	หมวดหมู่	โหมด
sendMessage	ส่ง SMS ไปยังหมายเลขโทรศัพท์มือถือ	messaging	write

การรายงาน

เครื่องมือ	คำอธิบาย	หมวดหมู่	โหมด
getDetailedMessageReport	สร้างรายงานโดยละเอียดของข้อความที่ส่งและรับในช่วงวันที่ที่ระบุ พร้อมตัวกรองเสริมสำหรับทิศทาง บัญชี ข้อมูลเมตา และการจัดกลุ่ม	reporting	read
getSummaryMessageReport	สร้างรายงานสรุปของข้อความที่ส่งและรับในช่วงวันที่ที่ระบุ พร้อมตัวกรองเสริมสำหรับทิศทาง บัญชี และการจัดกลุ่ม	reporting	read
getSummaryInsightMessageReport	ดึงรายงานสรุปที่รวบรวมไว้ล่วงหน้าของข้อความที่ส่งและรับในช่วงวันที่ที่ระบุ พร้อมตัวกรองเสริมสำหรับทิศทาง บัญชี และการจัดกลุ่ม	reporting	read
getAsyncReportStatus	ดึงสถานะของคำขอรายงานแบบอะซิงโครนัสโดยใช้ report_id	reporting	read
getAsyncReportFields	ดึงรายการฟิลด์ที่พร้อมใช้งานสำหรับการส่งออกรายงานโดยละเอียดแบบอะซิงโครนัส	reporting	read
requestAsyncDetailedMessageReport	ขอรายงานโดยละเอียดแบบอะซิงโครนัสของข้อความที่ส่งและรับในช่วงวันที่ที่ระบุ พร้อมตัวเลือกการจัดส่งสำหรับรูปแบบรายงานและปลายทาง	reporting	read

ผู้ติดต่อ

เครื่องมือ	คำอธิบาย	หมวดหมู่	โหมด
getContactGroups	ดึงรายการกลุ่มผู้ติดต่อ (รายการ) ที่แบ่งหน้า ซึ่งเชื่อมโยงกับบัญชี	reporting	read
getContactGroupDetails	ดึงรายละเอียดสำหรับกลุ่มผู้ติดต่อ (รายการ) เฉพาะที่ระบุโดย group_id	reporting	read
getContactWithSearch	ดึงรายการผู้ติดต่อ กรองได้ตามกลุ่ม หมายเลขโทรศัพท์ ชื่อ และประเภทช่องทาง	reporting	read
createContactGroup	สร้างกลุ่มผู้ติดต่อ (รายการ) ใหม่ด้วยชื่อที่ระบุและนามแฝงเสริม	reporting	write
createContact	สร้างผู้ติดต่อใหม่ด้วยรายละเอียดที่ระบุ	reporting	write
updateContact	อัปเดตผู้ติดต่อที่มีอยู่ซึ่งระบุโดย contact_id ด้วยรายละเอียดใหม่	reporting	write
deleteContactGroup	ลบกลุ่มผู้ติดต่อ (รายการ) เฉพาะที่ระบุโดย group_id	reporting	delete

เริ่มต้นใช้งาน

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

• Node.js >= 16.0
• บัญชี Sinch Engage ที่เตรียมไว้
• Claude Desktop (หรือไคลเอนต์ MCP อื่นๆ) README นี้เน้นที่ Claude Desktop แต่เซิร์ฟเวอร์ MCP สามารถใช้กับไคลเอนต์ MCP ใดก็ได้

ข้อมูลรับรอง API

ในการใช้ API ที่เครื่องมือ MCP ใช้ คุณจะต้องมีข้อมูลรับรองต่อไปนี้:

• SINCH_ENGAGE_API_KEY และ SINCH_ENGAGE_API_SECRET ข้อมูลรับรอง Sinch Engage

การกำหนดค่าเซิร์ฟเวอร์ MCP

เซิร์ฟเวอร์ MCP ของ Sinch Engage พร้อมใช้งานเป็นแพ็คเกจ NPM สำหรับการดำเนินการ นี่คือวิธีการตั้งค่าในไฟล์การกำหนดค่า Claude Desktop (claude_desktop_config.json) อย่าลืมกรอกตัวแปรสภาพแวดล้อมด้วยข้อมูลรับรองของคุณเองและภูมิภาค (ปัจจุบันรองรับ EU และ AU):

{
  "mcpServers": {
    "Sinch Engage": {
      "command": "npx",
      "args": [
        "-y",
        "@sinch-engage/mcp-server"
      ],
      "env": {
        "SINCH_ENGAGE_API_KEY": "<your-key>",
        "SINCH_ENGAGE_API_SECRET": "<your-secret>",
        "SINCH_ENGAGE_REGION": "<region>",
        "MCP_TOOL_CATEGORIES": "reporting, contacts, messaging",
        "MCP_TOOL_MODES": "read, write, delete"
      }
    }
  }
}

การรันเซิร์ฟเวอร์ MCP ในเครื่อง

ตัวเลือกที่ 1: เริ่มเซิร์ฟเวอร์ MCP ด้วย stdio โดยใช้ Claude Desktop

ในการรันเซิร์ฟเวอร์ MCP ในเครื่องด้วย Claude Desktop คุณจะต้องโคลนที่เก็บและสร้างเซิร์ฟเวอร์ MCP ตัวเลือกนี้มีประโยชน์สำหรับการพัฒนาและทดสอบในเครื่อง

ขั้นตอนที่ 1: โคลนที่เก็บ

git clone https://github.com/messagemedia/sinch-engage-mcp-server.git

ขั้นตอนที่ 2: ติดตั้งการพึ่งพา

cd sinch-engage-mcp-server
npm install

ขั้นตอนที่ 3: ตั้งค่าการกำหนดค่า Claude Desktop

นี่คือตัวอย่างวิธีการกำหนดค่าเซิร์ฟเวอร์ MCP ในไฟล์การกำหนดค่า Claude Desktop (claude_desktop_config.json) ซึ่งคุณสามารถระบุข้อมูลรับรอง Sinch Engage และภูมิภาคของคุณ (EU หรือ AU):

{
  "mcpServers": {
    "Sinch Engage": {
      "command": "node",
      "args": ["/path/to/sinch-engage-mcp-server/src/index.js"],
      "env": {
        "SINCH_ENGAGE_API_KEY": "<your-key>",
        "SINCH_ENGAGE_API_SECRET": "<your-secret>",
        "SINCH_ENGAGE_REGION": "<region>",
        "MCP_TOOL_CATEGORIES": "reporting, contacts, messaging",
        "MCP_TOOL_MODES": "read, write, delete"
      }
    }
  }
}

ขั้นตอนที่ 4: (ไม่บังคับ) กรองเครื่องมือที่มีในเซิร์ฟเวอร์ MCP

เครื่องมือมากเกินไปหมายถึงบริบทที่ใหญ่ขึ้น หมายถึงการใช้โทเค็นที่สูงขึ้นและความสับสนมากขึ้นสำหรับ LLM ในการเลือกเครื่องมือที่เหมาะสมที่จะใช้
คุณสามารถกรองเครื่องมือที่มีในเซิร์ฟเวอร์ MCP ได้โดยระบุ MCP_TOOL_CATEGORIES ในตัวเลือกการกำหนดค่า Claude Desktop

หากคุณต้องการกรองเครื่องมือตามสิทธิ์ คุณสามารถใช้ MCP_TOOL_MODES เพื่อเลือกเฉพาะเครื่องมือที่สามารถอ่าน เขียน หรือลบข้อมูล หรือการรวมกันของสิ่งเหล่านี้