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) 以取得替代伺服器。此套件與儲存庫將保留至該日期供現有安裝使用,且不再規劃任何功能開發。

Latest Release

此儲存庫包含 Sinch Engage(澳洲地區的 Sinch MessageMedia)MCP 伺服器的原始碼,該伺服器以 MCP 工具的形式提供 Sinch Engage API。

工具總覽

以下是 MCP 伺服器中可用的工具清單(所有電話號碼必須以 E.164 格式提供,例如澳洲為 +61400000000)。

訊息傳送

工具描述類別模式
sendMessage傳送 SMS 至行動電話號碼messagingwrite

報表

工具描述類別模式
getDetailedMessageReport為指定的日期範圍產生已傳送與已接收訊息的詳細報表,可選擇依方向、帳戶、中繼資料及分組進行篩選。reportingread
getSummaryMessageReport為指定的日期範圍產生已傳送與已接收訊息的摘要報表,可選擇依方向、帳戶及分組進行篩選。reportingread
getSummaryInsightMessageReport擷取指定日期範圍內已傳送與已接收訊息的事先編譯摘要報表,可選擇依方向、帳戶及分組進行篩選。reportingread
getAsyncReportStatus依 report_id 擷取非同步報表請求的狀態。reportingread
getAsyncReportFields擷取非同步詳細報表匯出可用的欄位清單。reportingread
requestAsyncDetailedMessageReport為指定的日期範圍請求非同步的詳細報表,並提供報表格式與目的地的傳遞選項。reportingread

聯絡人

工具描述類別模式
getContactGroups擷取與帳戶關聯的聯絡人群組(清單)分頁清單。reportingread
getContactGroupDetails依 group_id 擷取特定聯絡人群組(清單)的詳細資料。reportingread
getContactWithSearch擷取聯絡人清單,可依群組、電話號碼、名稱及管道類型進行篩選。reportingread
createContactGroup以指定的名稱及選用的別名建立新的聯絡人群組(清單)。reportingwrite
createContact以指定的詳細資料建立新的聯絡人。reportingwrite
updateContact以新的詳細資料更新由 contact_id 識別的現有聯絡人。reportingwrite
deleteContactGroup刪除由 group_id 識別的特定聯絡人群組(清單)。reportingdelete

開始使用

先決條件

API 憑證

若要使用 MCP 工具所使用的 API,您需要下列憑證:

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 僅選擇可讀取、寫入或刪除資料的工具,或這些權限的任何組合。