Voipstudio MCP Server

AI - कृत्रिम बुद्धिमत्ता - VoIPstudio MCP सर्वर¶

VoIPstudio MCP (मॉडल कॉन्टेक्स्ट प्रोटोकॉल) सर्वर Claude AI को आपके VoIPstudio खाते के डेटा, जिसमें रिकॉर्डिंग, CDR, लाइव कॉल और वॉइसमेल शामिल हैं, तक सीधी, सुरक्षित पहुँच प्रदान करता है। एक बार कनेक्ट होने पर, Claude कॉल्स की क्वेरी कर सकता है, पैटर्न का विश्लेषण कर सकता है, एजेंट प्रदर्शन समस्याओं को उजागर कर सकता है और सरल अंग्रेज़ी में QA रिपोर्ट तैयार कर सकता है, बिना किसी कस्टम डेवलपमेंट की आवश्यकता के।

CX ऐडऑन जोड़ें और प्रत्येक रिकॉर्डिंग पहले से ट्रांसक्रिप्ट, सारांश, भावना, कार्रवाई आइटम और CX स्कोर से समृद्ध होकर आती है। इससे Claude को करने वाले AI कार्य में नाटकीय रूप से कमी आती है और आपके टोकन उपयोग को कम और लागत को अधिक पूर्वानुमानित रखता है।

API कुंजी प्राप्त करना¶

MCP सर्वर VoIPstudio API टोकन का उपयोग करके प्रमाणीकरण करता है। प्रत्येक कुंजी एक विशिष्ट उपयोगकर्ता के लिए स्कोप्ड होती है, इसलिए Claude केवल उस डेटा तक पहुँच पाएगा जिसे वह उपयोगकर्ता एक्सेस कर सकता है।

कुंजी उत्पन्न करने के लिए:

1. एडमिन डैशबोर्ड में, उस उपयोगकर्ता को खोलें जिसके लिए आप टोकन उत्पन्न करना चाहते हैं।
2. API Keys अनुभाग पर जाएँ।
3. कुंजी के लिए एक नाम दर्ज करें — उदाहरण के लिए, Claude MCP।
4. Add पर क्लिक करें।
5. API कुंजी / user_token प्रकट करने के लिए eye icon पर क्लिक करें। इस मान को कॉपी करें।
6. अधिक विवरण देखने या कुंजी हटाने के लिए, gear icon पर क्लिक करें और Show Details चुनें।

नोट: API कुंजी तब तक मान्य रहती है जब तक इसका उपयोग हर 7 दिनों में कम से कम एक बार किया जाता है (डिफ़ॉल्ट टाइमआउट)। यदि आवश्यक हो तो Add पर क्लिक करने से पहले एक लंबा टाइमआउट (या असीमित) सेट करें।

REST API दस्तावेज़ीकरण देखें

Claude से कनेक्ट करना¶

VoIPstudio वर्तमान में Claude.ai कनेक्टर निर्देशिका में सूचीबद्ध नहीं है। आप इसे मैन्युअल रूप से एक कस्टम MCP सर्वर के रूप में जोड़ते हैं।

MCP सर्वर URL¶

MCP सर्वर URL

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

चरण (Claude.ai)¶

1. Claude.ai में, Settings → Integrations (या आपकी योजना के अनुसार कनेक्टर्स पैनल) पर जाएँ।
2. Add custom MCP server (या समकक्ष) चुनें।
3. ऊपर दिया गया MCP सर्वर URL दर्ज करें।
4. प्रमाणीकरण के लिए संकेत मिलने पर, अपनी VoIPstudio API कुंजी प्रदान करें।
5. कनेक्शन सहेजें और अधिकृत करें।

Claude अब किसी भी वार्तालाप में VoIPstudio टूल्स को कॉल कर सकता है। किसी सत्र में पहली बार कोई टूल कॉल किए जाने पर, Claude आपसे डेटा साझाकरण की पुष्टि करने के लिए कहेगा। भविष्य के सत्रों में इस संकेत को छोड़ने के लिए Always allow पर क्लिक करें।

Anthropic API (डेवलपर्स के लिए)¶

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

अन्य AI प्लेटफ़ॉर्म से कनेक्ट करना¶

अधिकांश AI प्लेटफ़ॉर्म जो बाहरी MCP का समर्थन करते हैं, उसी URL और API कुंजी का उपयोग करके VoIPstudio MCP सर्वर से कनेक्ट हो सकते हैं। सटीक कॉन्फ़िगरेशन चरण प्लेटफ़ॉर्म के अनुसार भिन्न होंगे। अपने प्लेटफ़ॉर्म के एकीकरण या सेटिंग्स में external MCP server, custom MCP, या remote MCP लेबल वाले विकल्प की तलाश करें।

CX ऐडऑन¶

CX ऐडऑन के बिना, रिकॉर्डिंग कच्चे मेटाडेटा के रूप में आती हैं। Claude को प्रत्येक कॉल को स्वयं ट्रांसक्राइब और विश्लेषण करना होगा, जिससे प्रति रिकॉर्डिंग महत्वपूर्ण टोकन खर्च होते हैं।

CX ऐडऑन के साथ, VoIPstudio अपने स्वयं के बुनियादी ढाँचे पर एक निश्चित मासिक लागत पर बिना किसी प्रति-कॉल शुल्क और बिना किसी ट्रांसक्रिप्शन सीमा के ट्रांसक्रिप्शन, सारांशीकरण, भावना विश्लेषण, कार्रवाई निष्कर्षण और CX स्कोरिंग को संभालता है। Claude को तैयार बुद्धिमत्ता प्राप्त होती है — तुरंत तर्क करने के लिए तैयार।

CX ऐडऑन के बिना	CX ऐडऑन के साथ
ट्रांसक्रिप्ट	Claude को ऑडियो लाना और ट्रांसक्राइब/अनुवाद करना होगा	✓ शामिल, स्पीकर-डायराइज़्ड
सारांश	Claude को उत्पन्न करना होगा	✓ शामिल
भावना	Claude को अनुमान लगाना होगा	✓ शामिल
कार्रवाई आइटम	Claude को निकालना होगा	✓ शामिल
CX स्कोर	उपलब्ध नहीं	✓ प्रत्येक कॉल पर 1–10
अनुमानित टोकन/कॉल	10,000–15,000	300–500
लागत मॉडल	परिवर्तनीय AI व्यय	निश्चित मासिक सदस्यता

CX ऐडऑन द्वारा अनलॉक किए गए फ़ील्ड¶

फ़ील्ड	प्रकार	विवरण
transcript	string	पूर्ण शब्द-स्तरीय ट्रांसक्रिप्ट
transcript_speakers	object	स्पीकर-डायराइज़्ड ट्रांसक्रिप्ट खंड
summary	string	कॉल परिणाम का संक्षिप्त सारांश
sentiment	string	ग्राहक भावना: सकारात्मक, तटस्थ, नकारात्मक
cx_score	number (1–10)	ग्राहक अनुभव स्कोर
metadata.timeline	array	कॉल से निकाले गए मुख्य क्षण और कार्रवाई आइटम

टूल्स संदर्भ¶

MCP एकीकरण की सरलता का अर्थ है कि जटिल API को समझने की आवश्यकता नहीं है और इसके बजाय, सरल संकेत AI प्लेटफ़ॉर्म को Voipstudio से प्रदान किए गए डेटा को समझने और उचित प्रतिक्रिया के साथ उत्तर देने में मदद कर सकते हैं।

हालाँकि, कुछ अधिक तकनीकी उपयोगकर्ता यह जानना चाह सकते हैं कि "हुड के नीचे" क्या हो रहा है, इसलिए नीचे कुछ MCP सर्वर फ़ंक्शंस के लिए एक संदर्भ मार्गदर्शिका दी गई है।

get_recordings¶

कॉल रिकॉर्डिंग लौटाता है। CX ऐडऑन सक्रिय होने पर, प्रत्येक रिकॉर्ड में ट्रांसक्रिप्ट, सारांश, भावना, CX स्कोर और टाइमलाइन शामिल होती है। ऐडऑन के बिना, ये फ़ील्ड null लौटाते हैं।

पैरामीटर

पैरामीटर	प्रकार	डिफ़ॉल्ट	विवरण
filters	array	—	फ़िल्टर ऑब्जेक्ट — फ़िल्टरिंग देखें
limit	number	10	प्रति पृष्ठ रिकॉर्ड (अधिकतम 1000)
page	number	1	पृष्ठ संख्या

प्रतिक्रिया फ़ील्ड

फ़ील्ड	प्रकार	विवरण
id	number	अद्वितीय रिकॉर्डिंग ID
call_id	number	CDR call_id से लिंक
timestamp	string	रिकॉर्डिंग प्रारंभ (UTC, YYYY-MM-DD HH:mm:ss)
caller	string	कॉल करने वाले पक्ष का नंबर
called	string	कॉल किए गए पक्ष का नंबर
src_name	string	एजेंट का नाम (स्रोत)
dst_name	string	गंतव्य नाम
duration	number	सेकंड में अवधि
type	string	I \= इनबाउंड, O \= आउटबाउंड
context	string	कॉल संदर्भ (जैसे LOCAL_USER, QUEUE)
transcript	string	null
transcript_speakers	object	null
summary	string	null
sentiment	string	null
cx_score	number	null
metadata.timeline	array	null

उदाहरण – इस सप्ताह कम CX स्कोर

Claude से पूछें: "मुझे इस सप्ताह की सभी रिकॉर्डिंग दिखाएँ जहाँ CX स्कोर 6 से नीचे था, एजेंट द्वारा समूहीकृत, प्रत्येक कॉल पर क्या गलत हुआ इसके सारांश के साथ।"

Claude टूल को इसके साथ कॉल करता है:

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

get_cdrs¶

कॉल विवरण रिकॉर्ड – प्रत्येक कॉल लेग का कच्चा लॉग। वॉल्यूम आँकड़े, लागत विश्लेषण, अवधि वितरण और एजेंट गतिविधि सारांश के लिए उपयोग करें। CX ऐडऑन के बिना उपलब्ध।

पैरामीटर: get_recordings के समान (filters, limit, page)

मुख्य प्रतिक्रिया फ़ील्ड

फ़ील्ड	प्रकार	विवरण
call_id	number	अद्वितीय कॉल पहचानकर्ता
calldate	string	कॉल प्रारंभ टाइमस्टैम्प (UTC)
src_name	string	एजेंट / कॉलर का नाम
dst_name	string	गंतव्य नाम
billsec	number	बिल योग्य सेकंड
duration	number	रिंगिंग सहित कुल सेकंड
disposition	string	CONNECTED, NO ANSWER, BUSY, FAILED
charge	number	कॉल लागत
type	string	I \= इनबाउंड, O \= आउटबाउंड
src_ua	string	स्रोत डिवाइस / सॉफ्टफोन उपयोगकर्ता-एजेंट
labels	array	VoIPstudio में लागू कस्टम टैग

get_live_calls¶

आपके खाते पर सभी सक्रिय कॉलों का रीयल-टाइम स्नैपशॉट लौटाता है। किसी पैरामीटर की आवश्यकता नहीं है।

उदाहरण: "अभी कितनी कॉलें प्रगति पर हैं, और कौन से एजेंट उन पर हैं?"

get_voicemails¶

वॉइसमेल संदेश प्राप्त करता है। अन्य टूल्स की तरह ही filters, limit, और page इंटरफ़ेस।

मुख्य फ़िल्टर करने योग्य फ़ील्ड: src, dst, calldate, duration, listened

get_recording_audio¶

किसी विशिष्ट रिकॉर्डिंग के MP3 ऑडियो के लिए सीधा डाउनलोड URL लौटाता है।

पैरामीटर: id (संख्या) — get_recordings प्रतिक्रिया से id फ़ील्ड।

जानकारी

ऑडियो URL समय-सीमित होते हैं। उनका तुरंत उपयोग करें; विस्तारित अवधि के लिए कैश न करें।

फ़िल्टरिंग और पृष्ठांकन¶

सभी सूची उपकरण एक वैकल्पिक filters सरणी स्वीकार करते हैं। प्रत्येक फ़िल्टर ऑब्जेक्ट में तीन गुण होते हैं:

गुण	विवरण
property	फ़िल्टर करने के लिए फ़ील्ड का नाम (जैसे calldate, cx_score, src_name)
operator	eq, ne, lt, lte, gt, gte, in, like, notlike
value	स्ट्रिंग, संख्या, या सरणी (in ऑपरेटर के लिए)

सामान्य उदाहरण¶

दिनांक सीमा

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

CX स्कोर सीमा

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

विशिष्ट एजेंट

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

केवल कनेक्टेड कॉल

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

5 मिनट से अधिक की इनबाउंड कॉल

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

उपयोग के मामले¶

एजेंट QA रिपोर्ट¶

"मुझे इस महीने प्रत्येक एजेंट के लिए एक QA सारांश दें — CX स्कोर औसत, सामान्य शिकायत विषय, और सारांश के साथ उनकी तीन सबसे कम स्कोरिंग वाली कॉलें।"

कॉल सेंटर वॉल्यूम आँकड़े¶

"इस सप्ताह दिन के अनुसार हमारी कॉल वॉल्यूम क्या थी? हमारा औसत हैंडल समय क्या था, और कितनी कॉलें अनुत्तरित रहीं?"

भावना प्रवृत्ति विश्लेषण¶

"क्या ग्राहक भावना पिछले महीने की तुलना में सुधर रही है या घट रही है? कौन से कॉल विषय नकारात्मक भावना से संबंधित हैं?"

छूटी हुई कॉल फ़ॉलो-अप सूची¶

"पिछले 24 घंटों की सभी छूटी हुई इनबाउंड कॉलों को कॉलर ID के साथ सूचीबद्ध करें, ताकि मैं कॉलबैक को प्राथमिकता दे सकूँ।"

लागत और बिलिंग समीक्षा¶

"इस तिमाही में किन एक्सटेंशनों ने सबसे महँगी आउटबाउंड कॉलें की हैं?"

लाइव संचालन जाँच¶

"वर्तमान में कितने एजेंट कॉल पर हैं, और क्या कोई ऐसी कॉल है जो 20 मिनट से अधिक समय से चल रही है?"

टोकन दक्षता¶

CX ऐडऑन के बिना Claude द्वारा विश्लेषण की जाने वाली प्रत्येक कॉल के लिए Claude को ऑडियो सामग्री संसाधित करने और अपना स्वयं का ट्रांसक्रिप्शन और विश्लेषण उत्पन्न करने की आवश्यकता होती है। CX ऐडऑन इसे पूरी तरह से VoIPstudio पर ऑफलोड करता है:

VoIPstudio क्या संभालता है (निश्चित मासिक लागत, असीमित कॉल):

• ऑडियो ट्रांसक्रिप्शन
• स्पीकर डायराइज़ेशन
• कॉल सारांशीकरण
• भावना वर्गीकरण
• कार्रवाई आइटम निष्कर्षण
• CX स्कोरिंग

Claude क्या प्राप्त करता है: तर्क, तुलना और रिपोर्टिंग के लिए तैयार स्वच्छ, संरचित पाठ फ़ील्ड।

इसका अर्थ है कि आप Claude को एक ही सत्र में टोकन लागत के एक अंश पर सैकड़ों कॉलों का विश्लेषण करने के लिए कह सकते हैं, जिससे बड़े पैमाने पर QA, प्रवृत्ति विश्लेषण और एजेंट कोचिंग रिपोर्ट अप्रत्याशित AI व्यय के बिना व्यावहारिक हो जाती है।