Sinch Engage / MessageMedia MCP server
chính thứcMáy chủ MCP Sinch Engage (Sinch MessageMedia tại Úc), cung cấp các API Sinch Engage dưới dạng công cụ MCP.
Bạn có thể làm gì với Sinch Engage MessageMedia MCP?
- Gửi tin nhắn SMS — Yêu cầu trợ lý của bạn gửi SMS đến bất kỳ số điện thoại di động nào theo định dạng E.164 qua
sendMessage. - Tạo báo cáo tin nhắn — Yêu cầu báo cáo chi tiết hoặc tóm tắt về các tin nhắn đã gửi/nhận trong một khoảng thời gian bằng
getDetailedMessageReporthoặcgetSummaryMessageReport. - Quản lý nhóm liên hệ — Tạo, xem hoặc xóa các nhóm liên hệ (danh sách) bằng
createContactGroup,getContactGroupshoặcdeleteContactGroup. - Tìm kiếm và cập nhật liên hệ — Tìm liên hệ theo nhóm, số điện thoại hoặc tên, sau đó cập nhật thông tin của họ qua
getContactWithSearchvàupdateContact. - Theo dõi trạng thái báo cáo không đồng bộ — Kiểm tra tiến trình của các yêu cầu báo cáo không đồng bộ bằng
getAsyncReportStatusvới ID báo cáo.
Tài liệu
Máy chủ MCP Sinch Engage
Thông báo ngừng hỗ trợ. Máy chủ MCP này đã bị ngừng hỗ trợ và sẽ chấm dứt vòng đời vào ngày 30 tháng 11 năm 2026. Không sử dụng nó cho các tích hợp mới. Hãy làm theo Kết nối với MCP Sinch Engage (AU) để biết máy chủ thay thế. Gói và kho lưu trữ này được giữ lại cho các cài đặt hiện có cho đến ngày đó và không có công việc tính năng nào tiếp theo được lên kế hoạch.
Kho lưu trữ này chứa mã nguồn cho máy chủ MCP Sinch Engage (Sinch MessageMedia tại AU), cung cấp các API Sinch Engage dưới dạng công cụ MCP.
Tổng quan về các công cụ
Dưới đây là danh sách các công cụ có sẵn trong máy chủ MCP (tất cả các số điện thoại phải được cung cấp ở định dạng E.164, ví dụ: +61400000000 cho Úc).
Nhắn tin
| Công cụ | Mô tả | Danh mục | Chế độ |
|---|---|---|---|
| sendMessage | Gửi SMS đến một số điện thoại di động | messaging | write |
Báo cáo
| Công cụ | Mô tả | Danh mục | Chế độ |
|---|---|---|---|
| getDetailedMessageReport | Tạo báo cáo chi tiết về các tin nhắn đã gửi và đã nhận trong một phạm vi ngày cụ thể, với các bộ lọc tùy chọn cho hướng, tài khoản, siêu dữ liệu và nhóm. | reporting | read |
| getSummaryMessageReport | Tạo báo cáo tóm tắt về các tin nhắn đã gửi và đã nhận trong một phạm vi ngày cụ thể, với các bộ lọc tùy chọn cho hướng, tài khoản và nhóm. | reporting | read |
| getSummaryInsightMessageReport | Lấy báo cáo tóm tắt được biên soạn sẵn về các tin nhắn đã gửi và đã nhận trong một phạm vi ngày cụ thể, với các bộ lọc tùy chọn cho hướng, tài khoản và nhóm. | reporting | read |
| getAsyncReportStatus | Truy xuất trạng thái của một yêu cầu báo cáo không đồng bộ theo report_id. | reporting | read |
| getAsyncReportFields | Truy xuất danh sách các trường có sẵn để xuất báo cáo chi tiết không đồng bộ. | reporting | read |
| requestAsyncDetailedMessageReport | Yêu cầu báo cáo chi tiết không đồng bộ về các tin nhắn đã gửi và đã nhận trong một phạm vi ngày cụ thể, với các tùy chọn phân phối cho định dạng báo cáo và đích đến. | reporting | read |
Danh bạ
| Công cụ | Mô tả | Danh mục | Chế độ |
|---|---|---|---|
| getContactGroups | Truy xuất danh sách phân trang các nhóm danh bạ (danh sách) liên kết với tài khoản. | reporting | read |
| getContactGroupDetails | Truy xuất chi tiết cho một nhóm danh bạ (danh sách) cụ thể được xác định bởi group_id. | reporting | read |
| getContactWithSearch | Truy xuất danh sách danh bạ, có thể lọc theo nhóm, số điện thoại, tên và loại kênh. | reporting | read |
| createContactGroup | Tạo một nhóm danh bạ (danh sách) mới với tên được chỉ định và bí danh tùy chọn. | reporting | write |
| createContact | Tạo một danh bạ mới với các chi tiết được chỉ định. | reporting | write |
| updateContact | Cập nhật một danh bạ hiện có được xác định bởi contact_id với các chi tiết mới. | reporting | write |
| deleteContactGroup | Xóa một nhóm danh bạ (danh sách) cụ thể được xác định bởi group_id. | reporting | delete |
Bắt đầu
Điều kiện tiên quyết
- Node.js >= 16.0
- Một tài khoản Sinch Engage đã được cấp phát
- Claude Desktop (hoặc bất kỳ máy khách MCP nào khác). README này tập trung vào Claude Desktop, nhưng máy chủ MCP có thể được sử dụng với bất kỳ máy khách MCP nào.
Thông tin xác thực API
Để sử dụng các API được sử dụng bởi các công cụ MCP, bạn sẽ cần các thông tin xác thực sau:
SINCH_ENGAGE_API_KEYvàSINCH_ENGAGE_API_SECRETThông tin xác thực Sinch Engage
Cấu hình máy chủ MCP
Máy chủ MCP Sinch Engage có sẵn dưới dạng gói NPM để thực thi. Dưới đây là cách thiết lập nó trong tệp cấu hình Claude Desktop (claude_desktop_config.json). Hãy nhớ điền các biến môi trường bằng thông tin xác thực của riêng bạn và khu vực (hiện được hỗ trợ 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"
}
}
}
}
Chạy máy chủ MCP cục bộ
Tùy chọn 1: Khởi động máy chủ MCP với stdio bằng Claude Desktop
Để chạy máy chủ MCP cục bộ với Claude Desktop, bạn sẽ cần sao chép kho lưu trữ và xây dựng máy chủ MCP. Tùy chọn này hữu ích cho việc phát triển và thử nghiệm cục bộ.
Bước 1: Sao chép kho lưu trữ
git clone https://github.com/messagemedia/sinch-engage-mcp-server.git
Bước 2: Cài đặt các phụ thuộc
cd sinch-engage-mcp-server
npm install
Bước 3: Thiết lập cấu hình Claude Desktop
Dưới đây là ví dụ về cách cấu hình máy chủ MCP trong tệp cấu hình Claude Desktop (claude_desktop_config.json) nơi bạn có thể cung cấp thông tin xác thực Sinch Engage và khu vực (EU hoặc 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"
}
}
}
}
Bước 4: (Tùy chọn) Lọc các công cụ có sẵn trong máy chủ MCP
Quá nhiều công cụ có nghĩa là ngữ cảnh lớn hơn, nghĩa là sử dụng nhiều token hơn và gây nhầm lẫn hơn cho LLM khi chọn đúng công cụ để sử dụng.
Bạn có thể lọc các công cụ có sẵn trong máy chủ MCP bằng cách cung cấp MCP_TOOL_CATEGORIES trong các tùy chọn cấu hình Claude Desktop.
Nếu bạn muốn lọc công cụ theo quyền, bạn có thể sử dụng MCP_TOOL_MODES để chỉ chọn các công cụ có thể đọc, ghi hoặc xóa dữ liệu hoặc bất kỳ sự kết hợp nào của chúng