Voipstudio MCP

AI - Yapay Zeka - VoIPstudio MCP Sunucusu

VoIPstudio MCP (Model Context Protocol) sunucusu, Claude AI'ye VoIPstudio hesap verilerinize — kayıtlar, CDR'ler, canlı çağrılar ve sesli mesajlar dahil — doğrudan ve güvenli erişim sağlar. Bağlandıktan sonra Claude, özel geliştirme gerektirmeden çağrıları sorgulayabilir, kalıpları analiz edebilir, temsilci performans sorunlarını ortaya çıkarabilir ve düz İngilizce QA raporları oluşturabilir.

CX Eklentisini ekleyin; her kayıt, transkript, özet, duygu analizi, aksiyon maddeleri ve CX puanı ile önceden zenginleştirilmiş olarak gelir. Bu, Claude'un yapması gereken AI işini önemli ölçüde azaltır, token kullanımınızı düşük ve maliyetlerinizi daha öngörülebilir tutar.

API anahtarı alma

MCP sunucusu, bir VoIPstudio API token'ı kullanarak kimlik doğrular. Her anahtar belirli bir kullanıcıya göre kapsamlandırılır; bu nedenle Claude yalnızca o kullanıcının erişebildiği verilere erişebilir.

Anahtar oluşturmak için:

1. Yönetici panelinde, token oluşturmak istediğiniz kullanıcıyı açın.
2. API Anahtarları bölümüne gidin.
3. Anahtar için bir ad girin — örneğin, Claude MCP.
4. Ekle'ye tıklayın.
5. API anahtarını / user_token değerini görmek için göz simgesine tıklayın. Bu değeri kopyalayın.
6. Daha fazla ayrıntı görüntülemek veya anahtarı silmek için dişli simgesine tıklayın ve Ayrıntıları Göster'i seçin.

Not: API anahtarı, en az 7 günde bir (varsayılan zaman aşımı) kullanıldığı sürece geçerliliğini korur. Gerekirse, Ekle'ye tıklamadan önce daha uzun bir zaman aşımı (veya sınırsız) ayarlayın.

REST API belgelerine bakın

Claude'a bağlanma

VoIPstudio şu anda Claude.ai bağlayıcı dizininde listelenmemiştir. Özel bir MCP sunucusu olarak manuel olarak eklersiniz.

MCP sunucu URL'si

[!info] MCP sunucu URL'si https://mcp.voipstudio.workers.dev/sse

Adımlar (Claude.ai)

1. Claude.ai'de Ayarlar → Entegrasyonlar'a gidin (veya planınıza bağlı olarak bağlayıcılar paneline).
2. Özel MCP sunucusu ekle'yi (veya eşdeğerini) seçin.
3. Yukarıdaki MCP sunucu URL'sini girin.
4. Kimlik doğrulama istendiğinde VoIPstudio API anahtarınızı sağlayın.
5. Bağlantıyı kaydedin ve yetkilendirin.

Claude artık herhangi bir konuşmada VoIPstudio araçlarını çağırabilir. Bir oturumda bir araç ilk kez çağrıldığında, Claude sizden veri paylaşımını onaylamanızı isteyecektir. Gelecekteki oturumlarda bu istemi atlamak için Her zaman izin ver'e tıklayın.

Anthropic API (geliştiriciler için)

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"
    }]
  })
});

Diğer AI platformlarına bağlanma

Harici MCP'leri destekleyen çoğu AI platformu, aynı URL ve API anahtarını kullanarak VoIPstudio MCP sunucusuna bağlanabilir. Kesin yapılandırma adımları platforma göre değişir. Platformunuzun entegrasyonlar veya ayarlar bölümünde harici MCP sunucusu, özel MCP veya uzak MCP etiketli bir seçenek arayın.

CX Eklentisi

CX Eklentisi olmadan kayıtlar ham meta veri olarak gelir. Claude'un her çağrıyı kendisinin yazıya dökmesi ve analiz etmesi gerekir; bu da kayıt başına önemli miktarda token tüketir.

CX Eklentisi ile VoIPstudio, transkripsiyon, özetleme, duygu analizi, aksiyon çıkarma ve CX puanlamasını kendi altyapısında sabit aylık maliyetle, çağrı başına ücret ve transkripsiyon limiti olmadan gerçekleştirir. Claude, anında akıl yürütmeye hazır, işlenmiş zekayı alır.

	CX Eklentisi Olmadan	CX Eklentisi İle
Transkript	Claude sesi almalı ve yazıya dökmeli/çevirmeli	✓ Dahil, konuşmacı ayrımlı
Özet	Claude oluşturmalı	✓ Dahil
Duygu	Claude çıkarım yapmalı	✓ Dahil
Aksiyon maddeleri	Claude çıkarmalı	✓ Dahil
CX puanı	Kullanılamaz	✓ Her çağrıda 1–10
Yaklaşık token/çağrı	10.000–15.000	300–500
Maliyet modeli	Değişken AI harcaması	Sabit aylık abonelik

CX Eklentisi tarafından açılan alanlar

Alan	Tür	Açıklama
transcript	string	Kelime düzeyinde tam transkript
transcript_speakers	object	Konuşmacı ayrımlı transkript bölümleri
summary	string	Çağrı sonucunun kısa özeti
sentiment	string	Müşteri duygusu: positive, neutral, negative
cx_score	number (1–10)	Müşteri deneyimi puanı
metadata.timeline	array	Çağrıdan çıkarılan önemli anlar ve aksiyon maddeleri

Araç Referansı

MCP entegrasyonunun basitliği, karmaşık API'lerin anlaşılmasına gerek olmadığı ve bunun yerine basit istemlerin AI platformunun VoIPstudio'dan sağlanan verileri anlamlandırmasına ve uygun bir yanıtla karşılık vermesine yardımcı olabileceği anlamına gelir.

Ancak, bazı daha teknik kullanıcılar "perde arkasında" neler olup bittiğini bilmek isteyebilir; bu nedenle aşağıda MCP sunucu işlevlerinden bazıları için bir referans kılavuzu bulunmaktadır.

get_recordings

Çağrı kayıtlarını döndürür. CX Eklentisi etkinken her kayıt, transkript, özet, duygu, CX puanı ve zaman çizelgesini içerir. Eklenti olmadan bu alanlar null döndürür.

Parametreler

Parametre	Tür	Varsayılan	Açıklama
filters	array	—	Filtre nesneleri — Filtreleme bölümüne bakın
limit	number	10	Sayfa başına kayıt (maks. 1000)
page	number	1	Sayfa numarası

Yanıt alanları

Alan	Tür	Açıklama
id	number	Benzersiz kayıt kimliği
call_id	number	CDR call_id bağlantısı
timestamp	string	Kayıt başlangıcı (UTC, YYYY-MM-DD HH:mm:ss)
caller	string	Arayan taraf numarası
called	string	Aranan taraf numarası
src_name	string	Temsilci adı (kaynak)
dst_name	string	Hedef adı
duration	number	Saniye cinsinden süre
type	string	I \= gelen, O \= giden
context	string	Çağrı bağlamı (örn. LOCAL_USER, QUEUE)
transcript	string	null
transcript_speakers	object	null
summary	string	null
sentiment	string	null
cx_score	number	null
metadata.timeline	array	null

Örnek – Bu hafta düşük CX puanları

Claude'a sorun: "Bu hafta CX puanı 6'nın altında olan tüm kayıtları göster, temsilciye göre gruplandır ve her çağrıda neyin yanlış gittiğine dair bir özetle."

Claude aracı şu şekilde çağırır:

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

get_cdrs

Çağrı Ayrıntı Kayıtları – her çağrı ayağının ham günlüğü. Hacim istatistikleri, maliyet analizi, süre dağılımları ve temsilci etkinlik özetleri için kullanın. CX Eklentisi olmadan kullanılabilir.

Parametreler: get_recordings ile aynı (filters, limit, page)

Temel yanıt alanları

Alan	Tür	Açıklama
call_id	number	Benzersiz çağrı tanımlayıcısı
calldate	string	Çağrı başlangıç zaman damgası (UTC)
src_name	string	Temsilci / arayan adı
dst_name	string	Hedef adı
billsec	number	Faturalandırılabilir saniyeler
duration	number	Zil sesi dahil toplam saniyeler
disposition	string	CONNECTED, NO ANSWER, BUSY, FAILED
charge	number	Çağrı maliyeti
type	string	I \= gelen, O \= giden
src_ua	string	Kaynak cihaz / softphone kullanıcı aracısı
labels	array	VoIPstudio'da uygulanan özel etiketler

get_live_calls

Hesabınızdaki tüm aktif çağrıların gerçek zamanlı anlık görüntüsünü döndürür. Parametre gerekmez.

Örnek: "Şu anda kaç çağrı devam ediyor ve hangi temsilciler bu çağrılarda?"

get_voicemails

Sesli mesajları getirir. Diğer araçlarla aynı filters, limit ve page arayüzü.

Filtrelenebilir temel alanlar: src, dst, calldate, duration, listened

get_recording_audio

Belirli bir kaydın MP3 sesi için doğrudan indirme URL'si döndürür.

Parametre: id (number) — bir get_recordings yanıtındaki id alanı.

[!info] Bilgi Ses URL'leri zaman sınırlıdır. Hemen kullanın; uzun süre önbelleğe almayın.

Filtreleme ve Sayfalama

Tüm liste araçları isteğe bağlı bir filters dizisini kabul eder. Her filtre nesnesinin üç özelliği vardır:

Özellik	Açıklama
property	Filtrelenecek alan adı (örn. calldate, cx_score, src_name)
operator	eq, ne, lt, lte, gt, gte, in, like, notlike
value	String, sayı veya dizi (in operatörü için)

Yaygın örnekler

Tarih aralığı

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

CX puanı eşiği

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

Belirli temsilci

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

Yalnızca bağlanan çağrılar

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

5 dakikadan uzun gelen çağrılar

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

Kullanım Durumları

QA raporu oluşturma

"Bu ay her temsilci için bir QA özeti ver — CX puanı ortalamaları, yaygın şikayet temaları ve en düşük puanlı üç çağrıları özetleriyle birlikte."

Çağrı merkezi hacim istatistikleri

"Bu hafta günlük çağrı hacmimiz neydi? Ortalama işlem süremiz neydi ve kaç çağrı cevapsız kaldı?"

Duygu eğilimi analizi

"Müşteri duygusu geçen aya göre iyileşiyor mu yoksa kötüleşiyor mu? Hangi çağrı konuları olumsuz duyguyla ilişkili?"

Cevapsız çağrı takip listesi

"Son 24 saatteki tüm cevapsız gelen çağrıları arayan kimlikleriyle listele, böylece geri aramaları önceliklendirebilirim."

Maliyet ve faturalandırma incelemesi

"Bu çeyrekte en pahalı giden çağrıları hangi dahili hatlar yaptı?"

Canlı operasyon kontrolü

"Şu anda kaç temsilci çağrıda ve 20 dakikadan uzun süredir devam eden çağrı var mı?"

Token Verimliliği

CX Eklentisi olmadan Claude'un analiz ettiği her çağrı, Claude'un ses içeriğini işlemesini ve kendi transkripsiyonunu ve analizini oluşturmasını gerektirir. CX Eklentisi bunu tamamen VoIPstudio'ya aktarır:

VoIPstudio'nun işledikleri (sabit aylık maliyet, sınırsız çağrı):

• Ses transkripsiyonu
• Konuşmacı ayrımı
• Çağrı özetleme
• Duygu sınıflandırması
• Aksiyon maddesi çıkarma
• CX puanlama

Claude'un aldıkları: Akıl yürütme, karşılaştırma ve raporlama için hazır, temiz, yapılandırılmış metin alanları.

Bu, tek bir oturumda Claude'dan yüzlerce çağrıyı token maliyetinin çok küçük bir kısmıyla analiz etmesini isteyebileceğiniz anlamına gelir; bu da büyük ölçekli QA, eğilim analizi ve temsilci koçluk raporlarını öngörülemez AI harcamaları olmadan pratik hale getirir.