Sinch Engage / MessageMedia MCP server
resmiSinch Engage (Avustralya'da Sinch MessageMedia) MCP sunucusu, Sinch Engage API'lerini MCP araçları olarak sağlar.
Sinch Engage MessageMedia MCP ile neler yapabilirsiniz?
- SMS mesajları gönder — Asistanınızdan,
sendMessagearacılığıyla E.164 formatındaki herhangi bir mobil numaraya SMS göndermesini isteyin. - Mesaj raporları oluştur —
getDetailedMessageReportveyagetSummaryMessageReportkullanarak belirli bir tarih aralığı için gönderilen/alınan mesajların ayrıntılı veya özet raporlarını talep edin. - Kişi gruplarını yönet —
createContactGroup,getContactGroupsveyadeleteContactGroupile kişi gruplarını (listelerini) oluşturun, görüntüleyin veya silin. - Kişileri ara ve güncelle — Kişileri grup, telefon veya isme göre bulun, ardından
getContactWithSearchveupdateContactile bilgilerini güncelleyin. - Zaman uyumsuz rapor durumunu izle —
getAsyncReportStatusile bir rapor kimliği kullanarak zaman uyumsuz rapor taleplerinin ilerlemesini kontrol edin.
Dokümantasyon
Sinch Engage MCP Sunucusu
Kullanımdan kaldırma bildirimi. Bu MCP sunucusu kullanımdan kaldırılmıştır ve 30 Kasım 2026 tarihinde kullanım ömrünün sonuna ulaşacaktır. Yeni entegrasyonlar için kullanmayın. Yedek sunucu için Sinch Engage MCP'ye (AU) bağlanın. Bu paket ve depo, mevcut kurulumlar için o tarihe kadar korunacaktır ve daha fazla özellik çalışması planlanmamaktadır.
Bu depo, Sinch Engage API'lerini MCP araçları olarak sağlayan Sinch Engage (AU'da Sinch MessageMedia) MCP sunucusunun kaynak kodunu içerir.
Araçlara Genel Bakış
MCP sunucusunda bulunan araçların listesi aşağıdadır (tüm telefon numaraları E.164 formatında sağlanmalıdır, örn. Avustralya için +61400000000).
Mesajlaşma
| Araç | Açıklama | Kategori | Mod |
|---|---|---|---|
| sendMessage | Bir mobil numaraya SMS gönderir | mesajlaşma | yazma |
Raporlama
| Araç | Açıklama | Kategori | Mod |
|---|---|---|---|
| getDetailedMessageReport | Belirtilen tarih aralığı için gönderilen ve alınan mesajların ayrıntılı raporunu oluşturur; yön, hesaplar, meta veriler ve gruplama için isteğe bağlı filtreler içerir. | raporlama | okuma |
| getSummaryMessageReport | Belirtilen tarih aralığı için gönderilen ve alınan mesajların özet raporunu oluşturur; yön, hesaplar ve gruplama için isteğe bağlı filtreler içerir. | raporlama | okuma |
| getSummaryInsightMessageReport | Belirtilen tarih aralığı için gönderilen ve alınan mesajların önceden derlenmiş özet raporunu getirir; yön, hesaplar ve gruplama için isteğe bağlı filtreler içerir. | raporlama | okuma |
| getAsyncReportStatus | report_id ile asenkron bir rapor talebinin durumunu alır. | raporlama | okuma |
| getAsyncReportFields | Asenkron ayrıntılı rapor dışa aktarımı için mevcut alanların listesini alır. | raporlama | okuma |
| requestAsyncDetailedMessageReport | Belirtilen tarih aralığı için gönderilen ve alınan mesajların asenkron ayrıntılı raporunu talep eder; rapor formatı ve hedef için teslimat seçenekleri içerir. | raporlama | okuma |
Kişiler
| Araç | Açıklama | Kategori | Mod |
|---|---|---|---|
| getContactGroups | Hesapla ilişkili kişi gruplarının (listelerin) sayfalanmış listesini alır. | raporlama | okuma |
| getContactGroupDetails | group_id ile tanımlanan belirli bir kişi grubunun (listenin) ayrıntılarını alır. | raporlama | okuma |
| getContactWithSearch | Grup, telefon numarası, ad ve kanal türüne göre filtrelenebilen kişi listesini alır. | raporlama | okuma |
| createContactGroup | Belirtilen ad ve isteğe bağlı takma adla yeni bir kişi grubu (liste) oluşturur. | raporlama | yazma |
| createContact | Belirtilen ayrıntılarla yeni bir kişi oluşturur. | raporlama | yazma |
| updateContact | contact_id ile tanımlanan mevcut bir kişiyi yeni ayrıntılarla günceller. | raporlama | yazma |
| deleteContactGroup | group_id ile tanımlanan belirli bir kişi grubunu (listeyi) siler. | raporlama | silme |
Başlarken
Ön Koşullar
- Node.js >= 16.0
- Sağlanmış bir Sinch Engage hesabı
- Claude Desktop (veya başka bir MCP istemcisi). Bu README Claude Desktop üzerine odaklanmıştır, ancak MCP sunucusu herhangi bir MCP istemcisiyle kullanılabilir.
API kimlik bilgileri
MCP araçları tarafından kullanılan API'leri kullanmak için aşağıdaki kimlik bilgilerine ihtiyacınız olacaktır:
SINCH_ENGAGE_API_KEYveSINCH_ENGAGE_API_SECRETSinch Engage Kimlik Bilgileri
MCP Sunucu Yapılandırması
Sinch Engage MCP sunucusu, çalıştırılacak bir NPM paketi olarak mevcuttur. Claude Desktop yapılandırma dosyasında (claude_desktop_config.json) nasıl ayarlanacağı aşağıda açıklanmıştır. Ortam değişkenlerini kendi kimlik bilgilerinizle ve bölgeyle (şu anda desteklenen EU ve AU) doldurmayı unutmayın:
{
"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"
}
}
}
}
MCP Sunucusunu Yerel Olarak Çalıştırma
Seçenek 1: Claude Desktop ile stdio kullanarak MCP sunucusunu başlatma
MCP sunucusunu Claude Desktop ile yerel olarak çalıştırmak için depoyu klonlamanız ve MCP sunucusunu derlemeniz gerekecektir. Bu seçenek yerel geliştirme ve test için kullanışlıdır.
Adım 1: Depoyu klonlayın
git clone https://github.com/messagemedia/sinch-engage-mcp-server.git
Adım 2: Bağımlılıkları yükleyin
cd sinch-engage-mcp-server
npm install
Adım 3: Claude Desktop yapılandırmasını ayarlayın
Sinch Engage kimlik bilgilerinizi ve bölgenizi (EU veya AU) sağlayabileceğiniz Claude Desktop yapılandırma dosyasında (claude_desktop_config.json) MCP sunucusunun nasıl yapılandırılacağına dair bir örnek aşağıda verilmiştir:
{
"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"
}
}
}
}
Adım 4: (İsteğe bağlı) MCP sunucusunda bulunan araçları filtreleyin
Çok fazla araç, daha büyük bağlam, daha yüksek token kullanımı ve LLM'nin doğru aracı seçmesi için daha fazla karışıklık anlamına gelir.
Claude Desktop yapılandırma seçeneklerinde MCP_TOOL_CATEGORIES sağlayarak MCP sunucusunda bulunan araçları filtreleyebilirsiniz.
Araçları izinlere göre filtrelemek istiyorsanız, yalnızca verileri okuyabilen, yazabilen veya silebilen araçları veya bunların herhangi bir kombinasyonunu seçmek için MCP_TOOL_MODES kullanabilirsiniz.