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) สำหรับเซิร์ฟเวอร์ทดแทน แพ็กเกจและพื้นที่เก็บข้อมูลนี้ถูกเก็บไว้สำหรับการติดตั้งที่มีอยู่จนถึงวันที่ดังกล่าว และไม่มีแผนพัฒนาฟีเจอร์เพิ่มเติม
พื้นที่เก็บข้อมูลนี้มีซอร์สโค้ดสำหรับเซิร์ฟเวอร์ Sinch Engage (Sinch MessageMedia ใน AU) MCP ซึ่งให้บริการ Sinch Engage APIs เป็นเครื่องมือ 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
ในการใช้ APIs ที่ใช้โดยเครื่องมือ MCP คุณจะต้องมีข้อมูลประจำตัวดังต่อไปนี้:
SINCH_ENGAGE_API_KEYและSINCH_ENGAGE_API_SECRETข้อมูลประจำตัว Sinch Engage
การกำหนดค่าเซิร์ฟเวอร์ 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 เพื่อเลือกเฉพาะเครื่องมือที่สามารถอ่าน เขียน หรือลบข้อมูล หรือการรวมกันใด ๆ ของสิทธิ์เหล่านี้