Voipstudio MCP

AI - Kecerdasan Buatan - VoIPstudio MCP Server

Server VoIPstudio MCP (Model Context Protocol) memberikan akses langsung dan aman kepada Claude AI 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 Inggris sederhana, tanpa memerlukan pengembangan khusus.

Tambahkan CX Addon dan setiap rekaman tiba dengan pra-pengayaan berisi transkrip, ringkasan, sentimen, item tindakan, dan skor CX. Ini secara drastis mengurangi pekerjaan AI yang perlu dilakukan Claude dan menjaga penggunaan token Anda tetap rendah serta biaya lebih dapat diprediksi.

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 tokennya.
2. Buka bagian Kunci API.
3. Masukkan nama untuk kunci — misalnya, Claude MCP.
4. Klik Tambah.
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 Tampilkan Detail.

Catatan: Kunci API tetap berlaku selama digunakan setidaknya sekali setiap 7 hari (batas waktu default). Atur batas waktu yang lebih lama (atau tanpa batas) jika diperlukan sebelum mengklik Tambah.

Lihat dokumentasi REST API

Menghubungkan ke Claude

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

URL server MCP

[!info] URL server MCP https://mcp.voipstudio.workers.dev/sse

Langkah-langkah (Claude.ai)

1. Di Claude.ai, buka Pengaturan → Integrasi (atau panel konektor, tergantung paket Anda).
2. Pilih Tambahkan server MCP kustom (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 mengonfirmasi berbagi data. Klik Selalu izinkan 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 yang tepat akan bervariasi antar platform. Cari opsi berlabel server MCP eksternal, MCP kustom, atau MCP jarak jauh di integrasi atau pengaturan 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 pada infrastrukturnya sendiri dengan biaya bulanan tetap tanpa biaya per panggilan dan tanpa batas transkripsi. Claude menerima intelijen 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

Field	Type	Description
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, sebaliknya, perintah 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 rekaman mencakup transkrip, ringkasan, sentimen, skor CX, dan linimasa. Tanpa addon, bidang-bidang ini mengembalikan null.

Parameter

Parameter	Type	Default	Description
filters	array	—	Objek filter — lihat Pemfilteran
limit	number	10	Rekaman per halaman (maks 1000)
page	number	1	Nomor halaman

Bidang respons

Field	Type	Description
id	number	ID rekaman unik
call_id	number	Tautan ke CDR call_id
timestamp	string	Mulai rekaman (UTC, YYYY-MM-DD HH:mm:ss)
caller	string	Nomor pemanggil
called	string	Nomor yang dipanggil
src_name	string	Nama agen (sumber)
dst_name	string	Nama tujuan
duration	number	Durasi dalam detik
type	string	I \= inbound, O \= outbound
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 pada Claude: "Tunjukkan semua rekaman dari minggu ini dengan 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

Call Detail Records – 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

Field	Type	Description
call_id	number	ID panggilan unik
calldate	string	Stempel waktu mulai panggilan (UTC)
src_name	string	Nama agen / pemanggil
dst_name	string	Nama tujuan
billsec	number	Detik yang ditagih
duration	number	Total detik termasuk dering
disposition	string	CONNECTED, NO ANSWER, BUSY, FAILED
charge	number	Biaya panggilan
type	string	I \= inbound, O \= outbound
src_ua	string	Perangkat sumber / user-agent softphone
labels	array	Tag kustom yang diterapkan di VoIPstudio

get_live_calls

Mengembalikan cuplikan waktu nyata dari semua panggilan aktif di akun Anda. Tidak ada parameter yang diperlukan.

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

get_voicemails

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

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

get_recording_audio

Mengembalikan URL unduhan langsung untuk audio MP3 dari rekaman tertentu.

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

[!info] Info URL audio memiliki batas waktu. Gunakan segera; jangan simpan dalam cache untuk waktu yang lama.

Pemfilteran & Penomoran Halaman

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

Property	Description
property	Nama bidang untuk difilter (mis. calldate, cx_score, src_name)
operator	eq, ne, lt, lte, gt, gte, in, like, notlike
value	String, angka, 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 terhubung

[{ "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

"Beri saya 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 rata-rata waktu penanganan, 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 tidak terjawab

"Daftarkan semua panggilan masuk yang tidak terjawab dari 24 jam terakhir dengan ID pemanggil, sehingga saya dapat memprioritaskan panggilan balik."

Tinjauan biaya & penagihan

"Ekstensi mana yang melakukan panggilan keluar paling mahal kuartal ini?"

Pemeriksaan operasi langsung

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

Efisiensi Token

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

Apa yang ditangani VoIPstudio (biaya bulanan tetap, panggilan tanpa batas):

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

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

Ini berarti Anda dapat meminta Claude menganalisis ratusan panggilan dalam satu sesi dengan biaya token yang jauh lebih kecil, menjadikan QA skala besar, analisis tren, dan laporan pembinaan agen praktis tanpa pengeluaran AI yang tidak dapat diprediksi.