AI - Sztuczna Inteligencja - Serwer MCP VoIPstudio¶

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

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

Uzyskanie klucza API¶

Serwer MCP uwierzytelnia się za pomocą tokenu API VoIPstudio. Każdy klucz jest przypisany do konkretnego użytkownika, więc Claude będzie mógł uzyskać dostęp wyłącznie do danych, do których dostęp ma ten użytkownik.

Aby wygenerować klucz:

1. W panelu administracyjnym otwórz użytkownika, dla którego chcesz wygenerować token.
2. Przejdź do sekcji API Keys.
3. Wprowadź nazwę klucza — na przykład Claude MCP.
4. Kliknij Add.
5. Kliknij ikonę oka, aby wyświetlić klucz API / user_token. Skopiuj tę wartość.
6. Aby wyświetlić dodatkowe szczegóły lub usunąć klucz, kliknij ikonę koła zębatego i wybierz Show Details.

Uwaga: Klucz API pozostaje ważny tak długo, jak jest używany co najmniej raz na 7 dni (domyślny limit czasu). W razie potrzeby ustaw dłuższy limit czasu (lub brak limitu) przed kliknięciem Add.

Zobacz dokumentację REST API

Łączenie z Claude¶

VoIPstudio nie znajduje się obecnie w katalogu konektorów Claude.ai. Należy dodać je ręcznie jako niestandardowy serwer MCP.

Adres URL serwera MCP¶

Kroki (Claude.ai)¶

1. W Claude.ai przejdź do Settings → Integrations (lub panelu konektorów, zależnie od planu).
2. Wybierz Add custom MCP server (lub odpowiednią opcję).
3. Wprowadź powyższy adres URL serwera MCP.
4. Gdy pojawi się prośba o uwierzytelnienie, podaj swój klucz API VoIPstudio.
5. Zapisz i autoryzuj połączenie.

Claude może teraz wywoływać narzędzia VoIPstudio w dowolnej rozmowie. Przy pierwszym wywołaniu narzędzia w sesji Claude poprosi o potwierdzenie udostępniania danych. Kliknij Always allow, aby pominąć ten monit w przyszłych sesjach.

Anthropic API (dla programistów)¶

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

Łączenie z innymi platformami AI¶

Większość platform AI obsługujących zewnętrzne MCP może połączyć się z serwerem MCP VoIPstudio, używając tego samego adresu URL i klucza API. Dokładne kroki konfiguracji będą się różnić w zależności od platformy. Poszukaj opcji oznaczonej jako external MCP server, custom MCP lub remote MCP w integracjach albo ustawieniach swojej platformy.

CX Addon¶

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

Dzięki CX Addon VoIPstudio obsługuje transkrypcję, podsumowania, analizę sentymentu, wyodrębnianie 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. Claude otrzymuje gotowe informacje — od razu gotowe do dalszej analizy.

Pola odblokowane przez CX Addon¶

Referencja narzędzi¶

Prostota integracji MCP oznacza, że nie trzeba rozumieć złożonych API. Zamiast tego proste prompty mogą pomóc platformie AI zrozumieć dane dostarczone przez VoIPstudio i odpowiedzieć w odpowiedni sposób.

Niektórzy bardziej techniczni użytkownicy mogą jednak chcieć wiedzieć, co dzieje się „pod maską”, dlatego poniżej znajduje się przewodnik referencyjny po niektórych funkcjach serwera MCP.

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 zwracają null.

Parametry

Pola odpowiedzi

Przykład – Niskie oceny CX w tym tygodniu

Zapytaj Claude: „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.”

Claude wywoła narzędzie z:

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

get_cdrs¶

Call Detail Records — surowy dziennik każdego etapu połączenia. Używany 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, limit, page)

Kluczowe pola odpowiedzi

get_live_calls¶

Zwraca w czasie rzeczywistym migawkę wszystkich aktywnych połączeń na Twoim koncie. 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. Używa tego samego interfejsu filters, limit i page co inne narzędzia.

Kluczowe pola możliwe do filtrowania: src, dst, calldate, duration, listened

get_recording_audio¶

Zwraca bezpośredni adres URL do pobrania pliku audio MP3 dla konkretnego nagrania.

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

Filtrowanie i paginacja¶

Wszystkie narzędzia listujące akceptują opcjonalną tablicę filters. Każdy obiekt filtra ma trzy właściwości:

Typowe przykłady¶

Zakres dat

[
  { "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

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

Konkretny agent

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

Tylko połączone rozmowy

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

Połączenia przychodzące powyżej 5 minut

[
  { "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 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ń.”

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 analizowane przez Claude bez CX Addon wymaga od Claude przetworzenia treści audio oraz wygenerowania własnej transkrypcji i analizy. CX Addon całkowicie przenosi ten proces do 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 Claude: Czyste, ustrukturyzowane pola tekstowe gotowe do wnioskowania, porównywania i raportowania.

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