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
Adres URL serwera 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:
- 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.
- 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.
- 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:
- Otwórz Settings → Connectors i wybierz Add custom connector. W planach Team i Enterprise konektor dla organizacji dodaje jej właściciel.
- Wpisz nazwę, na przykład
Voipstudio, oraz podany wyżej adres URL serwera MCP. - 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 adresamihttps://mcp.voipstudio.com/.well-known/oauth-authorization-serverihttps://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
initializeitools/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 Addon | Z CX Addon | |
|---|---|---|
| Transkrypcja | AI musi pobrać audio i wykonać transkrypcję/tłumaczenie | ✓ W zestawie, z rozróżnieniem mówców |
| Podsumowanie | AI musi je wygenerować | ✓ W zestawie |
| Sentyment | AI musi go wywnioskować | ✓ W zestawie |
| Elementy wymagające działania | AI musi je wyodrębnić | ✓ W zestawie |
| Ocena CX | Niedostępna | ✓ 1–10 dla każdego połączenia |
| Przybliżona liczba tokenów na połączenie | 10 000–15 000 | 300–500 |
| Model kosztowy | Zmienny wydatek na AI | Stała miesięczna subskrypcja |
Pola odblokowane przez CX Addon
| Pole | Typ | Opis |
|---|---|---|
transcript | string | Pełna transkrypcja na poziomie słów |
transcript_speakers | object | Segmenty transkrypcji z rozróżnieniem mówców |
summary | string | Zwięzłe podsumowanie wyniku rozmowy |
sentiment | string | Sentyment klienta: positive, neutral, negative |
cx_score | number (1–10) | Ocena doświadczenia klienta |
metadata.timeline | array | Kluczowe 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
| Parametr | Typ | Domyślnie | Opis |
|---|---|---|---|
filters | array | — | Obiekty filtrów, zobacz Filtrowanie, sortowanie i paginacja poniżej |
sort | object | — | { "by": "<field>", "dir": "ASC" } lub "DESC" |
limit | number | 10 | Liczba rekordów na stronie (1–1000) |
page | number | 1 | Numer strony |
Pola odpowiedzi
| Pole | Typ | Opis |
|---|---|---|
id | number | Unikalny identyfikator nagrania |
call_id | number | Łączy z call_id rekordu CDR |
timestamp | string | Początek nagrania (UTC, YYYY-MM-DD HH:mm:ss) |
caller | string | Numer strony dzwoniącej |
called | string | Numer strony odbierającej |
src_name | string | Nazwa agenta (źródło) |
dst_name | string | Nazwa miejsca docelowego |
duration | number | Czas trwania w sekundach |
type | string | I = przychodzące, O = wychodzące |
context | string | Kontekst połączenia (np. LOCAL_USER, QUEUE) |
transcript | string | null | Pełna transkrypcja (CX Addon) |
transcript_speakers | object | null | Transkrypcja z rozróżnieniem mówców (CX Addon) |
summary | string | null | Podsumowanie rozmowy (CX Addon) |
sentiment | string | null | Sentyment klienta (CX Addon) |
cx_score | number | null | Ocena CX 1–10 (CX Addon) |
metadata.timeline | array | null | Kluczowe 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
| Pole | Typ | Opis |
|---|---|---|
call_id | number | Unikalny identyfikator połączenia |
calldate | string | Znacznik czasu rozpoczęcia połączenia (UTC) |
src_name | string | Nazwa agenta / dzwoniącego |
dst_name | string | Nazwa miejsca docelowego |
billsec | number | Sekundy rozliczeniowe |
duration | number | Łączny czas w sekundach, w tym dzwonienie |
disposition | string | CONNECTED, NO ANSWER, BUSY, FAILED |
charge | number | Koszt połączenia |
type | string | I = przychodzące, O = wychodzące |
src_ua | string | Urządzenie źródłowe / user-agent softphone |
labels | array | Niestandardowe 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.
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
| Parametr | Typ | Domyślnie | Opis |
|---|---|---|---|
number | string | — | Numer telefonu (wymagany) |
fromDateTime | string | — | Opcjonalna data początkowa, YYYY-MM-DD HH:mm:ss |
toDateTime | string | — | 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 |
|---|---|
property | Dowolne pole z odpowiedzi danego narzędzia (np. calldate, cx_score, src_name) |
operator | eq, ne, lt, lte, gt, gte, in, like, notlike (działają też symbole =, !=, <, <=, >, >=) |
value | String, 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.