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 Server
Уведомление об устаревании. Этот MCP-сервер устарел и будет выведен из эксплуатации 30 ноября 2026 года. Не используйте его для новых интеграций. Следуйте инструкциям в разделе Подключение к Sinch Engage MCP (AU) для заменяющего сервера. Этот пакет и репозиторий сохраняются для существующих установок до указанной даты, и дальнейшая разработка функциональности не планируется.
Этот репозиторий содержит исходный код MCP-сервера Sinch Engage (Sinch MessageMedia в Австралии), который предоставляет API Sinch Engage в виде 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-клиент). Эта документация ориентирована на Claude Desktop, но MCP-сервер можно использовать с любым MCP-клиентом.
Учетные данные API
Для использования API, применяемых MCP-инструментами, вам потребуются следующие учетные данные:
SINCH_ENGAGE_API_KEYиSINCH_ENGAGE_API_SECRETУчетные данные Sinch Engage
Конфигурация MCP-сервера
MCP-сервер Sinch Engage доступен как 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: Установка зависимостей
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, чтобы выбрать только те инструменты, которые могут читать, записывать или удалять данные, или любую их комбинацию.