Sinch Engage / MessageMedia MCP server

offiziell

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

Dokumentation

Sinch Engage MCP Server

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.

Tools-Übersicht

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

Nachrichtenversand

ToolBeschreibungKategorieModus
sendMessageSMS an eine Mobilfunknummer sendenmessagingwrite

Berichtswesen

ToolBeschreibungKategorieModus
getDetailedMessageReportErstellt einen detaillierten Bericht über gesendete und empfangene Nachrichten für einen angegebenen Zeitraum, mit optionalen Filtern für Richtung, Konten, Metadaten und Gruppierung.reportingread
getSummaryMessageReportErstellt einen zusammenfassenden Bericht über gesendete und empfangene Nachrichten für einen angegebenen Zeitraum, mit optionalen Filtern für Richtung, Konten und Gruppierung.reportingread
getSummaryInsightMessageReportRuft einen vorkompilierten zusammenfassenden Bericht über gesendete und empfangene Nachrichten für einen angegebenen Zeitraum ab, mit optionalen Filtern für Richtung, Konten und Gruppierung.reportingread
getAsyncReportStatusRuft den Status einer asynchronen Berichtsanforderung 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 angegebenen Zeitraum an, mit Zustelloptionen für Berichtsformat und Ziel.reportingread

Kontakte

ToolBeschreibungKategorieModus
getContactGroupsRuft eine paginierte Liste von Kontaktgruppen (Listen) ab, die mit dem Konto verknüpft sind.reportingread
getContactGroupDetailsRuft Details für eine bestimmte Kontaktgruppe (Liste) ab, identifiziert durch group_id.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, identifiziert durch contact_id, mit neuen Details.reportingwrite
deleteContactGroupLöscht eine bestimmte Kontaktgruppe (Liste), identifiziert durch group_id.reportingdelete

Erste Schritte

Voraussetzungen

API-Anmeldeinformationen

Um die von den MCP-Tools verwendeten APIs zu nutzen, benötigen Sie die folgenden Anmeldeinformationen:

MCP-Server-Konfiguration

Der Sinch Engage MCP-Server ist als NPM-Paket zur Ausführung verfügbar. 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"
      }
    }
  }
}

Den MCP-Server lokal ausführen

Option 1: MCP-Server mit stdio unter Verwendung von Claude Desktop starten

Um den MCP-Server lokal mit Claude Desktop auszuführen, müssen Sie das Repository klonen und den MCP-Server bauen. Diese Option ist nützlich für die lokale Entwicklung und zum 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) Die im MCP-Server verfügbaren Tools filtern

Zu viele Tools bedeuten größeren Kontext, 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 Daten lesen, schreiben oder löschen können, oder eine beliebige Kombination davon.