Sinch Engage / MessageMedia MCP server

resmi

Sinch 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, sendMessage aracılığıyla E.164 formatındaki herhangi bir mobil numaraya SMS göndermesini isteyin.
  • Mesaj raporları oluştur — getDetailedMessageReport veya getSummaryMessageReport kullanarak 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, getContactGroups veya deleteContactGroup ile 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 getContactWithSearch ve updateContact ile bilgilerini güncelleyin.
  • Zaman uyumsuz rapor durumunu izle — getAsyncReportStatus ile 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.

Latest Release

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çıklamaKategoriMod
sendMessageBir mobil numaraya SMS gönderirmesajlaşmayazma

Raporlama

AraçAçıklamaKategoriMod
getDetailedMessageReportBelirtilen 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.raporlamaokuma
getSummaryMessageReportBelirtilen 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.raporlamaokuma
getSummaryInsightMessageReportBelirtilen 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.raporlamaokuma
getAsyncReportStatusreport_id ile asenkron bir rapor talebinin durumunu alır.raporlamaokuma
getAsyncReportFieldsAsenkron ayrıntılı rapor dışa aktarımı için mevcut alanların listesini alır.raporlamaokuma
requestAsyncDetailedMessageReportBelirtilen 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.raporlamaokuma

Kişiler

AraçAçıklamaKategoriMod
getContactGroupsHesapla ilişkili kişi gruplarının (listelerin) sayfalanmış listesini alır.raporlamaokuma
getContactGroupDetailsgroup_id ile tanımlanan belirli bir kişi grubunun (listenin) ayrıntılarını alır.raporlamaokuma
getContactWithSearchGrup, telefon numarası, ad ve kanal türüne göre filtrelenebilen kişi listesini alır.raporlamaokuma
createContactGroupBelirtilen ad ve isteğe bağlı takma adla yeni bir kişi grubu (liste) oluşturur.raporlamayazma
createContactBelirtilen ayrıntılarla yeni bir kişi oluşturur.raporlamayazma
updateContactcontact_id ile tanımlanan mevcut bir kişiyi yeni ayrıntılarla günceller.raporlamayazma
deleteContactGroupgroup_id ile tanımlanan belirli bir kişi grubunu (listeyi) siler.raporlamasilme

Başlarken

Ön Koşullar

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:

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.