Voipstudio MCP Server
공식VoIPstudio MCP 서버는 호환되는 AI 어시스턴트에게 승인된 VoIPstudio 계정 데이터(녹음, 통화 상세 기록, 실시간 통화, 음성 메일 포함)에 대한 안전한 접근을 제공하여, 통화 활동을 조회하고, 패턴을 분석하며, 에이전트 성과 문제를 식별하고, 일반 영어로 QA 또는 운영 보고서를 생성할 수 있도록 합니다.
문서
AI - 인공지능 - VoIPstudio MCP 서버¶
VoIPstudio MCP (Model Context Protocol) 서버는 Claude AI가 녹음, CDR, 실시간 통화, 음성 메일 등 VoIPstudio 계정 데이터에 직접 안전하게 접근할 수 있도록 합니다. 연결되면 Claude는 사용자 지정 개발 없이도 통화 조회, 패턴 분석, 상담원 성과 문제 파악, QA 보고서를 평이한 언어로 생성할 수 있습니다.
CX 애드온을 추가하면 각 녹음 파일에 대본, 요약, 감정, 실행 항목, CX 점수가 미리 포함되어 도착합니다. 이는 Claude가 수행해야 하는 AI 작업을 획기적으로 줄여 토큰 사용량을 낮추고 비용을 더 예측 가능하게 만듭니다.
API 키 발급받기¶
MCP 서버는 VoIPstudio API 토큰을 사용하여 인증합니다. 각 키는 특정 사용자로 범위가 지정되므로 Claude는 해당 사용자가 접근할 수 있는 데이터에만 접근할 수 있습니다.
키를 생성하려면:
- 관리자 대시보드에서 토큰을 생성할 사용자를 엽니다.
- API 키 섹션으로 이동합니다.
- 키 이름을 입력합니다 — 예:
Claude MCP. - 추가를 클릭합니다.
- 눈 모양 아이콘을 클릭하여 API 키 /
user_token을 표시합니다. 이 값을 복사합니다. - 자세한 내용을 보거나 키를 삭제하려면 톱니바퀴 아이콘을 클릭하고 세부 정보 표시를 선택합니다.
참고: API 키는 최소 7일에 한 번 이상 사용되는 동안 유효합니다(기본 시간 초과). 필요한 경우 추가를 클릭하기 전에 더 긴 시간 초과(또는 무제한)를 설정하십시오.
REST API 문서 보기
Claude에 연결하기¶
VoIPstudio는 현재 Claude.ai 커넥터 디렉토리에 등록되어 있지 않습니다. 사용자 지정 MCP 서버로 수동 추가합니다.
MCP 서버 URL¶
MCP 서버 URL
https://mcp.voipstudio.workers.dev/sse
단계 (Claude.ai)¶
- Claude.ai에서 설정 → 통합(또는 플랜에 따라 커넥터 패널)으로 이동합니다.
- 사용자 지정 MCP 서버 추가(또는 이에 상응하는 항목)를 선택합니다.
- 위의 MCP 서버 URL을 입력합니다.
- 인증을 요청받으면 VoIPstudio API 키를 제공합니다.
- 저장하고 연결을 승인합니다.
이제 Claude는 모든 대화에서 VoIPstudio 도구를 호출할 수 있습니다. 세션에서 도구가 처음 호출되면 Claude가 데이터 공유 확인을 요청합니다. 향후 세션에서 이 프롬프트를 건너뛰려면 항상 허용을 클릭하십시오.
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 플랫폼에 연결하기¶
외부 MCP를 지원하는 대부분의 AI 플랫폼은 동일한 URL과 API 키를 사용하여 VoIPstudio MCP 서버에 연결할 수 있습니다. 정확한 구성 단계는 플랫폼마다 다릅니다. 플랫폼의 통합 또는 설정에서 외부 MCP 서버, 사용자 지정 MCP 또는 원격 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 | 연결됨, 무응답, 통화 중, 실패 |
| charge | number | 통화 비용 |
| type | string | I \= 인바운드, O \= 아웃바운드 |
| src_ua | string | 발신 장치 / 소프트폰 user-agent |
| 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 점수 평균, 일반적인 불만 주제, 요약과 함께 가장 낮은 점수를 받은 세 통화."
콜센터 통화량 통계¶
"이번 주 일별 통화량은 어땠어? 평균 처리 시간은 얼마였고, 응답되지 않은 통화는 몇 건이었어?"
감정 추세 분석¶
"고객 감정이 지난달에 비해 개선되고 있나요, 아니면 악화되고 있나요? 부정적인 감정과 관련된 통화 주제는 무엇인가요?"
부재중 전화 후속 조치 목록¶
"발신자 ID와 함께 지난 24시간 동안의 모든 부재중 인바운드 통화를 나열하여 콜백 우선순위를 정할 수 있게 해줘."
비용 및 청구 검토¶
"이번 분기에 가장 비싼 아웃바운드 통화를 한 내선 번호는 어디인가요?"
실시간 운영 점검¶
"현재 통화 중인 상담원은 몇 명이며, 20분 이상 진행 중인 통화가 있나요?"
토큰 효율성¶
CX 애드온 없이 Claude가 분석하는 각 통화는 Claude가 오디오 콘텐츠를 처리하고 자체 전사 및 분석을 생성해야 합니다. CX 애드온은 이를 완전히 VoIPstudio로 오프로드합니다:
VoIPstudio가 처리하는 작업 (월 고정 비용, 무제한 통화):
- 오디오 전사
- 화자 분할
- 통화 요약
- 감정 분류
- 실행 항목 추출
- CX 점수 산정
Claude가 받는 것: 추론, 비교, 보고 준비가 완료된 깨끗하고 구조화된 텍스트 필드.
즉, 단일 세션에서 Claude에게 수백 건의 통화를 분석하도록 요청할 수 있으며 토큰 비용은 극히 일부에 불과하므로, 예측 불가능한 AI 지출 없이 대규모 QA, 추세 분석, 상담원 코칭 보고서를 실용적으로 수행할 수 있습니다.