Sinch Engage / MessageMedia MCP server
resmiServer 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
getDetailedMessageReportataugetSummaryMessageReport. - Mengelola grup kontak — Buat, lihat, atau hapus grup kontak (daftar) dengan
createContactGroup,getContactGroups, ataudeleteContactGroup. - Mencari dan memperbarui kontak — Temukan kontak berdasarkan grup, nomor telepon, atau nama, lalu perbarui detailnya melalui
getContactWithSearchdanupdateContact. - Melacak status laporan asinkron — Periksa kemajuan permintaan laporan asinkron menggunakan
getAsyncReportStatusdengan 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.
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
| Alat | Deskripsi | Kategori | Mode |
|---|---|---|---|
| sendMessage | Mengirim SMS ke nomor ponsel | messaging | write |
Pelaporan
| Alat | Deskripsi | Kategori | Mode |
|---|---|---|---|
| getDetailedMessageReport | Menghasilkan laporan terperinci tentang pesan terkirim dan diterima untuk rentang tanggal tertentu, dengan filter opsional untuk arah, akun, metadata, dan pengelompokan. | reporting | read |
| getSummaryMessageReport | Menghasilkan laporan ringkasan tentang pesan terkirim dan diterima untuk rentang tanggal tertentu, dengan filter opsional untuk arah, akun, dan pengelompokan. | reporting | read |
| getSummaryInsightMessageReport | Mengambil laporan ringkasan yang telah dikompilasi sebelumnya tentang pesan terkirim dan diterima untuk rentang tanggal tertentu, dengan filter opsional untuk arah, akun, dan pengelompokan. | reporting | read |
| getAsyncReportStatus | Mengambil status permintaan laporan asinkron berdasarkan report_id. | reporting | read |
| getAsyncReportFields | Mengambil daftar bidang yang tersedia untuk ekspor laporan terperinci asinkron. | reporting | read |
| requestAsyncDetailedMessageReport | Meminta laporan terperinci asinkron tentang pesan terkirim dan diterima untuk rentang tanggal tertentu, dengan opsi pengiriman untuk format laporan dan tujuan. | reporting | read |
Kontak
| Alat | Deskripsi | Kategori | Mode |
|---|---|---|---|
| getContactGroups | Mengambil daftar grup kontak (daftar) yang ditautkan ke akun secara terbagi halaman. | reporting | read |
| getContactGroupDetails | Mengambil detail untuk grup kontak (daftar) tertentu yang diidentifikasi oleh group_id. | reporting | read |
| getContactWithSearch | Mengambil daftar kontak, yang dapat difilter berdasarkan grup, nomor telepon, nama, dan jenis saluran. | reporting | read |
| createContactGroup | Membuat grup kontak (daftar) baru dengan nama yang ditentukan dan alias opsional. | reporting | write |
| createContact | Membuat kontak baru dengan detail yang ditentukan. | reporting | write |
| updateContact | Memperbarui kontak yang ada yang diidentifikasi oleh contact_id dengan detail baru. | reporting | write |
| deleteContactGroup | Menghapus grup kontak (daftar) tertentu yang diidentifikasi oleh group_id. | reporting | delete |
Memulai
Prasyarat
- Node.js >= 16.0
- Akun Sinch Engage yang telah disediakan
- Claude Desktop (atau klien MCP lainnya). README ini berfokus pada Claude Desktop, tetapi server MCP dapat digunakan dengan klien MCP apa pun.
Kredensial API
Untuk menggunakan API yang digunakan oleh alat MCP, Anda memerlukan kredensial berikut:
SINCH_ENGAGE_API_KEYdanSINCH_ENGAGE_API_SECRETKredensial Sinch Engage
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