Sinch Engage / MessageMedia MCP server
officielServeur MCP Sinch Engage (Sinch MessageMedia en Australie), qui fournit les API Sinch Engage en tant qu'outils MCP.
Que pouvez-vous faire avec Sinch Engage MessageMedia MCP ?
- Envoyer des messages SMS — Demandez à votre assistant d'envoyer un SMS à tout numéro mobile au format E.164 via
sendMessage. - Générer des rapports de messages — Demandez des rapports détaillés ou synthétiques des messages envoyés/reçus pour une plage de dates à l'aide de
getDetailedMessageReportougetSummaryMessageReport. - Gérer les groupes de contacts — Créez, consultez ou supprimez des groupes de contacts (listes) avec
createContactGroup,getContactGroupsoudeleteContactGroup. - Rechercher et mettre à jour des contacts — Trouvez des contacts par groupe, téléphone ou nom, puis mettez à jour leurs informations via
getContactWithSearchetupdateContact. - Suivre l'état des rapports asynchrones — Vérifiez la progression des demandes de rapports asynchrones à l'aide de
getAsyncReportStatusavec un identifiant de rapport.
Documentation
Serveur MCP Sinch Engage
Avis de dépréciation. Ce serveur MCP est déprécié et atteindra sa fin de vie le 30 novembre 2026. Ne l'utilisez pas pour de nouvelles intégrations. Suivez Connectez-vous au MCP Sinch Engage (AU) pour le serveur de remplacement. Ce package et ce dépôt sont conservés pour les installations existantes jusqu'à cette date, et aucun développement supplémentaire n'est prévu.
Ce dépôt contient le code source du serveur MCP Sinch Engage (Sinch MessageMedia en AU), qui fournit les API Sinch Engage en tant qu'outils MCP.
Aperçu des outils
Voici la liste des outils disponibles dans le serveur MCP (tous les numéros de téléphone doivent être fournis au format E.164, par exemple +61400000000 pour l'Australie).
Messagerie
| Outil | Description | Catégorie | Mode |
|---|---|---|---|
| sendMessage | Envoyer un SMS à un numéro mobile | messagerie | écriture |
Rapports
| Outil | Description | Catégorie | Mode |
|---|---|---|---|
| getDetailedMessageReport | Génère un rapport détaillé des messages envoyés et reçus pour une plage de dates spécifiée, avec des filtres optionnels pour la direction, les comptes, les métadonnées et le regroupement. | rapports | lecture |
| getSummaryMessageReport | Génère un rapport récapitulatif des messages envoyés et reçus pour une plage de dates spécifiée, avec des filtres optionnels pour la direction, les comptes et le regroupement. | rapports | lecture |
| getSummaryInsightMessageReport | Récupère un rapport récapitulatif pré-compilé des messages envoyés et reçus pour une plage de dates spécifiée, avec des filtres optionnels pour la direction, les comptes et le regroupement. | rapports | lecture |
| getAsyncReportStatus | Récupère le statut d'une demande de rapport asynchrone par report_id. | rapports | lecture |
| getAsyncReportFields | Récupère la liste des champs disponibles pour l'exportation de rapports détaillés asynchrones. | rapports | lecture |
| requestAsyncDetailedMessageReport | Demande un rapport détaillé asynchrone des messages envoyés et reçus pour une plage de dates spécifiée, avec des options de livraison pour le format et la destination du rapport. | rapports | lecture |
Contacts
| Outil | Description | Catégorie | Mode |
|---|---|---|---|
| getContactGroups | Récupère une liste paginée des groupes de contacts (listes) associés au compte. | rapports | lecture |
| getContactGroupDetails | Récupère les détails d'un groupe de contacts (liste) spécifique identifié par group_id. | rapports | lecture |
| getContactWithSearch | Récupère une liste de contacts, filtrable par groupe, numéro de téléphone, nom et type de canal. | rapports | lecture |
| createContactGroup | Crée un nouveau groupe de contacts (liste) avec le nom spécifié et un alias optionnel. | rapports | écriture |
| createContact | Crée un nouveau contact avec les détails spécifiés. | rapports | écriture |
| updateContact | Met à jour un contact existant identifié par contact_id avec de nouveaux détails. | rapports | écriture |
| deleteContactGroup | Supprime un groupe de contacts (liste) spécifique identifié par group_id. | rapports | suppression |
Pour commencer
Prérequis
- Node.js >= 16.0
- Un compte Sinch Engage provisionné
- Claude Desktop (ou tout autre client MCP). Ce README est axé sur Claude Desktop, mais le serveur MCP peut être utilisé avec n'importe quel client MCP.
Identifiants API
Pour utiliser les API utilisées par les outils MCP, vous aurez besoin des identifiants suivants :
SINCH_ENGAGE_API_KEYetSINCH_ENGAGE_API_SECRETIdentifiants Sinch Engage
Configuration du serveur MCP
Le serveur MCP Sinch Engage est disponible en tant que package NPM à exécuter. Voici comment le configurer dans le fichier de configuration Claude Desktop (claude_desktop_config.json). N'oubliez pas de remplir les variables d'environnement avec vos propres identifiants et la région (actuellement pris en charge EU et 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"
}
}
}
}
Exécution du serveur MCP localement
Option 1 : Démarrer le serveur MCP avec stdio en utilisant Claude Desktop
Pour exécuter le serveur MCP localement avec Claude Desktop, vous devrez cloner le dépôt et compiler le serveur MCP. Cette option est utile pour le développement local et les tests.
Étape 1 : Cloner le dépôt
git clone https://github.com/messagemedia/sinch-engage-mcp-server.git
Étape 2 : Installer les dépendances
cd sinch-engage-mcp-server
npm install
Étape 3 : Configurer Claude Desktop
Voici un exemple de configuration du serveur MCP dans le fichier de configuration Claude Desktop (claude_desktop_config.json) où vous pouvez fournir vos identifiants Sinch Engage et la région (EU ou 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"
}
}
}
}
Étape 4 : (Optionnel) Filtrer les outils disponibles dans le serveur MCP
Trop d'outils signifie un contexte plus important, une utilisation de jetons plus élevée et plus de confusion pour le LLM pour sélectionner le bon outil à utiliser.
Vous pouvez filtrer les outils disponibles dans le serveur MCP en fournissant MCP_TOOL_CATEGORIES dans les options de configuration de Claude Desktop.
Si vous souhaitez filtrer les outils par permissions, vous pouvez utiliser MCP_TOOL_MODES pour ne sélectionner que les outils qui peuvent lire, écrire ou supprimer des données, ou toute combinaison de celles-ci.