Sinch Engage / MessageMedia MCP server

oficial

Servidor MCP Sinch Engage (Sinch MessageMedia na Austrália), que fornece as APIs do Sinch Engage como ferramentas MCP.

O que você pode fazer com Sinch Engage MessageMedia MCP?

  • Enviar mensagens SMS — Peça ao seu assistente para enviar um SMS para qualquer número de celular no formato E.164 via sendMessage.
  • Gerar relatórios de mensagens — Solicite relatórios detalhados ou resumidos de mensagens enviadas/recebidas para um intervalo de datas usando getDetailedMessageReport ou getSummaryMessageReport.
  • Gerenciar grupos de contatos — Crie, visualize ou exclua grupos de contatos (listas) com createContactGroup, getContactGroups ou deleteContactGroup.
  • Pesquisar e atualizar contatos — Encontre contatos por grupo, telefone ou nome e, em seguida, atualize seus detalhes via getContactWithSearch e updateContact.
  • Acompanhar status de relatórios assíncronos — Verifique o progresso de solicitações de relatórios assíncronos usando getAsyncReportStatus com um ID de relatório.

Documentação

Servidor MCP Sinch Engage

Aviso de descontinuação. Este servidor MCP está descontinuado e chegará ao fim da vida útil em 30 de novembro de 2026. Não o utilize para novas integrações. Siga Conectar ao Sinch Engage MCP (AU) para o servidor substituto. Este pacote e repositório são mantidos para instalações existentes até essa data, e nenhum trabalho adicional de funcionalidades está planejado.

Latest Release

Este repositório contém o código-fonte do servidor MCP Sinch Engage (Sinch MessageMedia na AU), que fornece APIs do Sinch Engage como ferramentas MCP.

Visão Geral das Ferramentas

Aqui está a lista de ferramentas disponíveis no servidor MCP (todos os números de telefone devem ser fornecidos no formato E.164, ex.: +61400000000 para a Austrália).

Mensagens

FerramentaDescriçãoCategoriaModo
sendMessageEnvia SMS para um número de celularmensagensescrita

Relatórios

FerramentaDescriçãoCategoriaModo
getDetailedMessageReportGera um relatório detalhado de mensagens enviadas e recebidas para um intervalo de datas especificado, com filtros opcionais por direção, contas, metadados e agrupamento.relatóriosleitura
getSummaryMessageReportGera um relatório resumido de mensagens enviadas e recebidas para um intervalo de datas especificado, com filtros opcionais por direção, contas e agrupamento.relatóriosleitura
getSummaryInsightMessageReportBusca um relatório resumido pré-compilado de mensagens enviadas e recebidas para um intervalo de datas especificado, com filtros opcionais por direção, contas e agrupamento.relatóriosleitura
getAsyncReportStatusRecupera o status de uma solicitação de relatório assíncrono pelo report_id.relatóriosleitura
getAsyncReportFieldsRecupera a lista de campos disponíveis para exportação de relatório detalhado assíncrono.relatóriosleitura
requestAsyncDetailedMessageReportSolicita um relatório detalhado assíncrono de mensagens enviadas e recebidas para um intervalo de datas especificado, com opções de entrega para formato e destino do relatório.relatóriosleitura

Contatos

FerramentaDescriçãoCategoriaModo
getContactGroupsRecupera uma lista paginada de grupos de contatos (listas) associados à conta.relatóriosleitura
getContactGroupDetailsRecupera detalhes de um grupo de contatos (lista) específico identificado pelo group_id.relatóriosleitura
getContactWithSearchRecupera uma lista de contatos, filtrável por grupo, número de telefone, nome e tipo de canal.relatóriosleitura
createContactGroupCria um novo grupo de contatos (lista) com o nome especificado e alias opcional.relatóriosescrita
createContactCria um novo contato com os detalhes especificados.relatóriosescrita
updateContactAtualiza um contato existente identificado pelo contact_id com novos detalhes.relatóriosescrita
deleteContactGroupExclui um grupo de contatos (lista) específico identificado pelo group_id.relatóriosexclusão

Primeiros Passos

Pré-requisitos

Credenciais da API

Para usar as APIs utilizadas pelas ferramentas MCP, você precisará das seguintes credenciais:

Configuração do Servidor MCP

O servidor MCP Sinch Engage está disponível como um pacote NPM para ser executado. Veja como configurá-lo no arquivo de configuração do Claude Desktop (claude_desktop_config.json). Lembre-se de preencher as variáveis de ambiente com suas próprias credenciais e a região (atualmente suportadas EU e 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"
      }
    }
  }
}

Executando o Servidor MCP Localmente

Opção 1: Iniciar o servidor MCP com stdio usando Claude Desktop

Para executar o servidor MCP localmente com Claude Desktop, você precisará clonar o repositório e compilar o servidor MCP. Esta opção é útil para desenvolvimento e testes locais.

Etapa 1: Clonar o repositório

git clone https://github.com/messagemedia/sinch-engage-mcp-server.git

Etapa 2: Instalar dependências

cd sinch-engage-mcp-server
npm install

Etapa 3: Configurar a configuração do Claude Desktop

Aqui está um exemplo de como configurar o servidor MCP no arquivo de configuração do Claude Desktop (claude_desktop_config.json) onde você pode fornecer suas credenciais Sinch Engage e região (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"
      }
    }
  }
}

Etapa 4: (Opcional) Filtrar as ferramentas disponíveis no servidor MCP

Muitas ferramentas significam contexto maior, maior uso de tokens e mais confusão para o LLM selecionar a ferramenta certa para usar.
Você pode filtrar as ferramentas disponíveis no servidor MCP fornecendo MCP_TOOL_CATEGORIES nas opções de configuração do Claude Desktop.

Se você quiser filtrar ferramentas por permissões, pode usar MCP_TOOL_MODES para escolher apenas ferramentas que podem ler, escrever ou excluir dados, ou qualquer combinação delas