Sinch Engage / MessageMedia MCP server

resmi

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

Dokumentasi

Sinch Engage MCP Server

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

Ikhtisar Alat

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

Pengiriman Pesan

Alat	Deskripsi	Kategori	Mode
sendMessage	Mengirim SMS ke nomor ponsel	pengiriman pesan	tulis

Pelaporan

Alat	Deskripsi	Kategori	Mode
getDetailedMessageReport	Menghasilkan laporan terperinci dari pesan yang dikirim dan diterima untuk rentang tanggal tertentu, dengan filter opsional untuk arah, akun, metadata, dan pengelompokan.	pelaporan	baca
getSummaryMessageReport	Menghasilkan laporan ringkasan dari pesan yang dikirim dan diterima untuk rentang tanggal tertentu, dengan filter opsional untuk arah, akun, dan pengelompokan.	pelaporan	baca
getSummaryInsightMessageReport	Mengambil laporan ringkasan pra-kompilasi dari pesan yang dikirim dan diterima untuk rentang tanggal tertentu, dengan filter opsional untuk arah, akun, dan pengelompokan.	pelaporan	baca
getAsyncReportStatus	Mengambil status permintaan laporan asinkron berdasarkan report_id.	pelaporan	baca
getAsyncReportFields	Mengambil daftar bidang yang tersedia untuk ekspor laporan terperinci asinkron.	pelaporan	baca
requestAsyncDetailedMessageReport	Meminta laporan terperinci asinkron dari pesan yang dikirim dan diterima untuk rentang tanggal tertentu, dengan opsi pengiriman untuk format laporan dan tujuan.	pelaporan	baca

Kontak

Alat	Deskripsi	Kategori	Mode
getContactGroups	Mengambil daftar halaman grup kontak (daftar) yang terkait dengan akun.	pelaporan	baca
getContactGroupDetails	Mengambil detail untuk grup kontak (daftar) tertentu yang diidentifikasi oleh group_id.	pelaporan	baca
getContactWithSearch	Mengambil daftar kontak, dapat difilter berdasarkan grup, nomor telepon, nama, dan jenis saluran.	pelaporan	baca
createContactGroup	Membuat grup kontak (daftar) baru dengan nama yang ditentukan dan alias opsional.	pelaporan	tulis
createContact	Membuat kontak baru dengan detail yang ditentukan.	pelaporan	tulis
updateContact	Memperbarui kontak yang ada yang diidentifikasi oleh contact_id dengan detail baru.	pelaporan	tulis
deleteContactGroup	Menghapus grup kontak (daftar) tertentu yang diidentifikasi oleh group_id.	pelaporan	hapus

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_KEY dan SINCH_ENGAGE_API_SECRET Kredensial Sinch Engage

Konfigurasi Server MCP

Server MCP Sinch Engage tersedia sebagai paket NPM untuk dieksekusi. 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: Atur 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 Sinch Engage dan wilayah 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 ketiganya