Sinch Engage / MessageMedia MCP server

ทางการ

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

คุณทำอะไรได้บ้างด้วย Sinch Engage MessageMedia MCP?

  • ส่งข้อความ SMS — ขอให้ผู้ช่วยของคุณส่ง SMS ไปยังหมายเลขโทรศัพท์มือถือใดๆ ในรูปแบบ E.164 ผ่านทาง sendMessage
  • สร้างรายงานข้อความ — ขอรายงานโดยละเอียดหรือสรุปของข้อความที่ส่ง/รับในช่วงวันที่ที่กำหนดโดยใช้ getDetailedMessageReport หรือ getSummaryMessageReport
  • จัดการกลุ่มผู้ติดต่อ — สร้าง ดู หรือลบกลุ่มผู้ติดต่อ (รายการ) ด้วย createContactGroup, getContactGroups หรือ deleteContactGroup
  • ค้นหาและอัปเดตผู้ติดต่อ — ค้นหาผู้ติดต่อตามกลุ่ม เบอร์โทรศัพท์ หรือชื่อ จากนั้นอัปเดตรายละเอียดผ่านทาง getContactWithSearch และ updateContact
  • ติดตามสถานะรายงานแบบไม่พร้อมกัน — ตรวจสอบความคืบหน้าของคำขอรายงานแบบไม่พร้อมกันโดยใช้ getAsyncReportStatus พร้อมกับ ID รายงาน

เอกสาร

เซิร์ฟเวอร์ Sinch Engage MCP

ประกาศการเลิกใช้งาน. เซิร์ฟเวอร์ MCP นี้ถูกเลิกใช้งานแล้วและจะสิ้นสุดการรองรับในวันที่ 30 พฤศจิกายน 2026 ห้ามใช้สำหรับการเชื่อมต่อใหม่ โปรดปฏิบัติตาม เชื่อมต่อกับ Sinch Engage MCP (AU) สำหรับเซิร์ฟเวอร์ทดแทน แพ็กเกจและพื้นที่เก็บข้อมูลนี้ถูกเก็บไว้สำหรับการติดตั้งที่มีอยู่จนถึงวันที่ดังกล่าว และไม่มีแผนพัฒนาฟีเจอร์เพิ่มเติม

Latest Release

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

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

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

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

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

การรายงาน

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

ผู้ติดต่อ

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

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

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

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

ข้อมูลประจำตัว API

ในการใช้ APIs ที่ใช้โดยเครื่องมือ MCP คุณจะต้องมีข้อมูลประจำตัวดังต่อไปนี้:

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

เซิร์ฟเวอร์ Sinch Engage MCP พร้อมใช้งานเป็นแพ็กเกจ 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: ติดตั้ง dependencies

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 เพื่อเลือกเฉพาะเครื่องมือที่สามารถอ่าน เขียน หรือลบข้อมูล หรือการรวมกันใด ๆ ของสิทธิ์เหล่านี้