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) для заменяющего сервера. Этот пакет и репозиторий сохраняются для существующих установок до указанной даты, и дальнейшая разработка функциональности не планируется.

Latest Release

Этот репозиторий содержит исходный код MCP-сервера Sinch Engage (Sinch MessageMedia в Австралии), который предоставляет API Sinch Engage в виде MCP-инструментов.

Обзор инструментов

Ниже приведен список инструментов, доступных в 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

Для использования API, применяемых MCP-инструментами, вам потребуются следующие учетные данные:

Конфигурация 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, чтобы выбрать только те инструменты, которые могут читать, записывать или удалять данные, или любую их комбинацию.