Sinch Engage / MessageMedia MCP server

resmi

Server MCP Sinch Engage (Sinch MessageMedia di AU), yang menyediakan API Sinch Engage sebagai alat MCP.

Apa yang bisa Anda lakukan dengan Sinch Engage MessageMedia MCP?

  • Mengirim pesan SMS — Minta asisten Anda untuk mengirim SMS ke nomor ponsel mana pun dalam format E.164 melalui sendMessage.
  • Membuat laporan pesan — Minta laporan terperinci atau ringkasan dari pesan terkirim/diterima untuk rentang tanggal menggunakan getDetailedMessageReport atau getSummaryMessageReport.
  • Mengelola grup kontak — Buat, lihat, atau hapus grup kontak (daftar) dengan createContactGroup, getContactGroups, atau deleteContactGroup.
  • Mencari dan memperbarui kontak — Temukan kontak berdasarkan grup, nomor telepon, atau nama, lalu perbarui detailnya melalui getContactWithSearch dan updateContact.
  • Melacak status laporan asinkron — Periksa kemajuan permintaan laporan asinkron menggunakan getAsyncReportStatus dengan ID laporan.

Dokumentasi

Server MCP Sinch Engage

Pemberitahuan Depresiasi. Server MCP ini sudah tidak digunakan lagi dan akan mencapai akhir masa pakainya pada 30 November 2026. Jangan gunakan untuk integrasi baru. Ikuti Connect to the Sinch Engage MCP (AU) untuk server penggantinya. Paket dan repositori ini dipertahankan untuk instalasi yang sudah ada hingga tanggal tersebut, dan tidak ada pengembangan fitur lebih lanjut yang direncanakan.

Latest Release

Repositori ini berisi kode sumber untuk server MCP Sinch Engage (Sinch MessageMedia di AU), yang menyediakan API Sinch Engage sebagai alat MCP.

Ringkasan Alat

Berikut adalah daftar alat yang tersedia di server MCP (semua nomor telepon harus diberikan dalam format E.164, misalnya, +61400000000 untuk Australia).

Pesan

AlatDeskripsiKategoriMode
sendMessageMengirim SMS ke nomor ponselmessagingwrite

Pelaporan

AlatDeskripsiKategoriMode
getDetailedMessageReportMenghasilkan laporan terperinci tentang pesan terkirim dan diterima untuk rentang tanggal tertentu, dengan filter opsional untuk arah, akun, metadata, dan pengelompokan.reportingread
getSummaryMessageReportMenghasilkan laporan ringkasan tentang pesan terkirim dan diterima untuk rentang tanggal tertentu, dengan filter opsional untuk arah, akun, dan pengelompokan.reportingread
getSummaryInsightMessageReportMengambil laporan ringkasan yang telah dikompilasi sebelumnya tentang pesan terkirim dan diterima untuk rentang tanggal tertentu, dengan filter opsional untuk arah, akun, dan pengelompokan.reportingread
getAsyncReportStatusMengambil status permintaan laporan asinkron berdasarkan report_id.reportingread
getAsyncReportFieldsMengambil daftar bidang yang tersedia untuk ekspor laporan terperinci asinkron.reportingread
requestAsyncDetailedMessageReportMeminta laporan terperinci asinkron tentang pesan terkirim dan diterima untuk rentang tanggal tertentu, dengan opsi pengiriman untuk format laporan dan tujuan.reportingread

Kontak

AlatDeskripsiKategoriMode
getContactGroupsMengambil daftar grup kontak (daftar) yang ditautkan ke akun secara terbagi halaman.reportingread
getContactGroupDetailsMengambil detail untuk grup kontak (daftar) tertentu yang diidentifikasi oleh group_id.reportingread
getContactWithSearchMengambil daftar kontak, yang dapat difilter berdasarkan grup, nomor telepon, nama, dan jenis saluran.reportingread
createContactGroupMembuat grup kontak (daftar) baru dengan nama yang ditentukan dan alias opsional.reportingwrite
createContactMembuat kontak baru dengan detail yang ditentukan.reportingwrite
updateContactMemperbarui kontak yang ada yang diidentifikasi oleh contact_id dengan detail baru.reportingwrite
deleteContactGroupMenghapus grup kontak (daftar) tertentu yang diidentifikasi oleh group_id.reportingdelete

Memulai

Prasyarat

Kredensial API

Untuk menggunakan API yang digunakan oleh alat MCP, Anda memerlukan kredensial berikut:

Konfigurasi Server MCP

Server MCP Sinch Engage tersedia sebagai paket NPM untuk dijalankan. Berikut cara mengaturnya di file konfigurasi Claude Desktop (claude_desktop_config.json). Ingatlah untuk mengisi variabel lingkungan dengan kredensial Anda sendiri dan wilayah (saat ini didukung EU & 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"
      }
    }
  }
}

Menjalankan Server MCP secara Lokal

Opsi 1: Mulai server MCP dengan stdio menggunakan Claude Desktop

Untuk menjalankan server MCP secara lokal dengan Claude Desktop, Anda perlu mengkloning repositori dan membangun server MCP. Opsi ini berguna untuk pengembangan dan pengujian lokal.

Langkah 1: Kloning repositori

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

Langkah 2: Instal dependensi

cd sinch-engage-mcp-server
npm install

Langkah 3: Siapkan konfigurasi Claude Desktop

Berikut adalah contoh cara mengonfigurasi server MCP di file konfigurasi Claude Desktop (claude_desktop_config.json) di mana Anda dapat memberikan kredensial dan wilayah Sinch Engage Anda (EU atau 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"
      }
    }
  }
}

Langkah 4: (Opsional) Filter alat yang tersedia di server MCP

Terlalu banyak alat berarti konteks lebih besar, berarti penggunaan token lebih tinggi dan lebih banyak kebingungan bagi LLM untuk memilih alat yang tepat untuk digunakan.
Anda dapat memfilter alat yang tersedia di server MCP dengan menyediakan MCP_TOOL_CATEGORIES di opsi konfigurasi Claude Desktop.

Jika Anda ingin memfilter alat berdasarkan izin, Anda dapat menggunakan MCP_TOOL_MODES untuk hanya memilih alat yang dapat membaca, menulis, atau menghapus data atau kombinasi apa pun dari semuanya