Sinch Engage / MessageMedia MCP server

offiziell

Sinch Engage (Sinch MessageMedia in AU) MCP-Server, der Sinch Engage APIs als MCP-Tools bereitstellt.

Was kann man mit Sinch Engage MessageMedia MCP machen?

  • SMS-Nachrichten senden — Bitten Sie Ihren Assistenten, eine SMS an eine beliebige Mobilnummer im E.164-Format über sendMessage zu senden.
  • Nachrichtenberichte erstellen — Fordern Sie detaillierte oder zusammenfassende Berichte über gesendete/empfangene Nachrichten für einen Datumsbereich mit getDetailedMessageReport oder getSummaryMessageReport an.
  • Kontaktgruppen verwalten — Erstellen, anzeigen oder löschen Sie Kontaktgruppen (Listen) mit createContactGroup, getContactGroups oder deleteContactGroup.
  • Kontakte suchen und aktualisieren — Finden Sie Kontakte nach Gruppe, Telefonnummer oder Name und aktualisieren Sie dann deren Details über getContactWithSearch und updateContact.
  • Asynchronen Berichtsstatus verfolgen — Überprüfen Sie den Fortschritt asynchroner Berichtsanfragen mit getAsyncReportStatus und einer Berichts-ID.

Dokumentation

Sinch Engage MCP Server

Hinweis zur Einstellung. Dieser MCP-Server ist veraltet und wird am 30. November 2026 das Ende seiner Lebensdauer erreichen. Verwenden Sie ihn nicht für neue Integrationen. Folgen Sie Connect to the Sinch Engage MCP (AU) für den Ersatzserver. Dieses Paket und Repository werden bis zu diesem Datum für bestehende Installationen beibehalten, und es sind keine weiteren Funktionserweiterungen geplant.

Latest Release

Dieses Repository enthält den Quellcode für den Sinch Engage (Sinch MessageMedia in AU) MCP-Server, der Sinch Engage APIs als MCP-Tools bereitstellt.

Übersicht der Tools

Hier ist die Liste der Tools, die im MCP-Server verfügbar sind (alle Telefonnummern müssen im E.164-Format angegeben werden, z. B. +61400000000 für Australien).

Messaging

ToolBeschreibungKategorieModus
sendMessageSendet eine SMS an eine Mobilnummermessagingwrite

Berichte

ToolBeschreibungKategorieModus
getDetailedMessageReportErstellt einen detaillierten Bericht über gesendete und empfangene Nachrichten für einen bestimmten Datumsbereich, mit optionalen Filtern für Richtung, Konten, Metadaten und Gruppierung.reportingread
getSummaryMessageReportErstellt einen zusammenfassenden Bericht über gesendete und empfangene Nachrichten für einen bestimmten Datumsbereich, mit optionalen Filtern für Richtung, Konten und Gruppierung.reportingread
getSummaryInsightMessageReportRuft einen vorkompilierten zusammenfassenden Bericht über gesendete und empfangene Nachrichten für einen bestimmten Datumsbereich ab, mit optionalen Filtern für Richtung, Konten und Gruppierung.reportingread
getAsyncReportStatusRuft den Status einer asynchronen Berichtsanfrage anhand der report_id ab.reportingread
getAsyncReportFieldsRuft die Liste der verfügbaren Felder für den asynchronen detaillierten Berichtsexport ab.reportingread
requestAsyncDetailedMessageReportFordert einen asynchronen detaillierten Bericht über gesendete und empfangene Nachrichten für einen bestimmten Datumsbereich an, mit Lieferoptionen für Berichtsformat und Ziel.reportingread

Kontakte

ToolBeschreibungKategorieModus
getContactGroupsRuft eine paginierte Liste der Kontaktgruppen (Listen) ab, die mit dem Konto verknüpft sind.reportingread
getContactGroupDetailsRuft Details für eine bestimmte Kontaktgruppe (Liste) ab, die durch group_id identifiziert wird.reportingread
getContactWithSearchRuft eine Liste von Kontakten ab, filterbar nach Gruppe, Telefonnummer, Name und Kanaltyp.reportingread
createContactGroupErstellt eine neue Kontaktgruppe (Liste) mit dem angegebenen Namen und optionalem Alias.reportingwrite
createContactErstellt einen neuen Kontakt mit den angegebenen Details.reportingwrite
updateContactAktualisiert einen bestehenden Kontakt, der durch contact_id identifiziert wird, mit neuen Details.reportingwrite
deleteContactGroupLöscht eine bestimmte Kontaktgruppe (Liste), die durch group_id identifiziert wird.reportingdelete

Erste Schritte

Voraussetzungen

API-Anmeldeinformationen

Um die APIs zu verwenden, die von den MCP-Tools genutzt werden, benötigen Sie die folgenden Anmeldeinformationen:

MCP-Server-Konfiguration

Der Sinch Engage MCP-Server ist als NPM-Paket verfügbar, das ausgeführt werden kann. So richten Sie ihn in der Claude Desktop-Konfigurationsdatei (claude_desktop_config.json) ein. Denken Sie daran, die Umgebungsvariablen mit Ihren eigenen Anmeldeinformationen und der Region auszufüllen (derzeit unterstützt 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"
      }
    }
  }
}

Ausführen des MCP-Servers lokal

Option 1: Starten des MCP-Servers mit stdio über Claude Desktop

Um den MCP-Server lokal mit Claude Desktop auszuführen, müssen Sie das Repository klonen und den MCP-Server erstellen. Diese Option ist nützlich für die lokale Entwicklung und das Testen.

Schritt 1: Repository klonen

git clone https://github.com/messagemedia/sinch-engage-mcp-server.git

Schritt 2: Abhängigkeiten installieren

cd sinch-engage-mcp-server
npm install

Schritt 3: Claude Desktop-Konfiguration einrichten

Hier ist ein Beispiel, wie Sie den MCP-Server in der Claude Desktop-Konfigurationsdatei (claude_desktop_config.json) konfigurieren, wo Sie Ihre Sinch Engage-Anmeldeinformationen und Region (EU oder AU) angeben können:

{
  "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"
      }
    }
  }
}

Schritt 4: (Optional) Filtern der im MCP-Server verfügbaren Tools

Zu viele Tools bedeuten einen größeren Kontext, einen höheren Token-Verbrauch und mehr Verwirrung für das LLM bei der Auswahl des richtigen Tools.
Sie können die im MCP-Server verfügbaren Tools filtern, indem Sie MCP_TOOL_CATEGORIES in den Claude Desktop-Konfigurationsoptionen angeben.

Wenn Sie Tools nach Berechtigungen filtern möchten, können Sie MCP_TOOL_MODES verwenden, um nur Tools auszuwählen, die entweder Daten lesen, schreiben oder löschen können oder eine beliebige Kombination davon.