Collegare Claude ChatGPT Copilot e altri strumenti MCP a Smart OSH

SmartOSH espone un server MCP remoto a cui puoi connetterti da Claude, ChatGPT o un altro strumento compatibile con MCP per consultare le tue informazioni con assistenza IA.

Conoscenze preliminari

Questa guida presuppone che conosca già il funzionamento del tuo client MCP (Claude, ChatGPT, Copilot, ecc.) e che tu sia familiarizzato con il concetto di MCP. SmartOSH non offre supporto sull’uso di questi strumenti oltre all’aiuto necessario per effettuare la connessione.

Cos’è MCP

MCP (Model Context Protocol) è uno standard aperto che permette agli assistenti IA, come Claude o ChatGPT, di connettersi in modo sicuro ad applicazioni e dati esterni. Invece di copiare e incollare manualmente le informazioni, l’assistente si connette al server MCP e può accedere ai dati messi a disposizione dall’applicazione.

SmartOSH dispone di un proprio server MCP, quindi puoi aggiungerlo come connettore personalizzato in Claude, ChatGPT (o altro strumento compatibile) e lavorare con le tue informazioni direttamente dall’assistente.

La funzione MCP è opzionale

La connessione MCP è una funzione opzionale e, per sicurezza, è disattivata di default (opt-in esplicito). Se la funzione non è attivata, il connettore non potrà connettersi.

L’attivazione non si effettua dalle impostazioni: è il consulente o il team di supporto che la abilita su richiesta del cliente. Per sicurezza, il team di SmartOSH verifica la richiesta prima di attivare il servizio.

Una volta attivato il servizio, le funzionalità specifiche (tools) —come l’invio di email— e i domini autorizzati per tale invio si configurano nelle impostazioni, allo stesso modo delle altre funzionalità IA di SmartOSH.

Cosa offre MCP di SmartOSH

Il server MCP di SmartOSH va oltre l’esposizione di dati: incorpora diverse funzionalità (tools), prompt predefiniti e conoscenze specifiche di PRL affinché l’assistente IA lavori in modo più utile e guidato. Tra le altre capacità, offre:

• Recupero informazioni: consultazione di incidenti, rapporti e documenti, tra altri dati.
• Invio di email direttamente da SmartOSH (soggetto ai domini autorizzati configurati).
• Prompt predefiniti per attività abituali, che facilitano l’ottenimento di risultati coerenti senza dover scrivere istruzioni da zero.
• Metodologia specifica di indagine sugli incidenti e altre conoscenze specializzate in PRL integrate nel servizio stesso.

Nota

L’insieme di strumenti disponibili può ampliarsi nel tempo e dipende dalle funzioni attivate per la tua organizzazione.

URL del server MCP di SmartOSH

Usa l’URL corrispondente all’ambiente con cui vuoi lavorare:

• Produzione:

https://backend.my.smartosh.com/mcp

• Preproduzione:

https://backend.pre-my.smartosh.com/mcp

Attenzione

Questi sono gli URL generici. Normalmente, ogni cliente ha il proprio URL personalizzato con il formato:

https://MIEMPRESA.backend.my.smartosh.com/mcp

Dove MIEMPRESA è il sottodominio personalizzato della tua organizzazione. Se non conosci questo sottodominio, devi richiederlo al tuo consulente o al supporto prima di configurare il connettore.

Come connettere Claude (connettore personalizzato)

Per aggiungere un connettore personalizzato in Claude ti serve un server MCP remoto a cui connetterti; in questo caso, una delle URL di SmartOSH indicate sopra. I passaggi variano in base al tuo piano Claude.

Piani individuali (Free, Pro o Max)

1. Vai su Customize > Connectors (Personalizza > Connettori) nelle impostazioni, oppure premi il pulsante «+» accanto a Connectors.
2. Premi Add custom connector (Aggiungi connettore personalizzato) per crearne uno nuovo.
3. Scrivi un nome per identificarlo (ad esempio, SmartOSH).
4. Aggiungi l’URL del server MCP remoto di SmartOSH (quella indicata dal tuo consulente o supporto).
5. (Opzionale) Premi Advanced settings per specificare un OAuth Client ID e un OAuth Client Secret del tuo server.
6. Premi Add e segui il processo di connessione (autenticazione), come con i connettori della directory.

Piani Team o Enterprise

In questi piani, prima che i membri possano configurare connettori personalizzati, un Owner o Primary Owner deve prima aggiungere il connettore all’organizzazione:

1. L’Owner o Primary Owner va su Organization settings > Connectors, preme Add e aggiunge l’URL del server MCP remoto di SmartOSH.
2. Ogni utente trova poi il connettore nella lista (apparirà con un’etichetta «Custom») e preme Connect per autenticarsi e iniziare a usarlo.

Disponibilità per piano

I connettori personalizzati tramite MCP remoto sono disponibili in Claude, Cowork e Claude Desktop per i piani Free, Pro, Max, Team e Enterprise. Gli utenti Free sono limitati a un solo connettore personalizzato, mentre Pro, Max, Team e Enterprise ne supportano diversi.

Come connettere ChatGPT (connettore personalizzato)

In ChatGPT, i connettori MCP personalizzati si gestiscono tramite il Developer mode (modalità sviluppatore).

Attivare il Developer mode

1. Apri ChatGPT sul web e accedi con un account di un piano compatibile.
2. Vai su Settings > Connectors (Impostazioni > Connettori) — a seconda della versione può apparire come Apps.
3. Entra in Advanced settings (Impostazioni avanzate); potrebbe essere necessario scorrere verso il basso per trovarlo.
4. Attiva l’interruttore di Developer mode.

Creare il connettore

1. In Settings > Connectors (o Apps), premi Create (Crea) accanto a Advanced settings. Il pulsante appare solo se il Developer mode è attivato.
2. Scrivi un nome per identificarlo (ad esempio, SmartOSH).
3. (Opzionale) Aggiungi una descrizione, ad esempio «Accesso ai dati di SmartOSH».
4. In MCP Server URL, incolla l’URL del server MCP remoto di SmartOSH.
5. In Authentication seleziona il metodo corrispondente (normalmente OAuth) e completa il processo di autenticazione.
6. Salva il connettore. Apparirà nella tua lista di connettori (in Drafts mentre si configura).

Usarlo in una conversazione

1. Apri una nuova conversazione e premi l’icona «+» del compositore.
2. Seleziona Developer mode e attiva il connettore SmartOSH come fonte.

Disponibilità per piano in ChatGPT

Il supporto completo ai connettori MCP in ChatGPT è disponibile nei piani Plus, Pro, Business, Enterprise e Education (non nel piano Free) da ChatGPT web. Nei piani Plus e Pro gli strumenti sono solitamente limitati a sola lettura, mentre in Business e Enterprise/Education sono consentite azioni di scrittura, normalmente con autorizzazione di un amministratore.

Come connettere Microsoft Copilot

Nell’ecosistema Microsoft, i server MCP si connettono tramite Copilot Studio, dove si aggiungono come strumento a un agente.

1. Entra in Copilot Studio e apri (o crea) l’agente a cui vuoi aggiungere la connessione.
2. Vai alla scheda Tools (Strumenti) e premi Add a tool > New tool > Model Context Protocol.
3. Compila i campi della procedura guidata:
   • Server name (nome del server): ad esempio, SmartOSH.
   • Server description (descrizione): una breve spiegazione dello scopo, poiché l’orchestrator la usa per decidere quando chiamare il server.
   • Server URL: l’URL del server MCP remoto di SmartOSH.
4. Configura l’autenticazione corrispondente (di solito OAuth 2.0) e completa la procedura guidata. Copilot Studio rileva automaticamente gli strumenti disponibili sul server.

Nota

L’accesso ai server MCP in Copilot Studio è regolato dalle policy dati di Power Platform della tua organizzazione.

Come connettere Gemini

In Gemini la via abituale per connettori MCP remoti è la Gemini CLI (rivolta a profili tecnici). Con la CLI installata, aggiungi il server con:

gemini mcp add --transport http SmartOSH <URL-del-server-MCP>

Se il server richiede autenticazione tramite header, puoi aggiungerla con -H:

gemini mcp add --transport http --header "Authorization: Bearer <token>" SmartOSH <URL-del-server-MCP>

Questo salva la configurazione in ~/.gemini/settings.json (ambito utente) o in .gemini/settings.json (ambito progetto). All’interno di Gemini CLI puoi eseguire /mcp per vedere il server configurato e i suoi strumenti.

Nota

In ambienti aziendali Google Cloud, i connettori MCP possono anche essere gestiti dalla Gemini Enterprise Agent Platform, indicando il nome del server, l’URL, il trasporto HTTP e i dati di autenticazione (credenziali Google Cloud o OAuth Client ID/Secret).

Altri client compatibili con MCP

Il server MCP di SmartOSH segue lo standard MCP, quindi può connettersi da qualsiasi client compatibile (ad esempio editor e strumenti di sviluppo come Cursor, VS Code o Cline, tra gli altri). Sebbene l’interfaccia cambi a seconda dello strumento, in generale ti servono solo questi dati:

• L’URL del server MCP remoto di SmartOSH (produzione o preproduzione).
• Il metodo di autenticazione (ad esempio OAuth, con Client ID e Client Secret se necessario).

Consiglio

Se il tuo strumento non appare in questa pagina, consulta la sua documentazione su come aggiungere un server MCP remoto e usa l’URL e i dati di autenticazione forniti dal tuo consulente o dal supporto.

Responsabilità e protezione dei dati

Attraverso il servizio MCP, SmartOSH si limita a esporre dati e strumenti. Il processamento delle informazioni da parte dell’IA è effettuato dal motore o dallo strumento esterno che decidi di connettere (Claude, ChatGPT, Copilot, Gemini o altro), fuori dal controllo di SmartOSH.

Durante l’uso di MCP, SmartOSH non utilizza i propri motori IA. Pertanto, il consumo di token (e qualsiasi costo associato) è a carico del cliente e dello strumento IA utilizzato.

Di conseguenza, i seguenti aspetti sono responsabilità del cliente e dello strumento IA utilizzato:

• Gli aspetti legali dell’uso dell’IA.
• La zona geografica in cui l’IA viene eseguita e i dati elaborati.
• Le implicazioni di protezione dati e la conformità ai regolamenti applicabili sull’IA.

Dati personali nei campi di testo

SmartOSH fa il massimo sforzo per pseudonimizzare i dati relativi ai nomi dei dipendenti. Tuttavia, le descrizioni e i testi liberi inseriti dagli utenti nei campi di descrizione possono contenere dati personali.

Il controllo normativo su dove e come questi dati vengono elaborati è a carico del cliente che attiva il servizio MCP. Prima di abilitarlo, assicurati che lo strumento IA scelto e la sua regione di elaborazione rispettino i tuoi obblighi legali e di protezione dati.