Collegare ChatGPT o Claude al server 3CX MCP

Introduzione

Questa guida illustra come configurare l’integrazione tra la tua IA (in questo esempio, prenderemo in esame l’utilizzo di un agente di chat) e il tuo centralino.

Ciò consente al tuo agente di chat di richiedere la maggior parte delle informazioni presenti sul centralino (ad esempio: richiedere un elenco di interni o delle chiamate attive). Questa funzionalità può rappresentare un ottimo strumento complementare alla admin console.

Requisiti di configurazione

Prima di iniziare, un amministratore del centralino deve provvedere a quanto segue:

  • Il centralino 3CX deve essere raggiungibile pubblicamente e utilizzare la porta 443.
  • Se il centralino NON è in esecuzione sulla porta 443, NON sarà possibile connettersi a OpenAI (Web), Claude (Web) o Claude (Desktop); sarai limitato all'uso di OpenAI (Desktop), OpenAI (Terminal) o Claude (Terminal).
  • Un utente 3CX autorizzato ad autenticarsi nell'applicazione e a utilizzare gli strumenti richiesti.
  • Il tuo client/agente AI preferito; ad esempio, ChatGPT o Claude.

Configurazione di ChatGPT

  • Accedi al tuo account OpenAI ChatGPT ed effettuate il login.

  • Nella pagina di ChatGPT, clicca sul tuo profilo nella parte inferiore della barra laterale e seleziona l’opzione Impostazioni

  • Abilita la modalità sviluppatore
  • Se l’opzione è nascosta o non può essere abilitata, potresti far parte di uno spazio di lavoro aziendale. Contatta il tuo amministratore per abilitare le autorizzazioni necessarie alla creazione di connettori MCP personalizzati.

  • Recupera l’URL MCP del tuo centralino da Admin > Integrazioni > Client MCP > Aggiungi client MCP all’interno della tua console di amministrazione 3CX.
  • Visita la pagina di gestione dei plugin di OpenAI ChatGPT.

  • Clicca sull’icona +.

  • Inserisci i seguenti dettagli::
  • Icona
  • Nome
  • Descrizione
  • URL di connessione

  • Se utilizzi ChatGPT Desktop, l’area appropriata in cui inserire l’URL si trova nella scheda Streamable HTTP.

  • Fornisci le credenziali e le autorizzazioni di configurazione corrette
  • Autenticazione (il tipo di autenticazione deve essere OAuth).
  • Seleziona la casella di controllo Ho compreso e desidero continuare.
  • Clicca sul pulsante Crea per procedere.

  • Ti verrà richiesto di effettuare l'accesso tramite il portale 3CX quando ti verrà chiesto di autorizzare l'integrazione.

  • Conferma le impostazioni e le opzioni aggiuntive relative allo strumento e al runtime presentate dal client AI.

  • Apri una nuova conversazione e verifica il funzionamento con una richiesta del tipo: Quanti interni ha il mio centralino?.

Configurazione di Claude

  • Accedi al tuo account Claude ed effettua il login.

  • Vai su Personalizza -> Connettori e clicca sull’opzione di menu Aggiungi -> Aggiungi connettore personalizzato.

  • Recupera l’URL MCP del tuo centralino da Admin > Integrazioni > Client MCP > Aggiungi client MCP all’interno della tua console di amministrazione 3CX.

  • Assegna un nome al connettore e inserisci l’URL dell’endpoint del server MCP di 3CX; clicca sul pulsante Aggiungi

  • Conferma le impostazioni e le opzioni aggiuntive relative allo strumento e al runtime presentate dal client AI.

  • Apri una nuova conversazione e verifica il funzionamento con una richiesta del tipo: «Quanti interni ha il mio centralino?».

Autorizzazioni e limiti

Le operazioni di intelligenza artificiale eseguite tramite l’MCP utilizzano le credenziali del tuo account 3CX, il che significa che ereditano il tuo ruolo e le tue autorizzazioni esistenti. Possono eseguire solo azioni o accedere a informazioni che sei già autorizzato a gestire direttamente in 3CX.

Ciò significa che il tentativo di richiamare e utilizzare funzionalità a cui non si ha accesso genererà errori e che questo è il comportamento previsto. Per ulteriori informazioni sulle autorizzazioni, consultare strumenti e livelli di autorizzazione di 3CX MCP.

Abilitazione del plugin a livello di organizzazione

È inoltre possibile rendere il proprio connettore disponibile per l’uso in tutta l’organizzazione seguendo la stessa procedura descritta sopra, tramite le aree relative all’area di lavoro nell’interfaccia utente del proprio fornitore di IA.

Per gestire le implementazioni a livello di organizzazione, i diritti di pubblicazione e le restrizioni a livello amministrativo, fare riferimento alla documentazione ufficiale fornita dai fornitori delle piattaforme:

Per saperne di più

Ultimo aggiornamento
Questo documento è stato aggiornato il 4 agosto 2026
https://www.3cx.it/doc/connect-chatgpt-claude-mcp-server/