Sinch Engage / MessageMedia MCP server
oficialServidor 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
getDetailedMessageReportougetSummaryMessageReport. - Gerenciar grupos de contatos — Crie, visualize ou exclua grupos de contatos (listas) com
createContactGroup,getContactGroupsoudeleteContactGroup. - Pesquisar e atualizar contatos — Encontre contatos por grupo, telefone ou nome e, em seguida, atualize seus detalhes via
getContactWithSearcheupdateContact. - Acompanhar status de relatórios assíncronos — Verifique o progresso de solicitações de relatórios assíncronos usando
getAsyncReportStatuscom 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.
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
| Ferramenta | Descrição | Categoria | Modo |
|---|---|---|---|
| sendMessage | Envia SMS para um número de celular | mensagens | escrita |
Relatórios
| Ferramenta | Descrição | Categoria | Modo |
|---|---|---|---|
| getDetailedMessageReport | Gera 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órios | leitura |
| getSummaryMessageReport | Gera 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órios | leitura |
| getSummaryInsightMessageReport | Busca 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órios | leitura |
| getAsyncReportStatus | Recupera o status de uma solicitação de relatório assíncrono pelo report_id. | relatórios | leitura |
| getAsyncReportFields | Recupera a lista de campos disponíveis para exportação de relatório detalhado assíncrono. | relatórios | leitura |
| requestAsyncDetailedMessageReport | Solicita 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órios | leitura |
Contatos
| Ferramenta | Descrição | Categoria | Modo |
|---|---|---|---|
| getContactGroups | Recupera uma lista paginada de grupos de contatos (listas) associados à conta. | relatórios | leitura |
| getContactGroupDetails | Recupera detalhes de um grupo de contatos (lista) específico identificado pelo group_id. | relatórios | leitura |
| getContactWithSearch | Recupera uma lista de contatos, filtrável por grupo, número de telefone, nome e tipo de canal. | relatórios | leitura |
| createContactGroup | Cria um novo grupo de contatos (lista) com o nome especificado e alias opcional. | relatórios | escrita |
| createContact | Cria um novo contato com os detalhes especificados. | relatórios | escrita |
| updateContact | Atualiza um contato existente identificado pelo contact_id com novos detalhes. | relatórios | escrita |
| deleteContactGroup | Exclui um grupo de contatos (lista) específico identificado pelo group_id. | relatórios | exclusão |
Primeiros Passos
Pré-requisitos
- Node.js >= 16.0
- Uma conta Sinch Engage provisionada
- Claude Desktop (ou qualquer outro cliente MCP). Este README é focado no Claude Desktop, mas o servidor MCP pode ser usado com qualquer cliente MCP.
Credenciais da API
Para usar as APIs utilizadas pelas ferramentas MCP, você precisará das seguintes credenciais:
SINCH_ENGAGE_API_KEYeSINCH_ENGAGE_API_SECRETCredenciais Sinch Engage
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