Sinch Engage / MessageMedia MCP server

Sinch Engage MCP Sunucusu

Bu depo, Sinch Engage (Avustralya'da Sinch MessageMedia) MCP sunucusunun kaynak kodunu içerir ve Sinch Engage API'lerini MCP araçları olarak sunar.

Araçlara Genel Bakış

MCP sunucusunda bulunan araçların listesi aşağıdadır (tüm telefon numaraları E.164 formatında verilmelidir, ö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 bir tarih aralığı için gönderilen ve alınan mesajların ayrıntılı bir raporunu oluşturur; yön, hesaplar, meta veriler ve gruplandırma için isteğe bağlı filtreler içerir.	raporlama	okuma
getSummaryMessageReport	Belirtilen bir tarih aralığı için gönderilen ve alınan mesajların özet bir raporunu oluşturur; yön, hesaplar ve gruplandırma için isteğe bağlı filtreler içerir.	raporlama	okuma
getSummaryInsightMessageReport	Belirtilen bir tarih aralığı için gönderilen ve alınan mesajların önceden derlenmiş bir özet raporunu getirir; yön, hesaplar ve gruplandırma için isteğe bağlı filtreler içerir.	raporlama	okuma
getAsyncReportStatus	report_id ile bir eşzamansız rapor isteğinin durumunu alır.	raporlama	okuma
getAsyncReportFields	Eşzamansız ayrıntılı rapor dışa aktarımı için kullanılabilir alanların listesini alır.	raporlama	okuma
requestAsyncDetailedMessageReport	Belirtilen bir tarih aralığı için gönderilen ve alınan mesajların eşzamansız ayrıntılı bir 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) sayfalı bir 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 bir kişi listesi alır.	raporlama	okuma
createContactGroup	Belirtilen ad ve isteğe bağlı takma ad ile 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
• Hazırlanmış 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 istemcisi ile 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 olacak:

• SINCH_ENGAGE_API_KEY ve SINCH_ENGAGE_API_SECRET Sinch Engage Kimlik Bilgileri

MCP Sunucu Yapılandırması

Sinch Engage MCP sunucusu, çalıştırılmak üzere bir NPM paketi olarak mevcuttur. Claude Desktop yapılandırma dosyasında (claude_desktop_config.json) nasıl kurulacağı aşağıda açıklanmıştır. Ortam değişkenlerini kendi kimlik bilgileriniz ve bölgenizle (şu anda EU & AU desteklenmektedir) 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 kullanılacak doğru aracı seçmesinde 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 isterseniz, yalnızca veri okuyabilen, yazabilen veya silebilen araçları ya da bunların herhangi bir kombinasyonunu seçmek için MCP_TOOL_MODES kullanabilirsiniz