Collegare il terminale Claude al server 3CX MCP

Introduzione

Questa guida spiega come collegare Claude Code in un terminale al server 3CX MCP. Dopo l’autorizzazione, Claude potrà utilizzare gli strumenti 3CX MCP a disposizione dell’utente 3CX che ha approvato la connessione.

Requisiti

  • Il tuo centralino 3CX deve essere raggiungibile pubblicamente.
  • Un utente 3CX autorizzato ad autenticare l’applicazione e a utilizzare gli strumenti richiesti.
  • Claude Code installato e con accesso effettuato.
  • Un terminale aperto nella cartella del progetto in cui verrà utilizzata la connessione.

Copiare l’URL del server MCP da 3CX

Accedere alla Admin console 3CX e andare su Admin > Integrazioni > Client MCP > Aggiungi client MCP. Copiare l’URL del server MCP visualizzato da 3CX e utilizzarlo esattamente come indicato.

Collegare il terminale Claude

Aggiungere il server MCP

Eseguire il seguente comando dalla cartella del progetto. Sostituire il FQDN di esempio con l’URL del server MCP copiato da 3CX.

claude mcp add --scope project --transport http 3CX "https://yourpbx.3cx.eu/mcp"

Avviare Claude nella stessa cartella.

claude

Claude rileva il nuovo server MCP del progetto e chiede come si desidera procedere.

Autenticarsi da /mcp

  • Inserire /mcp per aprire il gestore del server MCP.

  • Selezionare il server 3CX con i tasti freccia e premere Invio.

  • Scegliere Autenticazione.

  • Claude apre la pagina di autorizzazione nel browser. Se non si apre automaticamente, copiare l’URL visualizzato nel terminale e aprirlo manualmente.

  • Accedere a 3CX, verificare l’accesso richiesto e selezionare Consenti.

  • Claude conferma quando l’autenticazione va a buon fine.

  • La connessione appare anche in Admin > Integrazioni > Client MCP nella console di amministrazione 3CX.

Verifica la connessione

  • Chiedere: “Quanti interni ha il mio centralino?” Claude mostra lo strumento 3CX che intende utilizzare e chiede l'approvazione.

  • Approvare la richiesta per ricevere il risultato.

Autorizzazioni e limiti

Claude utilizza le autorizzazioni dell’utente 3CX che ha approvato la connessione. Può accedere solo ai dati e alle azioni che tale utente è già autorizzato a utilizzare in 3CX.

Se una richiesta viene rifiutata o restituisce dati limitati, controlla il ruolo e i diritti dell’utente in 3CX. Per ulteriori dettagli, consulta la Guida di riferimento agli strumenti e alle autorizzazioni di 3CX MCP.

Per saperne di più

Ultimo aggiornamento

Il presente documento è stato aggiornato il 21 agosto 2026

https://www.3cx.it/doc/connect-claude-terminal/