Sinch Engage / MessageMedia MCP server

Sinch Engage MCP Server

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

Tool	Beschreibung	Kategorie	Modus
sendMessage	SMS an eine Mobilfunknummer senden	messaging	write

Berichtswesen

Tool	Beschreibung	Kategorie	Modus
getDetailedMessageReport	Erstellt einen detaillierten Bericht über gesendete und empfangene Nachrichten für einen angegebenen Zeitraum, mit optionalen Filtern für Richtung, Konten, Metadaten und Gruppierung.	reporting	read
getSummaryMessageReport	Erstellt einen zusammenfassenden Bericht über gesendete und empfangene Nachrichten für einen angegebenen Zeitraum, mit optionalen Filtern für Richtung, Konten und Gruppierung.	reporting	read
getSummaryInsightMessageReport	Ruft einen vorkompilierten zusammenfassenden Bericht über gesendete und empfangene Nachrichten für einen angegebenen Zeitraum ab, mit optionalen Filtern für Richtung, Konten und Gruppierung.	reporting	read
getAsyncReportStatus	Ruft den Status einer asynchronen Berichtsanforderung anhand der report_id ab.	reporting	read
getAsyncReportFields	Ruft die Liste der verfügbaren Felder für den asynchronen detaillierten Berichtsexport ab.	reporting	read
requestAsyncDetailedMessageReport	Fordert einen asynchronen detaillierten Bericht über gesendete und empfangene Nachrichten für einen angegebenen Zeitraum an, mit Zustelloptionen für Berichtsformat und Ziel.	reporting	read

Kontakte

Tool	Beschreibung	Kategorie	Modus
getContactGroups	Ruft eine paginierte Liste von Kontaktgruppen (Listen) ab, die mit dem Konto verknüpft sind.	reporting	read
getContactGroupDetails	Ruft Details für eine bestimmte Kontaktgruppe (Liste) ab, identifiziert durch group_id.	reporting	read
getContactWithSearch	Ruft eine Liste von Kontakten ab, filterbar nach Gruppe, Telefonnummer, Name und Kanaltyp.	reporting	read
createContactGroup	Erstellt eine neue Kontaktgruppe (Liste) mit dem angegebenen Namen und optionalem Alias.	reporting	write
createContact	Erstellt einen neuen Kontakt mit den angegebenen Details.	reporting	write
updateContact	Aktualisiert einen bestehenden Kontakt, identifiziert durch contact_id, mit neuen Details.	reporting	write
deleteContactGroup	Löscht eine bestimmte Kontaktgruppe (Liste), identifiziert durch group_id.	reporting	delete

Erste Schritte

Voraussetzungen

• Node.js >= 16.0
• Ein bereitgestelltes Sinch Engage-Konto
• Claude Desktop (oder ein anderer MCP-Client). Diese README konzentriert sich auf Claude Desktop, aber der MCP-Server kann mit jedem MCP-Client verwendet werden.

API-Anmeldeinformationen

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

• SINCH_ENGAGE_API_KEY und SINCH_ENGAGE_API_SECRET Sinch Engage-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.