Sinch Engage / MessageMedia MCP server

oficial

Servidor 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 getDetailedMessageReport o getSummaryMessageReport.
  • Gestionar grupos de contactos — Crea, visualiza o elimina grupos de contactos (listas) con createContactGroup, getContactGroups o deleteContactGroup.
  • Buscar y actualizar contactos — Encuentra contactos por grupo, teléfono o nombre, y luego actualiza sus detalles mediante getContactWithSearch y updateContact.
  • Seguimiento del estado de informes asíncronos — Verifica el progreso de solicitudes de informes asíncronos usando getAsyncReportStatus con 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.

Latest Release

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

HerramientaDescripciónCategoríaModo
sendMessageEnviar SMS a un número móvilmensajeríaescritura

Informes

HerramientaDescripciónCategoríaModo
getDetailedMessageReportGenera 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.informeslectura
getSummaryMessageReportGenera 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.informeslectura
getSummaryInsightMessageReportObtiene 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.informeslectura
getAsyncReportStatusRecupera el estado de una solicitud de informe asíncrono mediante report_id.informeslectura
getAsyncReportFieldsRecupera la lista de campos disponibles para la exportación de informes detallados asíncronos.informeslectura
requestAsyncDetailedMessageReportSolicita 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.informeslectura

Contactos

HerramientaDescripciónCategoríaModo
getContactGroupsRecupera una lista paginada de grupos de contactos (listas) asociados con la cuenta.informeslectura
getContactGroupDetailsRecupera los detalles de un grupo de contactos (lista) específico identificado por group_id.informeslectura
getContactWithSearchRecupera una lista de contactos, filtrable por grupo, número de teléfono, nombre y tipo de canal.informeslectura
createContactGroupCrea un nuevo grupo de contactos (lista) con el nombre especificado y un alias opcional.informesescritura
createContactCrea un nuevo contacto con los detalles especificados.informesescritura
updateContactActualiza un contacto existente identificado por contact_id con nuevos detalles.informesescritura
deleteContactGroupElimina un grupo de contactos (lista) específico identificado por group_id.informeseliminación

Primeros Pasos

Requisitos Previos

Credenciales de API

Para utilizar las APIs empleadas por las herramientas MCP, necesitará las siguientes credenciales:

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.