Voipstudio MCP

AI - 인공지능 - VoIPstudio MCP 서버

VoIPstudio MCP(Model Context Protocol) 서버는 Claude AI에 VoIPstudio 계정 데이터(녹음, CDR, 실시간 통화, 음성사서함 포함)에 대한 직접적이고 안전한 액세스를 제공합니다. 연결이 완료되면 Claude는 맞춤 개발 없이 일반 영어로 통화를 조회하고, 패턴을 분석하며, 상담원 성과 문제를 표면화하고, QA 보고서를 생성할 수 있습니다.

CX 애드온을 추가하면 각 녹음에 대본, 요약, 감정 분석, 조치 항목, CX 점수가 사전에 포함되어 도착합니다. 이는 Claude가 수행해야 하는 AI 작업을 획기적으로 줄여 토큰 사용량을 낮추고 비용을 더 예측 가능하게 유지합니다.

API 키 발급

MCP 서버는 VoIPstudio API 토큰을 사용하여 인증합니다. 각 키는 특정 사용자에 범위가 지정되므로 Claude는 해당 사용자가 액세스할 수 있는 데이터에만 액세스할 수 있습니다.

키를 생성하려면:

1. 관리자 대시보드에서 토큰을 생성할 사용자를 엽니다.
2. API 키 섹션으로 이동합니다.
3. 키 이름을 입력합니다(예: Claude MCP).
4. 추가를 클릭합니다.
5. 눈 아이콘을 클릭하여 API 키 / user_token를 표시합니다. 이 값을 복사합니다.
6. 추가 세부 정보를 보거나 키를 삭제하려면 기어 아이콘을 클릭하고 세부 정보 표시를 선택합니다.

참고: API 키는 최소 7일(기본 제한 시간)에 한 번 이상 사용되는 한 유효합니다. 필요한 경우 추가를 클릭하기 전에 더 긴 제한 시간(또는 무제한)을 설정하세요.

REST API 문서 참조

Claude에 연결

VoIPstudio는 현재 Claude.ai 커넥터 디렉터리에 등록되어 있지 않습니다. 사용자 지정 MCP 서버로 수동으로 추가해야 합니다.

MCP 서버 URL

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

단계(Claude.ai)

1. Claude.ai에서 설정 → 통합(또는 요금제에 따라 커넥터 패널)으로 이동합니다.
2. 사용자 지정 MCP 서버 추가(또는 이에 상응하는 옵션)를 선택합니다.
3. 위의 MCP 서버 URL을 입력합니다.
4. 인증을 요청하면 VoIPstudio API 키를 제공합니다.
5. 연결을 저장하고 승인합니다.

이제 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	고객 감정: positive, neutral, negative
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

통화 상세 기록(CDR) – 모든 통화 구간의 원시 로그입니다. 볼륨 통계, 비용 분석, 지속 시간 분포, 상담원 활동 요약에 사용합니다. 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(number) — get_recordings 응답의 id 필드입니다.

[!info] 정보 오디오 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 점수 평균, 공통 불만 주제, 그리고 가장 낮은 점수를 받은 통화 3건과 요약."

콜센터 볼륨 통계

"이번 주 일별 통화 볼륨은 어땠나요? 평균 처리 시간은 얼마였고, 응답하지 않은 통화는 몇 건인가요?"

감정 추세 분석

"지난달과 비교하여 고객 감정이 개선되고 있나요, 악화되고 있나요? 어떤 통화 주제가 부정적 감정과 상관관계가 있나요?"

부재중 통화 후속 조치 목록

"지난 24시간 동안의 모든 부재중 인바운드 통화를 발신자 ID와 함께 나열해 줘. 콜백 우선순위를 정할 수 있게."

비용 및 청구 검토

"이번 분기에 가장 비용이 많이 든 아웃바운드 통화를 만든 내선 번호는 무엇인가요?"

실시간 운영 확인

"현재 통화 중인 상담원은 몇 명이고, 20분 이상 진행 중인 통화가 있나요?"

토큰 효율성

CX 애드온 없이 Claude가 분석하는 각 통화는 Claude가 오디오 콘텐츠를 처리하고 자체 대본화 및 분석을 생성해야 합니다. CX 애드온은 이 작업을 전적으로 VoIPstudio에 오프로드합니다:

VoIPstudio가 처리하는 작업(고정 월 비용, 무제한 통화):

• 오디오 대본화
• 화자 분리
• 통화 요약
• 감정 분류
• 조치 항목 추출
• CX 점수 산정

Claude가 받는 것: 추론, 비교, 보고에 바로 사용할 수 있는 깨끗하고 구조화된 텍스트 필드.

즉, 단일 세션에서 수백 건의 통화를 분석하도록 Claude에 요청할 수 있으며, 토큰 비용은 극히 일부에 불과합니다. 이를 통해 예측 불가능한 AI 지출 없이 대규모 QA, 추세 분석, 상담원 코칭 보고서를 실용적으로 만들 수 있습니다.