Narzędzia 3CX MCP i poziomy uprawnień

Wprowadzenie

Poniżej znajduje się wyjaśnienie funkcji AI obsługiwanych przez serwer 3CX MCP oraz powiązanych poziomów uprawnień. Pozwoli to na zarządzanie uprawnieniami klientów AI, połączeniami MCP oraz konkretnymi funkcjami centrali PBX dostępnymi dla sztucznej inteligencji.

Ustawienia zatwierdzania narzędzi klienta AI

Ustawienia te definiują sposób, w jaki klient AI uzyskuje dostęp do poszczególnych narzędzi, służąc jako pierwszy punkt kontrolny przed dotarciem żądania do centrali PBX.

  • Always allow (Zawsze zezwalaj): Klient natychmiast wykonuje narzędzie bez ingerencji użytkownika.
  • Needs approval (Wymaga zatwierdzenia): Klient prosi o potwierdzenie przez użytkownika przed wykonaniem każdego żądania.
  • Deny (Odmów): Klient całkowicie blokuje działanie narzędzia.

Te ustawienia po stronie klienta nie nadają dodatkowych uprawnień w 3CX, lecz określają sposób (i to, czy w ogóle) przesyłania żądania do 3CX. Serwer 3CX MCP nadal ocenia każde żądanie jako uwierzytelniony użytkownik 3CX.

Integracja uprawnień 3CX

Możliwości AI są ściśle ograniczone do uprawnień użytkownika 3CX, który autoryzował połączenie. Serwer MCP przypisuje żądanie AI do tego konkretnego konta, dziedzicząc wszystkie powiązane mechanizmy kontroli dostępu oparte na rolach (RBAC) oraz funkcjonalności.

  • Ograniczenia na poziomie konta, takie jak dostęp do działów, zarządzanie kolejkami czy ustawienia numerów DID, są zawsze przestrzegane.
  • Jeśli konkretny użytkownik 3CX nie ma uprawnień do modyfikowania danych, AI nie może wykonać tych akcji, niezależnie od konfiguracji po stronie klienta.
  • Narzędzie Query (Zapytanie) jest ściśle ograniczone do operacji tylko do odczytu, aby zapewnić integralność bazy danych.

Role użytkowników i dostęp do narzędzi

Poniższa lista pokazuje narzędzia dostępne przez serwer 3CX MCP. To, co użytkownik może zobaczyć lub zrobić, zależy od uprawnień konta 3CX użytego do połączenia.

Narzędzia tylko do odczytu (Read-Only)

Narzędzia te pozwalają AI na przeglądanie informacji z centrali PBX. Nie zmieniają one ustawień centrali ani nie wpływają na połączenia.

Użytkownik, kontakty i katalog

  • Find by email – Znajdź kontakt po adresie e-mail.
  • Find extension – Znajdź kontakt po dokładnym numerze wewnętrznym.
  • List CRM contacts – Przeszukuj kontakty ze zintegrowanego systemu CRM.
  • List phonebook – Przeszukuj dostępne książki telefoniczne 3CX.
  • List users – Wyświetl listę użytkowników i numerów wewnętrznych centrali PBX.

Połączenia, nagrania i poczta głosowa

  • List active calls – Pokaż aktualnie aktywne połączenia.
  • List recordings – Wyświetl listę nagrań dostępnych dla uwierzytelnionego użytkownika.
  • List voicemails – Wyświetl listę wiadomości poczty głosowej dostępnych dla uwierzytelnionego użytkownika.

Kolejki, działy i profile

  • List department members – Pokaż członków działu.
  • List departments – Wyświetl listę działów dostępnych dla uwierzytelnionego użytkownika.
  • List profiles – Pokaż profile przekierowań lub statusu dostępne dla bieżącego użytkownika.
  • List queue agents – Pokaż agentów w kolejce.
  • List queues – Wyświetl listę kolejek, do których bieżący użytkownik ma dostęp lub którymi może zarządzać.

System i diagnostyka

  • Get server time – Pokaż aktualny czas serwera PBX.
  • List event log – Przeszukuj lub wyświetlaj ustrukturyzowane informacje z dziennika zdarzeń PBX.
  • List services – Wyświetl listę usług PBX i ich bieżący stan.
  • Search logs – Przeszukuj logi aplikacji przy użyciu dostępnych filtrów.

Inwentaryzacja centrali PBX i baza danych

  • Describe table – Zwróć schemat dostępnej tabeli bazy danych.
  • List DIDs – Wyświetl listę numerów DID dostępnych w centrali PBX.
  • List IP blocklist – Wyświetl wpisy na czarnej liście adresów IP.
  • List peers – Wyświetl listę skonfigurowanych połączeń peer.
  • List phone blacklist – Wyświetl wpisy na czarnej liście numerów telefonów.
  • List tables – Wyświetl tabele bazy danych dostępne dla bieżącego użytkownika.
  • List trunks – Wyświetl listę skonfigurowanych trunków SIP.
  • Query – Uruchom zapytanie SQL SELECT (tylko do odczytu) na dostępnych danych.

Narzędzia przepływu połączeń (Call Flow)

  • Get call flow app – Pobierz szczegóły aplikacji przepływu połączeń.
  • Get call flow app files – Pobierz pliki powiązane z aplikacją przepływu połączeń.
  • Get edit URL – Zwróć adres URL do edycji obsługiwanego obiektu PBX.
  • List call flow apps – Wyświetl listę aplikacji przepływu połączeń dostępnych w centrali PBX.

Narzędzia zapisu lub usuwania (Write or Delete)

Narzędzia te mogą zmieniać stan połączeń, status użytkownika, dane routingu, czarne listy lub przepływ połączeń. Zdecydowanie zaleca się, aby narzędzia te były ustawione na „Needs approval” (Wymaga zatwierdzenia) lub „Blocked” (Zablokowane), chyba że dany proces został zweryfikowany, a uwierzytelniony użytkownik posiada uprawnienia do wykonania danej akcji.

Akcje na połączeniach, kolejkach i profilach

  • Drop call – Zakończ wybrane aktywne połączenie.
  • Select profile – Aktywuj profil przekierowań lub statusu.
  • Set profile message – Ustaw lub wyczyść wiadomość dla aktywnego profilu.
  • Set profile override – Zastosuj tymczasowe nadpisanie profilu.
  • Set queue agent status – Zaloguj agenta do kolejki lub go wyloguj (jeśli użytkownik posiada wymagane uprawnienia).
  • Set queue status – Zaloguj bieżącego użytkownika do kolejek lub go wyloguj.

Akcje konfiguracji centrali PBX

  • Add IP blocklist entry – Dodaj adres IP do czarnej listy IP centrali PBX.
  • Add phone blacklist number – Dodaj numer do czarnej listy numerów telefonów.
  • Assign DID – Przypisz numer DID, korzystając z uprawnień dostępnych dla uwierzytelnionego użytkownika.
  • Remove IP blocklist entry – Usuń adres IP z czarnej listy IP centrali PBX.
  • Remove phone blacklist number – Usuń numer z czarnej listy numerów telefonów.
  • Update call flow app script – Zaktualizuj skrypt używany przez aplikację przepływu połączeń.

Zobacz również


Ostatnia aktualizacja
Ten dokument został ostatnio zaktualizowany 28 lipca 2026 r.
https://www.3cx.pl/docs/mcp-tools-permissions/