Voipstudio MCP Server

AI - Yapay Zeka - VoIPstudio MCP Sunucusu¶

VoIPstudio MCP (Model Bağlam Protokolü) sunucusu, Claude AI'ya kayıtlar, CDR'ler, canlı aramalar ve sesli mesajlar dahil olmak üzere VoIPstudio hesap verilerinize doğrudan ve güvenli erişim sağlar. Bağlandıktan sonra Claude, aramaları sorgulayabilir, desenleri analiz edebilir, temsilci performans sorunlarını ortaya çıkarabilir ve hiçbir özel geliştirme gerektirmeden sade bir dille QA raporları oluşturabilir.

CX Eklentisi'ni ekleyin ve her kayıt, transkript, özet, duygu durumu, eylem öğeleri ve bir 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 maliyetleri daha öngörülebilir tutar.

API anahtarı edinme¶

MCP sunucusu, bir VoIPstudio API token'ı kullanarak kimlik doğrulaması yapar. Her anahtar belirli bir kullanıcıya kapsamlandırılmıştır, bu nedenle Claude yalnızca o kullanıcının erişebildiği verilere erişebilecektir.

Bir 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'i ortaya çıkarmak 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 kullanıldığı sürece geçerli kalır (varsayılan zaman aşımı). Ekle'ye tıklamadan önce gerekirse 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 listelenmemektedir. Bunu özel bir MCP sunucusu olarak manuel olarak eklersiniz.

MCP sunucu URL'si¶

MCP sunucu URL'si

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

Adımlar (Claude.ai)¶

1. Claude.ai'da, Ayarlar → Entegrasyonlar'a (veya planınıza bağlı olarak bağlayıcılar paneline) gidin.
2. Özel MCP sunucusu ekle'yi (veya eşdeğerini) seçin.
3. Yukarıdaki MCP sunucu URL'sini girin.
4. Kimlik doğrulaması 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. Gelecek 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şecektir. 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 her aramayı kendi başına transkribe etmeli ve analiz etmelidir, bu da kayıt başına önemli miktarda token tüketir.

CX Eklentisi ile VoIPstudio, transkripsiyon, özetleme, duygu analizi, eylem çıkarma ve CX puanlamasını kendi altyapısında çağrı başına ücret olmadan ve transkripsiyon sınırı olmadan sabit bir aylık maliyetle gerçekleştirir. Claude, hemen üzerinde akıl yürütmeye hazır bitmiş istihbaratı alır.

CX Eklentisi Olmadan	CX Eklentisi İle
Transkript	Claude sesi almalı ve transkribe/çeviri yapmalı	✓ Dahil, konuşmacı ayrımlı
Özet	Claude oluşturmalı	✓ Dahil
Duygu Durumu	Claude çıkarım yapmalı	✓ Dahil
Eylem öğeleri	Claude çıkarmalı	✓ Dahil
CX puanı	Mevcut değil	✓ Her aramada 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	Tam kelime düzeyinde transkript
transcript_speakers	object	Konuşmacı ayrımlı transkript segmentleri
summary	string	Arama sonucunun kısa özeti
sentiment	string	Müşteri duygu durumu: pozitif, nötr, negatif
cx_score	number (1–10)	Müşteri deneyimi puanı
metadata.timeline	array	Aramadan çıkarılan önemli anlar ve eylem öğeleri

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 cevap vermesine yardımcı olabileceği anlamına gelir.

Ancak, bazı daha teknik kullanıcılar "perde arkasında" neler olduğunu bilmek isteyebilir, bu nedenle aşağıda bazı MCP sunucu işlevlerine ilişkin bir referans kılavuzu bulunmaktadır.

get_recordings¶

Arama kayıtlarını döndürür. CX Eklentisi aktifken, her kayıt transkript, özet, duygu durumu, 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'ye 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 ID'si
call_id	number	CDR call_id ile bağlantılı
timestamp	string	Kayıt başlangıcı (UTC, YYYY-AA-GG SS:dd: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	Arama 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 haftaki düşük CX puanları

Claude'a sorun: "Bana bu haftadan CX puanı 6'nın altında olan tüm kayıtları, temsilciye göre gruplandırılmış olarak ve her aramada neyin yanlış gittiğine dair bir özetle göster."

Claude aracı şununla ç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¶

Arama Detay Kayıtları – her arama 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)

Anahtar yanıt alanları

Alan	Tür	Açıklama
call_id	number	Benzersiz arama tanımlayıcısı
calldate	string	Arama başlangıç zaman damgası (UTC)
src_name	string	Temsilci / arayan adı
dst_name	string	Hedef adı
billsec	number	Faturalanabilir saniye
duration	number	Çalma dahil toplam saniye
disposition	string	BAĞLANDI, CEVAP YOK, MEŞGUL, BAŞARISIZ
charge	number	Arama 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 aramaların gerçek zamanlı bir anlık görüntüsünü döndürür. Parametre gerekmez.

Örnek: "Şu anda devam eden kaç arama var ve hangi temsilciler bunlarda?"

get_voicemails¶

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

Anahtar filtrelenebilir alanlar: src, dst, calldate, duration, listened

get_recording_audio¶

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

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

Bilgi

Ses URL'leri zaman sınırlıdır. Bunları hemen kullanın; uzun süreler için ö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, number veya array (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 aramalar

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

5 dakikadan uzun gelen aramalar

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

Kullanım Örnekleri¶

Temsilci QA raporu¶

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

Çağrı merkezi hacim istatistikleri¶

"Bu hafta günlere göre arama hacmimiz neydi? Ortalama işlem süremiz neydi ve kaç arama cevapsız kaldı?"

Duygu durumu trend analizi¶

"Müşteri duygu durumu geçen aya kıyasla iyileşiyor mu yoksa düşüyor mu? Hangi arama konuları olumsuz duygu durumu ile ilişkili?"

Cevapsız arama takip listesi¶

"Geri aramaları önceliklendirebilmem için son 24 saatteki tüm cevapsız gelen aramaları arayan kimlikleriyle listele."

Maliyet ve faturalandırma incelemesi¶

"Bu çeyrekte en pahalı giden aramaları hangi dahililer yaptı?"

Canlı operasyon kontrolü¶

"Şu anda kaç temsilci aramada ve 20 dakikayı aşan arama var mı?"

Token Verimliliği¶

CX Eklentisi olmadan Claude'un analiz ettiği her arama, Claude'un ses içeriğini işlemesini ve kendi transkripsiyon ve analizini oluşturmasını gerektirir. CX Eklentisi bunu tamamen VoIPstudio'ya yükler:

VoIPstudio'nun üstlendikleri (sabit aylık maliyet, sınırsız arama):

• Ses transkripsiyonu
• Konuşmacı ayrımı
• Arama özetleme
• Duygu sınıflandırması
• Eylem öğesi çıkarma
• CX puanlaması

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, Claude'dan tek bir oturumda yüzlerce aramayı analiz etmesini token maliyetinin çok küçük bir kısmına isteyebileceğiniz anlamına gelir, bu da büyük ölçekli QA, trend analizi ve temsilci koçluk raporlarını öngörülemeyen AI harcaması olmadan uygulanabilir kılar.