Collegare la CLI di ChatGPT al server 3CX MCP

Introduzione

Questa guida spiega come collegare Codex CLI al server 3CX MCP. Una volta configurato, Codex è in grado di interrogare le informazioni del centralino 3CX ed eseguire le azioni supportate in base alle autorizzazioni dell'utente 3CX autenticato.

Requisiti

Prima di iniziare, assicurati di disporre di:

  • Un PBX 3CX raggiungibile pubblicamente.
  • Accesso amministratore a Admin > Integrazione > Client MCP.
  • Un utente 3CX che può autenticare l'applicazione e utilizzare gli strumenti richiesti.
  • Codex CLI installato e registrato.

Copiare l'URL del server MCP da 3CX

Accedi alla Admin console  3CX e apri Admin > Integrazioni > Client MCP > Aggiungi Client MCP. Copia l'URL del server MCP visualizzato da 3CX e usalo esattamente come mostrato.

Connettere ChatGPT CLI a 3CX

Aggiungere il server MCP

Apri PowerShell (o un terminale) nello spazio di lavoro (in genere una cartella di progetto) in cui desideri utilizzare la connessione ed esegui il seguente comando, sostituendo l'esempio FQDN con l'URL del server MCP copiato da 3CX.

codex mcp add 3CX --url https://mypbx.3cx-example.com/mcp

Approvare l'accesso 3CX

Quando il comando ha esito positivo, Codex apre la pagina di autorizzazione 3CX nel tuo browser. Accedi con l'utente 3CX previsto, rivedi l'accesso richiesto e seleziona Allow (Consenti).

Avviare il Codex

Torna a PowerShell (o al tuo terminale) e avvia il client dalla stessa cartella.

codex

Verificare la connessione

Poni una semplice domanda, as esempio: “Usando il mio MCP 3CX, dimmi quanti interni ho sul mio centralino”. Una risposta positiva conferma che Codex può raggiungere il PBX e utilizzare gli strumenti disponibili per l'utente autenticato.

Autorizzazioni e limiti

Le richieste MCP utilizzano le autorizzazioni dell'utente 3CX che ha approvato la connessione. Codex può solo leggere informazioni o eseguire azioni a cui questo utente può accedere in 3CX.

Se una richiesta viene rifiutata o restituisce informazioni limitate, controlla il ruolo e i diritti 3CX dell'utente. Per i dettagli, consulta la guida di riferimento agli strumenti e alle autorizzazioni di 3CX MCP. (Riferimento strumenti e autorizzazioni MCP 3CX).

Per saperne di più

Ultimo aggiornamento

Questo documento è stato aggiornato il 21 agosto 2026

https://www.3cx.it/doc/connect-chatgpt-cli/