Sinch Engage / MessageMedia MCP server
官方Sinch Engage(在澳洲為 Sinch MessageMedia)MCP 伺服器,提供 Sinch Engage API 作為 MCP 工具。
你可以用 Sinch Engage MessageMedia MCP 做什麼?
- 發送簡訊 — 請您的助理透過
sendMessage傳送簡訊至任何符合 E.164 格式的手機號碼。 - 產生訊息報告 — 使用
getDetailedMessageReport或getSummaryMessageReport,請求指定日期範圍內已傳送/已接收訊息的詳細或摘要報告。 - 管理聯絡人群組 — 使用
createContactGroup、getContactGroups或deleteContactGroup建立、檢視或刪除聯絡人群組(清單)。 - 搜尋與更新聯絡人 — 依群組、電話或姓名尋找聯絡人,然後透過
getContactWithSearch和updateContact更新其詳細資料。 - 追蹤非同步報告狀態 — 使用報告 ID 透過
getAsyncReportStatus檢查非同步報告請求的進度。
文件
Sinch Engage MCP 伺服器
棄用通知。 此 MCP 伺服器已棄用,將於 2026 年 11 月 30 日終止服務。請勿將其用於新的整合。請遵循 Connect to the Sinch Engage MCP (AU) 以取得替代伺服器。此套件與儲存庫將保留至該日期供現有安裝使用,且不再規劃任何功能開發。
此儲存庫包含 Sinch Engage(澳洲地區的 Sinch MessageMedia)MCP 伺服器的原始碼,該伺服器以 MCP 工具的形式提供 Sinch Engage API。
工具總覽
以下是 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 憑證
若要使用 MCP 工具所使用的 API,您需要下列憑證:
SINCH_ENGAGE_API_KEY與SINCH_ENGAGE_API_SECRETSinch 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:使用 Claude Desktop 以 stdio 啟動 MCP 伺服器
若要使用 Claude Desktop 在本機執行 MCP 伺服器,您需要複製儲存庫並建置 MCP 伺服器。此選項適用於本機開發與測試。
步驟 1:複製儲存庫
git clone https://github.com/messagemedia/sinch-engage-mcp-server.git
步驟 2:安裝相依套件
cd sinch-engage-mcp-server
npm install
步驟 3:設定 Claude Desktop 設定
以下為如何在 Claude Desktop 設定檔(claude_desktop_config.json)中設定 MCP 伺服器的範例,您可以在其中提供您的 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 伺服器中可用的工具
工具過多意味著更大的上下文、更高的 token 使用量,以及 LLM 在選擇正確工具時更容易混淆。
您可以透過在 Claude Desktop 設定選項中提供 MCP_TOOL_CATEGORIES 來篩選 MCP 伺服器中可用的工具。
如果您想依權限篩選工具,可以使用 MCP_TOOL_MODES 僅選擇可讀取、寫入或刪除資料的工具,或這些權限的任何組合。