Voipstudio MCP Server

AI - Kecerdasan Buatan - Server MCP VoIPstudio¶

Server MCP (Model Context Protocol) VoIPstudio memberikan Claude AI akses langsung dan aman ke data akun VoIPstudio Anda, termasuk rekaman, CDR, panggilan langsung, dan pesan suara. Setelah terhubung, Claude dapat menanyakan panggilan, menganalisis pola, mengungkap masalah kinerja agen, dan menghasilkan laporan QA dalam bahasa sederhana, tanpa perlu pengembangan kustom.

Tambahkan CX Addon dan setiap rekaman tiba dengan pra-pemrosesan berupa transkrip, ringkasan, sentimen, item tindakan, dan skor CX. Ini secara drastis mengurangi kerja AI yang perlu dilakukan Claude, menjaga penggunaan token tetap rendah dan biaya lebih terprediksi.

Mendapatkan kunci API¶

Server MCP mengautentikasi menggunakan token API VoIPstudio. Setiap kunci dibatasi untuk pengguna tertentu, sehingga Claude hanya dapat mengakses data yang dapat diakses oleh pengguna tersebut.

Untuk membuat kunci:

1. Di dasbor admin, buka pengguna yang ingin Anda buatkan token.
2. Buka bagian API Keys.
3. Masukkan nama untuk kunci — misalnya, Claude MCP.
4. Klik Add.
5. Klik ikon mata untuk menampilkan kunci API / user_token. Salin nilai ini.
6. Untuk melihat detail lebih lanjut atau menghapus kunci, klik ikon roda gigi dan pilih Show Details.

Catatan: Kunci API tetap berlaku selama digunakan setidaknya sekali setiap 7 hari (waktu tunggu default). Atur waktu tunggu yang lebih lama (atau tidak terbatas) jika diperlukan sebelum mengklik Add.

Lihat dokumentasi REST API

Menghubungkan ke Claude¶

VoIPstudio saat ini belum terdaftar di direktori konektor Claude.ai. Anda menambahkannya secara manual sebagai server MCP kustom.

URL server MCP¶

URL server MCP

https://mcp.voipstudio.workers.dev/sse

Langkah-langkah (Claude.ai)¶

1. Di Claude.ai, buka Settings → Integrations (atau panel konektor, tergantung paket Anda).
2. Pilih Add custom MCP server (atau yang setara).
3. Masukkan URL server MCP di atas.
4. Saat diminta autentikasi, berikan kunci API VoIPstudio Anda.
5. Simpan dan otorisasi koneksi.

Claude sekarang dapat memanggil alat VoIPstudio dalam percakapan apa pun. Pertama kali alat dipanggil dalam sesi, Claude akan meminta Anda untuk mengonfirmasi berbagi data. Klik Always allow untuk melewati permintaan ini di sesi mendatang.

Anthropic API (untuk pengembang)¶

const response = await fetch("https://api.anthropic.com/v1/messages", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-Api-Key": "YOUR_ANTHROPIC_API_KEY"
  },
  body: JSON.stringify({
    model: "claude-sonnet-4-6",
    max_tokens: 1024,
    mcp_servers: [{
      type: "url",
      url: "https://mcp.voipstudio.workers.dev/sse",
      name: "voipstudio",
      authorization_token: "YOUR_VOIPSTUDIO_API_KEY"
    }],
    messages: [{
      role: "user",
      content: "Show me agents with a CX score below 6 this week"
    }]
  })
});

Menghubungkan ke platform AI lainnya¶

Sebagian besar platform AI yang mendukung MCP eksternal dapat terhubung ke server MCP VoIPstudio menggunakan URL dan kunci API yang sama. Langkah konfigurasi pastinya akan bervariasi tergantung platform. Cari opsi berlabel external MCP server, custom MCP, atau remote MCP di pengaturan atau integrasi platform Anda.

CX Addon¶

Tanpa CX Addon, rekaman tiba sebagai metadata mentah. Claude harus mentranskripsi dan menganalisis setiap panggilan sendiri, menghabiskan token yang signifikan per rekaman.

Dengan CX Addon, VoIPstudio menangani transkripsi, peringkasan, analisis sentimen, ekstraksi tindakan, dan penilaian CX di infrastrukturnya sendiri dengan biaya bulanan tetap tanpa biaya per panggilan dan tanpa batas transkripsi. Claude menerima intelijen yang sudah jadi — siap untuk dianalisis segera.

Tanpa CX Addon	Dengan CX Addon
Transkrip	Claude harus mengambil audio dan mentranskripsi/menerjemahkan	✓ Termasuk, dengan diarisasi pembicara
Ringkasan	Claude harus membuat	✓ Termasuk
Sentimen	Claude harus menyimpulkan	✓ Termasuk
Item tindakan	Claude harus mengekstrak	✓ Termasuk
Skor CX	Tidak tersedia	✓ 1–10 pada setiap panggilan
Perkiraan token/panggilan	10.000–15.000	300–500
Model biaya	Pengeluaran AI variabel	Langganan bulanan tetap

Bidang yang dibuka oleh CX Addon¶

Bidang	Tipe	Deskripsi
transcript	string	Transkrip lengkap tingkat kata
transcript_speakers	object	Segmen transkrip dengan diarisasi pembicara
summary	string	Ringkasan singkat hasil panggilan
sentiment	string	Sentimen pelanggan: positive, neutral, negative
cx_score	number (1–10)	Skor pengalaman pelanggan
metadata.timeline	array	Momen penting dan item tindakan yang diekstrak dari panggilan

Referensi Alat¶

Kesederhanaan integrasi MCP berarti API yang kompleks tidak perlu dipahami dan, sebagai gantinya, prompt sederhana dapat membantu platform AI memahami data yang disediakan dari VoIPstudio dan membalas dengan respons yang sesuai.

Namun, beberapa pengguna yang lebih teknis mungkin ingin tahu apa yang terjadi "di balik layar", jadi di bawah ini adalah panduan referensi untuk beberapa fungsi server MCP.

get_recordings¶

Mengembalikan rekaman panggilan. Dengan CX Addon aktif, setiap catatan mencakup transkrip, ringkasan, sentimen, skor CX, dan linimasa. Tanpa addon, bidang-bidang ini mengembalikan null.

Parameter

Parameter	Tipe	Default	Deskripsi
filters	array	—	Objek filter — lihat Pemfilteran
limit	number	10	Catatan per halaman (maks 1000)
page	number	1	Nomor halaman

Bidang respons

Bidang	Tipe	Deskripsi
id	number	ID rekaman unik
call_id	number	Tertaut ke call_id CDR
timestamp	string	Mulai rekaman (UTC, YYYY-MM-DD HH:mm:ss)
caller	string	Nomor pihak penelepon
called	string	Nomor pihak yang dipanggil
src_name	string	Nama agen (sumber)
dst_name	string	Nama tujuan
duration	number	Durasi dalam detik
type	string	I \= masuk, O \= keluar
context	string	Konteks panggilan (mis. LOCAL_USER, QUEUE)
transcript	string	null
transcript_speakers	object	null
summary	string	null
sentiment	string	null
cx_score	number	null
metadata.timeline	array	null

Contoh – Skor CX rendah minggu ini

Tanyakan Claude: "Tampilkan semua rekaman dari minggu ini di mana skor CX di bawah 6, dikelompokkan berdasarkan agen, dengan ringkasan apa yang salah pada setiap panggilan."

Claude memanggil alat dengan:

{
  "filters": [
    { "property": "calldate", "operator": "gte", "value": "2026-06-09 00:00:00" },
    { "property": "cx_score",  "operator": "lt",  "value": 6 }
  ],
  "limit": 100
}

get_cdrs¶

Catatan Detail Panggilan – log mentah dari setiap segmen panggilan. Gunakan untuk statistik volume, analisis biaya, distribusi durasi, dan ringkasan aktivitas agen. Tersedia tanpa CX Addon.

Parameter: sama dengan get_recordings (filters, limit, page)

Bidang respons utama

Bidang	Tipe	Deskripsi
call_id	number	Pengenal panggilan unik
calldate	string	Stempel waktu mulai panggilan (UTC)
src_name	string	Nama agen / penelepon
dst_name	string	Nama tujuan
billsec	number	Detik yang dapat ditagih
duration	number	Total detik termasuk dering
disposition	string	CONNECTED, NO ANSWER, BUSY, FAILED
charge	number	Biaya panggilan
type	string	I \= masuk, O \= keluar
src_ua	string	Perangkat sumber / user-agent softphone
labels	array	Tag kustom yang diterapkan di VoIPstudio

get_live_calls¶

Mengembalikan cuplikan real-time dari semua panggilan aktif di akun Anda. Tidak diperlukan parameter.

Contoh: "Berapa banyak panggilan yang sedang berlangsung saat ini, dan agen mana yang sedang menanganinya?"

get_voicemails¶

Mengambil pesan suara. Antarmuka filters, limit, dan page yang sama seperti alat lainnya.

Bidang utama yang dapat difilter: src, dst, calldate, duration, listened

get_recording_audio¶

Mengembalikan URL unduhan langsung untuk audio MP3 dari rekaman tertentu.

Parameter: id (number) — bidang id dari respons get_recordings.

Info

URL audio memiliki batas waktu. Gunakan segera; jangan disimpan dalam cache untuk waktu yang lama.

Pemfilteran & Paginasi¶

Semua alat daftar menerima array filters opsional. Setiap objek filter memiliki tiga properti:

Properti	Deskripsi
property	Nama bidang untuk difilter (mis. calldate, cx_score, src_name)
operator	eq, ne, lt, lte, gt, gte, in, like, notlike
value	String, number, atau array (untuk operator in)

Contoh umum¶

Rentang tanggal

[
  { "property": "calldate", "operator": "gte", "value": "2026-06-01 00:00:00" },
  { "property": "calldate", "operator": "lte", "value": "2026-06-30 23:59:59" }
]

Ambang skor CX

[{ "property": "cx_score", "operator": "gte", "value": 8 }]

Agen tertentu

[{ "property": "src_name", "operator": "eq", "value": "Jane Ryder" }]

Hanya panggilan tersambung

[{ "property": "disposition", "operator": "eq", "value": "CONNECTED" }]

Panggilan masuk lebih dari 5 menit

[
  { "property": "type",     "operator": "eq",  "value": "I" },
  { "property": "billsec",  "operator": "gt",  "value": 300 }
]

Kasus Penggunaan¶

Laporan QA agen¶

"Berikan ringkasan QA untuk setiap agen bulan ini — rata-rata skor CX, tema keluhan umum, dan tiga panggilan dengan skor terendah beserta ringkasannya."

Statistik volume pusat panggilan¶

"Berapa volume panggilan kami per hari minggu ini? Berapa waktu penanganan rata-rata kami, dan berapa banyak panggilan yang tidak terjawab?"

Analisis tren sentimen¶

"Apakah sentimen pelanggan membaik atau menurun dibandingkan bulan lalu? Topik panggilan mana yang berkorelasi dengan sentimen negatif?"

Daftar tindak lanjut panggilan tak terjawab¶

"Daftarkan semua panggilan masuk tak terjawab dari 24 jam terakhir dengan ID penelepon, sehingga saya dapat memprioritaskan panggilan balik."

Tinjauan biaya & penagihan¶

"Ekstensi mana yang melakukan panggilan keluar termahal kuartal ini?"

Pemeriksaan operasi langsung¶

"Berapa banyak agen yang sedang dalam panggilan, dan apakah ada panggilan yang telah berlangsung lebih dari 20 menit?"

Efisiensi Token¶

Setiap panggilan yang dianalisis Claude tanpa CX Addon mengharuskan Claude memproses konten audio dan menghasilkan transkripsi serta analisisnya sendiri. CX Addon sepenuhnya mengalihkan ini ke VoIPstudio:

Apa yang ditangani VoIPstudio (biaya bulanan tetap, panggilan tak terbatas):

• Transkripsi audio
• Diarisasi pembicara
• Peringkasan panggilan
• Klasifikasi sentimen
• Ekstraksi item tindakan
• Penilaian CX

Apa yang diterima Claude: Bidang teks terstruktur yang bersih, siap untuk penalaran, perbandingan, dan pelaporan.

Ini berarti Anda dapat meminta Claude menganalisis ratusan panggilan dalam satu sesi dengan biaya token yang jauh lebih rendah, membuat QA skala besar, analisis tren, dan laporan pelatihan agen menjadi praktis tanpa pengeluaran AI yang tidak terprediksi.