Sinch Engage / MessageMedia MCP server
oficialServidor MCP de Sinch Engage (Sinch MessageMedia en AU), que proporciona las APIs de Sinch Engage como herramientas MCP.
¿Qué puedes hacer con Sinch Engage MessageMedia MCP?
- Enviar mensajes SMS — Pídele a tu asistente que envíe un SMS a cualquier número móvil en formato E.164 mediante
sendMessage. - Generar informes de mensajes — Solicita informes detallados o resumidos de mensajes enviados/recibidos para un rango de fechas usando
getDetailedMessageReportogetSummaryMessageReport. - Gestionar grupos de contactos — Crea, visualiza o elimina grupos de contactos (listas) con
createContactGroup,getContactGroupsodeleteContactGroup. - Buscar y actualizar contactos — Encuentra contactos por grupo, teléfono o nombre, y luego actualiza sus detalles mediante
getContactWithSearchyupdateContact. - Seguimiento del estado de informes asíncronos — Verifica el progreso de solicitudes de informes asíncronos usando
getAsyncReportStatuscon un ID de informe.
Documentación
Servidor MCP de Sinch Engage
Aviso de descontinuación. Este servidor MCP está descontinuado y llegará a su fin de vida útil el 30 de noviembre de 2026. No lo utilice para nuevas integraciones. Siga Conéctese al MCP de Sinch Engage (AU) para el servidor de reemplazo. Este paquete y repositorio se conservan para instalaciones existentes hasta esa fecha, y no se planea ningún trabajo adicional de funcionalidades.
Este repositorio contiene el código fuente del servidor MCP de Sinch Engage (Sinch MessageMedia en AU), que proporciona las APIs de Sinch Engage como herramientas MCP.
Resumen de Herramientas
Aquí está la lista de herramientas disponibles en el servidor MCP (todos los números de teléfono deben proporcionarse en formato E.164, por ejemplo, +61400000000 para Australia).
Mensajería
| Herramienta | Descripción | Categoría | Modo |
|---|---|---|---|
| sendMessage | Enviar SMS a un número móvil | mensajería | escritura |
Informes
| Herramienta | Descripción | Categoría | Modo |
|---|---|---|---|
| getDetailedMessageReport | Genera un informe detallado de mensajes enviados y recibidos para un rango de fechas específico, con filtros opcionales por dirección, cuentas, metadatos y agrupación. | informes | lectura |
| getSummaryMessageReport | Genera un informe resumido de mensajes enviados y recibidos para un rango de fechas específico, con filtros opcionales por dirección, cuentas y agrupación. | informes | lectura |
| getSummaryInsightMessageReport | Obtiene un informe resumido precompilado de mensajes enviados y recibidos para un rango de fechas específico, con filtros opcionales por dirección, cuentas y agrupación. | informes | lectura |
| getAsyncReportStatus | Recupera el estado de una solicitud de informe asíncrono mediante report_id. | informes | lectura |
| getAsyncReportFields | Recupera la lista de campos disponibles para la exportación de informes detallados asíncronos. | informes | lectura |
| requestAsyncDetailedMessageReport | Solicita un informe detallado asíncrono de mensajes enviados y recibidos para un rango de fechas específico, con opciones de entrega para el formato y destino del informe. | informes | lectura |
Contactos
| Herramienta | Descripción | Categoría | Modo |
|---|---|---|---|
| getContactGroups | Recupera una lista paginada de grupos de contactos (listas) asociados con la cuenta. | informes | lectura |
| getContactGroupDetails | Recupera los detalles de un grupo de contactos (lista) específico identificado por group_id. | informes | lectura |
| getContactWithSearch | Recupera una lista de contactos, filtrable por grupo, número de teléfono, nombre y tipo de canal. | informes | lectura |
| createContactGroup | Crea un nuevo grupo de contactos (lista) con el nombre especificado y un alias opcional. | informes | escritura |
| createContact | Crea un nuevo contacto con los detalles especificados. | informes | escritura |
| updateContact | Actualiza un contacto existente identificado por contact_id con nuevos detalles. | informes | escritura |
| deleteContactGroup | Elimina un grupo de contactos (lista) específico identificado por group_id. | informes | eliminación |
Primeros Pasos
Requisitos Previos
- Node.js >= 16.0
- Una cuenta de Sinch Engage aprovisionada
- Claude Desktop (o cualquier otro cliente MCP). Este README se centra en Claude Desktop, pero el servidor MCP se puede utilizar con cualquier cliente MCP.
Credenciales de API
Para utilizar las APIs empleadas por las herramientas MCP, necesitará las siguientes credenciales:
SINCH_ENGAGE_API_KEYySINCH_ENGAGE_API_SECRETCredenciales de Sinch Engage
Configuración del Servidor MCP
El servidor MCP de Sinch Engage está disponible como paquete NPM para ejecutarse. Así es como se configura en el archivo de configuración de Claude Desktop (claude_desktop_config.json). Recuerde completar las variables de entorno con sus propias credenciales y la región (actualmente compatibles EU y 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"
}
}
}
}
Ejecutar el Servidor MCP Localmente
Opción 1: Iniciar el servidor MCP con stdio usando Claude Desktop
Para ejecutar el servidor MCP localmente con Claude Desktop, necesitará clonar el repositorio y compilar el servidor MCP. Esta opción es útil para el desarrollo y las pruebas locales.
Paso 1: Clonar el repositorio
git clone https://github.com/messagemedia/sinch-engage-mcp-server.git
Paso 2: Instalar dependencias
cd sinch-engage-mcp-server
npm install
Paso 3: Configurar la configuración de Claude Desktop
Aquí hay un ejemplo de cómo configurar el servidor MCP en el archivo de configuración de Claude Desktop (claude_desktop_config.json) donde puede proporcionar sus credenciales de Sinch Engage y la región (EU o 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"
}
}
}
}
Paso 4: (Opcional) Filtrar las herramientas disponibles en el servidor MCP
Demasiadas herramientas significan un contexto más grande, un mayor uso de tokens y más confusión para que el LLM seleccione la herramienta correcta para usar.
Puede filtrar las herramientas disponibles en el servidor MCP proporcionando MCP_TOOL_CATEGORIES en las opciones de configuración de Claude Desktop.
Si desea filtrar herramientas por permisos, puede usar MCP_TOOL_MODES para elegir solo herramientas que puedan leer, escribir o eliminar datos, o cualquier combinación de ellas.