Strumenti MCP di 3CX e livelli di autorizzazione

Introduzione

Di seguito viene fornita una spiegazione delle funzioni IA supportate dal server 3CX MCP e dei relativi livelli di autorizzazione. Ciò consentirà di gestire le autorizzazioni del client IA, le connessioni MCP e le specifiche funzionalità del centralino accessibili all’IA.

Impostazioni di approvazione degli strumenti del client IA

Queste impostazioni definiscono le modalità di accesso del client IA ai singoli strumenti, fungendo da primo filtro prima che qualsiasi richiesta raggiunga il centralino.

  • Consenti sempre: Il client esegue immediatamente lo strumento senza alcun intervento.
  • Richiede approvazione: Il client richiede la conferma dell’utente prima di eseguire ogni richiesta.
  • Rifiuta: Il client impedisce completamente l’esecuzione dello strumento.

Queste impostazioni lato client non concedono diritti 3CX aggiuntivi, ma regolano come (e se) una richiesta viene inviata a 3CX. Il server 3CX MCP continua a valutare ogni richiesta come se provenisse dall’utente 3CX autenticato.

Integrazione delle autorizzazioni 3CX

Le funzionalità dell’IA sono strettamente limitate alle autorizzazioni dell’utente 3CX che ha autorizzato la connessione. Il server MCP associa la richiesta dell’IA a questo specifico account, ereditando tutti i controlli di accesso basati sui ruoli e le funzionalità associate.

  • Le restrizioni a livello di account, quali l’accesso ai reparti, la gestione delle code o le impostazioni DID, vengono sempre rispettate.
  • Se uno specifico utente 3CX non dispone dell’autorizzazione a modificare i dati, l’IA non può eseguire tali azioni, indipendentemente dalla configurazione lato client.
  • Lo strumento Query è strettamente limitato alle operazioni in sola lettura per garantire l’integrità del database.

Ruoli utente e accesso agli strumenti

L'elenco riportato di seguito mostra gli strumenti disponibili tramite il server 3CX MCP. Ciò che un utente può visualizzare o fare con tali strumenti dipende dalle autorizzazioni dell'account 3CX utilizzato per la connessione.

Strumenti in sola lettura

Questi strumenti consentono all'IA di visualizzare le informazioni provenienti dal centralino. Non modificano le impostazioni del centralino né influiscono sulle chiamate.

Utenti, contatti e rubrica

  • Cerca per e-mail: Trova un contatto in base all'indirizzo e-mail.
  • Cerca interno: Trova un contatto in base al numero di interno esatto.
  • Elenco contatti CRM: Cerca i contatti da un CRM integrato.
  • Elenco rubriche: Cerca nelle rubriche 3CX disponibili.
  • Elenco utenti: Elenca gli utenti e gli interni del centralino.

Chiamate, registrazioni e segreteria telefonica

  • Elenco delle chiamate attive: Mostra le chiamate attualmente in corso.
  • Elenco delle registrazioni: Elenco delle registrazioni disponibili per l'utente autenticato.
  • Elenco dei messaggi vocali: Elenco dei messaggi vocali disponibili per l'utente autenticato.

Code, dipartimenti e profili

  • Elenco dei membri di un reparto: Visualizza i membri di un reparto.
  • Elenco dei reparti: Visualizza i reparti accessibili all'utente autenticato.
  • Elenco dei profili: Visualizza i profili di inoltro o di presenza disponibili per l'utente corrente.
  • Elenco degli agenti di una coda: Visualizza gli agenti presenti in una coda.
  • Elenco delle code: Visualizza le code a cui l'utente corrente può accedere o che può gestire.

Sistema e diagnostica

  • Ottieni ora del server: Visualizza l'ora corrente del server del centralino.
  • Elenca registro eventi: Cerca o elenca le informazioni strutturate relative agli eventi del centralino.
  • Elenca servizi: Elenca i servizi del centralino e il loro stato attuale.
  • Cerca nei registri: Cerca nei registri delle applicazioni utilizzando i filtri disponibili.

Inventario PBX e database

  • Descrivi tabella: Restituisce lo schema di una tabella del database accessibile.
  • Elenca DID: Elenca i DID disponibili sul PBX.
  • Elenca lista nera IP: Elenca le voci presenti nella lista nera IP.
  • Elenca peer: Elenca i peer del PBX configurati.
  • Elenca lista nera telefoni: Elenca le voci presenti nella lista nera dei telefoni.
  • Elenca tabelle: Elenca le tabelle del database accessibili all’utente corrente.
  • Elenca trunk: Elenca i trunk SIP configurati.
  • Query: Esegue una query SQL SELECT in sola lettura sui dati accessibili.

Strumenti per i flussi di chiamata

  • Ottieni app flusso di chiamata: Recupera i dettagli di un'applicazione per il flusso di chiamata.
  • Ottieni file app flusso di chiamata: Recupera i file associati a un'applicazione per il flusso di chiamata.
  • Ottieni URL di modifica:  Restituisce un URL di modifica per un centralino supportato.
  • Elenca app flusso di chiamata: Elenca le applicazioni per il flusso di chiamata disponibili sul centralino.

Strumenti di scrittura o eliminazione

Gli strumenti di scrittura o eliminazione possono modificare lo stato della chiamata, lo stato dell’utente, i dati di instradamento, gli elenchi di blocco o il flusso di chiamata. Si raccomanda vivamente di mantenere questi strumenti impostati su Necessita approvazione o Bloccato, a meno che il flusso di lavoro non sia stato esaminato e all’utente autenticato non sia consentito eseguire l’azione.

Azioni relative a chiamate, code e profili

  • Interrompi chiamata: Termina una chiamata attiva selezionata.
  • Seleziona profilo: Attiva un profilo di inoltro o di presenza.
  • Imposta messaggio profilo: Imposta o cancella il messaggio per il profilo attivo.
  • Imposta sostituzione profilo: Applica una sostituzione temporanea del profilo.
  • Imposta stato agente in coda: Registra l’entrata o l’uscita di un agente dalla coda quando l’utente dispone dei diritti necessari.
  • Imposta stato coda: Registra l’entrata o l’uscita dell’utente corrente dalle code.

Azioni di configurazione del centralino

  • Aggiungi voce alla lista nera IP: Aggiungi un indirizzo IP alla lista nera IP del centralino.
  • Aggiungi numero alla lista nera dei telefoni: Aggiungi un numero alla lista nera dei telefoni.
  • Assegna un DID: Assegna un DID utilizzando le autorizzazioni disponibili per l'utente autenticato.
  • Rimuovi voce dalla lista nera degli indirizzi IP: Rimuovi un indirizzo IP dalla lista nera degli indirizzi IP del centralino.
  • Rimuovi numero dalla lista nera dei numeri di telefono: Rimuovi un numero dalla lista nera dei numeri di telefono.
  • Aggiorna lo script dell'applicazione di gestione del flusso delle chiamate: Aggiorna lo script utilizzato da un'applicazione di gestione del flusso delle chiamate.

Per saperne di più

Ultimo aggiornamento
Questo documento è stato aggiornato il 3 agosto 2026
https://www.3cx.it/doc/mcp-tools-permissions/