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 日停止服务。请勿将其用于新的集成。请按照 连接到 Sinch Engage MCP(澳大利亚) 使用替代服务器。此软件包和代码库将保留至该日期,供现有安装使用,且不再计划新增功能。
此代码库包含 Sinch Engage(澳大利亚地区为 Sinch MessageMedia)MCP 服务器的源代码,该服务器将 Sinch Engage API 作为 MCP 工具提供。
工具概览
以下是 MCP 服务器中可用工具的列表(所有电话号码必须以 E.164 格式提供,例如澳大利亚为 +61400000000)。
消息
| 工具 | 描述 | 类别 | 模式 |
|---|---|---|---|
| sendMessage | 向手机号码发送短信 | 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 服务器中可用的工具
工具过多意味着上下文更大,意味着令牌使用量更高,并且 LLM 选择正确工具的难度更大。
您可以通过在 Claude Desktop 配置选项中提供 MCP_TOOL_CATEGORIES 来筛选 MCP 服务器中可用的工具。
如果您想按权限筛选工具,可以使用 MCP_TOOL_MODES 仅选择可以读取、写入或删除数据或任意组合的工具。