Przejdź do głównej zawartości

AI - Sztuczna Inteligencja - Serwer MCP Voipstudio

Serwer MCP (Model Context Protocol) Voipstudio zapewnia asystentom AI, takim jak Claude i ChatGPT, bezpośredni i bezpieczny dostęp do danych Twojego konta Voipstudio, w tym nagrań, rekordów CDR, aktywnych połączeń, wiadomości głosowych oraz historii rozmów z danym numerem. Po podłączeniu serwera asystent może wyszukiwać połączenia, analizować wzorce, wskazywać problemy z wydajnością agentów oraz generować raporty QA w prostym, zrozumiałym języku, bez konieczności tworzenia niestandardowych rozwiązań programistycznych.

Dodaj CX Addon, a każde nagranie będzie dostarczane już wzbogacone o transkrypcję, podsumowanie, analizę sentymentu, elementy wymagające działania oraz ocenę CX. Znacznie zmniejsza to ilość pracy, jaką musi wykonać AI, co ogranicza zużycie tokenów i sprawia, że koszty są bardziej przewidywalne.

Adres URL serwera MCP​

informacja

Adres URL serwera MCP

https://mcp.voipstudio.com/mcp

Jest to zdalny serwer MCP (transport Streamable HTTP). Podłączasz go, logując się na swoje konto Voipstudio: nie trzeba tworzyć ani wklejać klucza API.

Jak przebiega łączenie​

Gdy dodasz serwer do aplikacji AI, aplikacja otworzy stronę logowania Voipstudio:

  1. Zaloguj się za pomocą adresu e-mail i hasła do Voipstudio (oraz kodu 2FA, jeśli uwierzytelnianie dwuskładnikowe jest włączone) albo przez Google, Microsoft lub Apple, jeśli Twoje konto korzysta z logowania jednokrotnego. Konto musi już istnieć: na tej stronie nie można utworzyć nowego konta.
  2. Strona zgody pokazuje, kto prosi o dostęp. Podaje adres, który otrzyma dostęp, a także nazwę aplikacji, jeśli jest to znana aplikacja (Claude, ChatGPT) lub aplikacja działająca na Twoim własnym komputerze. Każda inna witryna jest wyświetlana z ostrzeżeniem: zezwól na dostęp tylko wtedy, gdy rozpoznajesz ten adres.
  3. Kliknij Allow, aby połączyć aplikację, lub Cancel, aby niczego nie łączyć.

Asystent widzi wtedy to, co widzi Twój użytkownik Voipstudio, i nic więcej.

Klucz API, który otrzymuje każda aplikacja​

Po kliknięciu Allow serwer tworzy dla tej aplikacji klucz API Voipstudio w sekcji API Keys Twojego użytkownika. Nazwa klucza zaczyna się od VoIPstudio MCP - , po czym następuje nazwa aplikacji, na przykład VoIPstudio MCP - Claude (claude.ai) [1a2b3c4d].

  • Każda połączona aplikacja ma własny klucz. Ponowne zalogowanie się z tej samej aplikacji zastępuje tylko jej klucz, dzięki czemu inne Twoje aplikacje pozostają połączone.
  • Użytkownik może mieć maksymalnie 10 takich kluczy. Połączenie jedenastej aplikacji usuwa klucz, który najdłużej nie był używany.
  • Klucz wygasa po 30 dniach nieużywania. Zwykłe korzystanie, w tym odnawianie logowania przez aplikację w tle, sprawia, że klucz pozostaje aktywny.
  • Aby odłączyć aplikację, usuń konektor w tej aplikacji lub jej klucz w sekcji API Keys. Po usunięciu klucza wywołania narzędzi w aplikacji zwracają informację, że połączenie zostało usunięte, i aplikacja prosi o ponowne zalogowanie się.

Łączenie z Claude​

W Claude (w przeglądarce lub w aplikacji desktopowej) dodaj Voipstudio jako niestandardowy konektor:

  1. Otwórz Settings → Connectors i wybierz Add custom connector. W planach Team i Enterprise konektor dla organizacji dodaje jej właściciel.
  2. Wpisz nazwę, na przykład Voipstudio, oraz podany wyżej adres URL serwera MCP.
  3. Kliknij Connect i wykonaj opisane wyżej kroki logowania i udzielania zgody.

Claude może teraz korzystać z narzędzi Voipstudio w dowolnej rozmowie. Przy pierwszym wywołaniu narzędzia Claude poprosi Cię o potwierdzenie. Wybierz Always allow, aby w przyszłości pomijać ten monit.

Claude Code​

claude mcp add --transport http voipstudio https://mcp.voipstudio.com/mcp
claude mcp login voipstudio

W przeglądarce otworzy się strona logowania. Po wybraniu Allow kliknij Continue, aby przekazać wynik logowania z powrotem do Claude Code.

Na maszynie bez przeglądarki, na przykład podczas pracy przez SSH, uruchom zamiast tego claude mcp login voipstudio --no-browser. Otwórz adres wyświetlony przez to polecenie w przeglądarce na dowolnym komputerze, zaloguj się i zezwól na dostęp, a następnie skopiuj adres widoczny na ostatniej stronie i wklej go do Claude Code, gdy pojawi się monit.

Łączenie z innymi platformami AI​

Za pomocą powyższego adresu URL może się połączyć każda aplikacja AI, która obsługuje zdalne serwery MCP z logowaniem (OAuth), na przykład ChatGPT, o ile Twój plan pozwala na niestandardowe konektory. Poszukaj w ustawieniach aplikacji opcji oznaczonej jako custom connector, custom MCP lub remote MCP, wpisz adres URL i wykonaj kroki logowania oraz udzielania zgody. Dokładny układ menu zależy od aplikacji i Twojego planu.

Aplikacje, które potrafią wysyłać jedynie stały klucz API, nie mogą się połączyć: ten serwer akceptuje wyłącznie logowanie, które sam przeprowadza.

Dla programistów​

Serwer implementuje autoryzację MCP:

  • Przepływ kodu autoryzacji OAuth 2.1 z PKCE (S256) i dynamiczną rejestracją klientów. Metadane są publikowane pod adresami https://mcp.voipstudio.com/.well-known/oauth-authorization-server i https://mcp.voipstudio.com/.well-known/oauth-protected-resource/mcp.
  • Tokeny dostępu są ważne przez godzinę i są odnawiane za pomocą tokenu odświeżania. Token odświeżania pozostaje ważny, dopóki jest używany co najmniej raz na 30 dni.
  • Bez tokenu działają tylko initialize i tools/list. Klucz API Voipstudio nie jest akceptowany jako token typu bearer.
  • Liczba żądań jest ograniczona dla każdego adresu klienta: 20 rejestracji klienta na godzinę oraz 50 żądań tokenów i 100 żądań autoryzacji na 15 minut.

Aby wywoływać serwer przez konektor MCP w Claude API, Twoja aplikacja uzyskuje token dostępu w opisanym wyżej przepływie i przekazuje go jako authorization_token serwera. Format żądania znajdziesz w dokumentacji Anthropic dotyczącej konektora MCP.

CX Addon​

Bez CX Addon nagrania są dostarczane jako surowe metadane. AI musi samodzielnie transkrybować i analizować każde połączenie, zużywając znaczną liczbę tokenów na każde nagranie.

Dzięki CX Addon to Voipstudio zajmuje się transkrypcją, podsumowywaniem, analizą sentymentu, wyodrębnianiem działań oraz oceną CX na własnej infrastrukturze, w ramach stałego miesięcznego kosztu, bez opłat za połączenie i bez limitów transkrypcji. AI otrzymuje gotowe informacje, na podstawie których może od razu wyciągać wnioski.

Bez CX AddonZ CX Addon
TranskrypcjaAI musi pobrać audio i wykonać transkrypcję/tłumaczenie✓ W zestawie, z rozróżnieniem mówców
PodsumowanieAI musi je wygenerować✓ W zestawie
SentymentAI musi go wywnioskować✓ W zestawie
Elementy wymagające działaniaAI musi je wyodrębnić✓ W zestawie
Ocena CXNiedostępna✓ 1–10 dla każdego połączenia
Przybliżona liczba tokenów na połączenie10 000–15 000300–500
Model kosztowyZmienny wydatek na AIStała miesięczna subskrypcja

Pola odblokowane przez CX Addon​

PoleTypOpis
transcriptstringPełna transkrypcja na poziomie słów
transcript_speakersobjectSegmenty transkrypcji z rozróżnieniem mówców
summarystringZwięzłe podsumowanie wyniku rozmowy
sentimentstringSentyment klienta: positive, neutral, negative
cx_scorenumber (1–10)Ocena doświadczenia klienta
metadata.timelinearrayKluczowe momenty i elementy wymagające działania wyodrębnione z rozmowy

Referencja narzędzi​

Dzięki MCP nie musisz uczyć się API Voipstudio: pytasz zwykłym językiem, a AI wybiera narzędzia i odczytuje za Ciebie dane.

Z myślą o użytkownikach technicznych, którzy chcą wiedzieć, co dzieje się „pod maską”, poniżej opisano sześć narzędzi udostępnianych przez serwer. Wszystkie służą wyłącznie do odczytu danych.

get_recordings​

Zwraca nagrania rozmów. Gdy CX Addon jest aktywny, każdy rekord zawiera transkrypcję, podsumowanie, sentyment, ocenę CX oraz oś czasu. Bez dodatku pola te mają wartość null.

Parametry

ParametrTypDomyślnieOpis
filtersarray—Obiekty filtrów, zobacz Filtrowanie, sortowanie i paginacja poniżej
sortobject—{ "by": "<field>", "dir": "ASC" } lub "DESC"
limitnumber10Liczba rekordów na stronie (1–1000)
pagenumber1Numer strony

Pola odpowiedzi

PoleTypOpis
idnumberUnikalny identyfikator nagrania
call_idnumberŁączy z call_id rekordu CDR
timestampstringPoczątek nagrania (UTC, YYYY-MM-DD HH:mm:ss)
callerstringNumer strony dzwoniącej
calledstringNumer strony odbierającej
src_namestringNazwa agenta (źródło)
dst_namestringNazwa miejsca docelowego
durationnumberCzas trwania w sekundach
typestringI = przychodzące, O = wychodzące
contextstringKontekst połączenia (np. LOCAL_USER, QUEUE)
transcriptstring | nullPełna transkrypcja (CX Addon)
transcript_speakersobject | nullTranskrypcja z rozróżnieniem mówców (CX Addon)
summarystring | nullPodsumowanie rozmowy (CX Addon)
sentimentstring | nullSentyment klienta (CX Addon)
cx_scorenumber | nullOcena CX 1–10 (CX Addon)
metadata.timelinearray | nullKluczowe zdarzenia i działania (CX Addon)

Przykład – niskie oceny CX w tym tygodniu

Zapytaj: „Pokaż mi wszystkie nagrania z tego tygodnia, w których ocena CX była poniżej 6, pogrupowane według agentów, z podsumowaniem tego, co poszło nie tak w każdym połączeniu.”

AI wywołuje narzędzie z następującymi parametrami:

{
"filters": [
{ "property": "timestamp", "operator": "gte", "value": "2026-11-09 00:00:00" },
{ "property": "cx_score", "operator": "lt", "value": 6 }
],
"sort": { "by": "cx_score", "dir": "ASC" },
"limit": 100
}

get_cdrs​

Call Detail Records – surowy dziennik każdego etapu połączenia. Używaj go do statystyk wolumenu, analizy kosztów, rozkładów czasu trwania oraz podsumowań aktywności agentów. Dostępny bez CX Addon.

Parametry: takie same jak w get_recordings (filters, sort, limit, page)

Kluczowe pola odpowiedzi

PoleTypOpis
call_idnumberUnikalny identyfikator połączenia
calldatestringZnacznik czasu rozpoczęcia połączenia (UTC)
src_namestringNazwa agenta / dzwoniącego
dst_namestringNazwa miejsca docelowego
billsecnumberSekundy rozliczeniowe
durationnumberŁączny czas w sekundach, w tym dzwonienie
dispositionstringCONNECTED, NO ANSWER, BUSY, FAILED
chargenumberKoszt połączenia
typestringI = przychodzące, O = wychodzące
src_uastringUrządzenie źródłowe / user-agent softphone
labelsarrayNiestandardowe tagi zastosowane w Voipstudio

get_live_calls​

Zwraca migawkę wszystkich aktywnych połączeń na Twoim koncie w czasie rzeczywistym. Nie wymaga parametrów.

Przykład: „Ile połączeń trwa teraz i którzy agenci w nich uczestniczą?”

get_voicemails​

Pobiera wiadomości głosowe. Przyjmuje te same parametry filters, sort, limit i page co get_recordings.

Kluczowe pola: caller, callerid, dialled (wybrany numer), origtime (czas pozostawienia wiadomości), duration, folder, is_new, transcript

get_recording_audio​

Zwraca adres pliku audio MP3 jednego nagrania wraz z numerem dzwoniącego, numerem wywoływanym, czasem i długością nagrania.

Parametr: id (number) — pole id z odpowiedzi get_recordings.

informacja

Adres prowadzi do API Voipstudio. Pobranie pliku spod tego adresu wymaga klucza API Voipstudio przesłanego w nagłówku x-auth-token, dlatego AI otrzymuje adres, a nie samo audio.

get_history_for_number​

Zwraca listę rozmów, czyli połączeń i wiadomości SMS, z jednym numerem telefonu na Twoim koncie.

Parametry

ParametrTypDomyślnieOpis
numberstring—Numer telefonu (wymagany)
fromDateTimestring—Opcjonalna data początkowa, YYYY-MM-DD HH:mm:ss
toDateTimestring—Opcjonalna data końcowa, YYYY-MM-DD HH:mm:ss

Pola odpowiedzi (jeden wpis na każde połączenie lub wiadomość): channel, date, direction (Inbound lub Outbound), src, dst, src_name, dst_name, content

Przykład: „Pokaż mi wszystkie połączenia i SMS-y z numerem +44 20 7946 0000 w tym miesiącu.”

Filtrowanie, sortowanie i paginacja​

Narzędzia get_recordings, get_cdrs i get_voicemails przyjmują opcjonalną tablicę filters. Każdy obiekt filtra ma trzy właściwości:

WłaściwośćOpis
propertyDowolne pole z odpowiedzi danego narzędzia (np. calldate, cx_score, src_name)
operatoreq, ne, lt, lte, gt, gte, in, like, notlike (działają też symbole =, !=, <, <=, >, >=)
valueString, number lub array (dla operatora in)

Pole daty zależy od narzędzia: calldate dla rekordów CDR, timestamp dla nagrań, origtime dla wiadomości głosowych.

Do sortowania wyników służy sort, na przykład { "by": "calldate", "dir": "DESC" }, a do podziału na strony – limit (domyślnie 10, maksymalnie 1000) i page (domyślnie 1).

Typowe przykłady​

Zakres dat (rekordy CDR)

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

Próg oceny CX (nagrania)

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

Konkretny agent

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

Tylko połączone rozmowy (rekordy CDR)

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

Połączenia przychodzące dłuższe niż 5 minut (rekordy CDR)

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

Przypadki użycia​

Raport QA agenta​

„Przygotuj podsumowanie QA dla każdego agenta w tym miesiącu — średnie oceny CX, częste motywy skarg oraz ich trzy najniżej ocenione rozmowy wraz z podsumowaniami.”

Statystyki wolumenu call centre​

„Jaki był nasz wolumen połączeń według dni w tym tygodniu? Jaki był średni czas obsługi i ile połączeń pozostało bez odpowiedzi?”

Analiza trendów sentymentu​

„Czy sentyment klientów poprawia się, czy pogarsza w porównaniu z poprzednim miesiącem? Które tematy rozmów korelują z negatywnym sentymentem?”

Lista połączeń nieodebranych do oddzwonienia​

„Wypisz wszystkie nieodebrane połączenia przychodzące z ostatnich 24 godzin wraz z identyfikatorami dzwoniących, żebym mógł ustalić priorytet oddzwonień.”

Historia klienta​

„Pokaż mi wszystkie połączenia i SMS-y, jakie mieliśmy z numerem +44 20 7946 0000 w tym roku, i podsumuj, o czym rozmawiano.”

Przegląd kosztów i rozliczeń​

„Które numery wewnętrzne wykonały najdroższe połączenia wychodzące w tym kwartale?”

Sprawdzenie operacji na żywo​

„Ilu agentów jest obecnie na połączeniach i czy są jakieś rozmowy trwające ponad 20 minut?”

Efektywność tokenów​

Każde połączenie, które AI analizuje bez CX Addon, wymaga przetworzenia treści audio oraz wygenerowania własnej transkrypcji i analizy. CX Addon w całości przenosi tę pracę na Voipstudio:

Co obsługuje Voipstudio (stały miesięczny koszt, nielimitowane połączenia):

  • Transkrypcja audio
  • Rozróżnianie mówców
  • Podsumowanie rozmowy
  • Klasyfikacja sentymentu
  • Wyodrębnianie elementów wymagających działania
  • Ocena CX

Co otrzymuje AI: czyste, ustrukturyzowane pola tekstowe gotowe do wnioskowania, porównywania i raportowania.

Oznacza to, że możesz poprosić AI o analizę setek połączeń w jednej sesji za ułamek kosztu tokenów, dzięki czemu QA na dużą skalę, analiza trendów i raporty coachingowe dla agentów stają się wykonalne bez nieprzewidywalnych wydatków na AI.