Sinch Engage / MessageMedia MCP server
offiziellSinch 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
sendMessagezu senden. - Nachrichtenberichte erstellen — Fordern Sie detaillierte oder zusammenfassende Berichte über gesendete/empfangene Nachrichten für einen Datumsbereich mit
getDetailedMessageReportodergetSummaryMessageReportan. - Kontaktgruppen verwalten — Erstellen, anzeigen oder löschen Sie Kontaktgruppen (Listen) mit
createContactGroup,getContactGroupsoderdeleteContactGroup. - Kontakte suchen und aktualisieren — Finden Sie Kontakte nach Gruppe, Telefonnummer oder Name und aktualisieren Sie dann deren Details über
getContactWithSearchundupdateContact. - Asynchronen Berichtsstatus verfolgen — Überprüfen Sie den Fortschritt asynchroner Berichtsanfragen mit
getAsyncReportStatusund 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.
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
| Tool | Beschreibung | Kategorie | Modus |
|---|---|---|---|
| sendMessage | Sendet eine SMS an eine Mobilnummer | messaging | write |
Berichte
| Tool | Beschreibung | Kategorie | Modus |
|---|---|---|---|
| getDetailedMessageReport | Erstellt einen detaillierten Bericht über gesendete und empfangene Nachrichten für einen bestimmten Datumsbereich, 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 bestimmten Datumsbereich, 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 bestimmten Datumsbereich ab, mit optionalen Filtern für Richtung, Konten und Gruppierung. | reporting | read |
| getAsyncReportStatus | Ruft den Status einer asynchronen Berichtsanfrage 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 bestimmten Datumsbereich an, mit Lieferoptionen für Berichtsformat und Ziel. | reporting | read |
Kontakte
| Tool | Beschreibung | Kategorie | Modus |
|---|---|---|---|
| getContactGroups | Ruft eine paginierte Liste der Kontaktgruppen (Listen) ab, die mit dem Konto verknüpft sind. | reporting | read |
| getContactGroupDetails | Ruft Details für eine bestimmte Kontaktgruppe (Liste) ab, die durch group_id identifiziert wird. | 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, der durch contact_id identifiziert wird, mit neuen Details. | reporting | write |
| deleteContactGroup | Löscht eine bestimmte Kontaktgruppe (Liste), die durch group_id identifiziert wird. | reporting | delete |
Erste Schritte
Voraussetzungen
- Node.js >= 16.0
- Ein bereitgestelltes Sinch Engage-Konto
- Claude Desktop (oder ein anderer MCP-Client). Dieses README konzentriert sich auf Claude Desktop, aber der MCP-Server kann mit jedem MCP-Client verwendet werden.
API-Anmeldeinformationen
Um die APIs zu verwenden, die von den MCP-Tools genutzt werden, benötigen Sie die folgenden Anmeldeinformationen:
SINCH_ENGAGE_API_KEYundSINCH_ENGAGE_API_SECRETSinch Engage-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.