Connetti qualsiasi client MCP

claude.ai, Claude Desktop, Claude Code e ChatGPT si connettono tramite accesso: aggiungi l'URL del server senza intestazioni, accedi a ISMS Copilot quando il client lo richiede e clicca Approva. Non c'è alcun token da copiare. Altri client utilizzano un token di accesso personale (sezione 3).

1. Endpoint

https://account.ismscopilot.com/v1/account/mcp

Trasporto: HTTP MCP. Autenticazione: accesso a ISMS Copilot e approvazione (OAuth). Fallback: Authorization: Bearer pat-isms-…

2. Passaggi per il client

claude.ai e Claude Desktop (connettore personalizzato)

Questi passaggi sono per claude.ai. Claude Desktop utilizza gli stessi connettori del tuo account Claude.

1. In Claude, apri Personalizza → Connettori, clicca + Aggiungi, poi Aggiungi connettore personalizzato.
2. Assegnagli il nome ISMS Copilot, incolla l'endpoint sopra come URL del server MCP remoto e continua.
3. Lascia vuoti i campi OAuth avanzati e non aggiungere intestazioni di richiesta.
4. Clicca Aggiungi, poi Connetti. Accedi a ISMS Copilot e clicca Approva.

In un'organizzazione Claude Team o Enterprise, un Owner aggiunge il connettore una volta sotto Impostazioni organizzazione → Connettori (Aggiungi, poi Personalizzato, poi Web). Ogni membro lo trova poi sotto Personalizza → Connettori e clicca Connetti, accedendo con il proprio account ISMS Copilot. Nessuno agisce per conto di altri.

ChatGPT (app MCP personalizzata)

ChatGPT si connette tramite accesso con le impostazioni predefinite. ISMS Copilot non è presente nella directory delle app di ChatGPT: aggiungilo tu come app personalizzata.

1. Nelle impostazioni di ChatGPT, attiva la modalità sviluppatore (nelle versioni recenti si trova con le impostazioni delle app). Nei workspace Business ed Enterprise potrebbe essere necessario che un amministratore consenta prima le app MCP personalizzate.
2. Crea un'app personalizzata (ChatGPT potrebbe chiamarla connettore), chiamala ISMS Copilot e incolla l'endpoint sopra come URL del server MCP.
3. Scegli OAuth come autenticazione e mantieni le impostazioni predefinite.
4. Creala, poi connettiti: accedi a ISMS Copilot e clicca Approva.

I nomi dei menu di ChatGPT cambiano tra piani e versioni. I passaggi attuali di OpenAI: Developer mode and MCP apps in ChatGPT.

Claude Code

claude mcp add --scope user --transport http ismscopilot https://account.ismscopilot.com/v1/account/mcp

Poi esegui /mcp in una sessione, seleziona ismscopilot, accedi e clicca Approva. Guida completa: Connetti ISMS Copilot a Claude Code.

Cursor e Codex

Utilizza un token di accesso personale: forme di configurazione in Connetti Cursor e Codex. Possono anche connettersi con accesso dove il client supporta MCP OAuth.

Qualsiasi altro client

Aggiungi un server MCP HTTP remoto con l'endpoint sopra e un token di accesso personale (sezione 3). Un client che supporta l'accesso MCP può anche connettersi senza token.

Cosa approvi

Il client può leggere il tuo account, gli spazi di lavoro, i documenti (metadati), i ricordi e il profilo aziendale; chiedere a ISMS Copilot e leggere le risposte; aggiornare il profilo aziendale e i ricordi, e creare spazi di lavoro. Non può creare chiavi API o acquistare crediti. Le modifiche apportate sono etichettate in ISMS Copilot come Added by OAuth app: <name> o Updated by OAuth app: <name>, con il nome registrato dal client. Puoi disconnetterlo in qualsiasi momento in Impostazioni → App connesse, sotto Agenti connessi.

3. Token di accesso personale

Per Cursor, Codex e altri client che non effettuano l'accesso, o per CI e macchine headless:

1. In chat.ismscopilot.com, apri Impostazioni → App connesse → Crea token. Copia il valore pat-isms-… una volta.
2. Aggiungi il server con l'intestazione Authorization: Bearer pat-isms-…. Claude Code:

claude mcp add --scope user --transport http ismscopilot \
  https://account.ismscopilot.com/v1/account/mcp \
  --header "Authorization: Bearer pat-isms-..."

Mantieni --scope user in modo che il server sia disponibile in ogni cartella. Configurazioni token per Cursor e Codex: Connetti Cursor e Codex.

4. Modalità (Fast, Think, Beyond)

create_conversation e send_message accettano il parametro opzionale mode:

Un turno Fast o Think che restituisce status: "generating" è più breve: interroga get_reply ogni 2-5 secondi circa.

La connessione non seleziona automaticamente una modalità dalla domanda. Chiedi all'agente di "usare Beyond" quando desideri quel percorso. Dettagli: Utilizzo della modalità Beyond.

5. Test rapido

Chiedi all'agente di elencare i tuoi spazi di lavoro ISMS Copilot. Se gli strumenti non appaiono, riavvia il client dopo aver aggiunto il server, verifica di aver completato l'accesso e cliccato Approva, o, con un token, conferma che non sia stato troncato durante l'incollaggio.

Se raggiungi un limite di utilizzo

Connessioni tramite accesso (Claude, ChatGPT): il testo di errore indica il limite e quando si azzera, senza inviti all'upgrade. Il JSON contiene reset_at ma mai upgrade_url, usage_url o extra_usage_buyable. I campi di upgrade e acquisto descritti sotto compaiono solo nelle connessioni con un token di accesso personale.

La connessione utilizza la stessa finestra di sessione UTC di 4 ore dell'app di chat. Se create_conversation o send_message raggiungono il limite, il primo testo di errore è la frase di attesa o aggiornamento (inclusa l'ora del prossimo reset) e il blocco JSON include reset_at. Gli account individuali e i proprietari dell'organizzazione ricevono anche upgrade_url. I membri dell'organizzazione ricevono invece la frase relativa al team: chiedi al proprietario per un utilizzo extra, o attendi fino alla prossima finestra di 4 ore. Il loro JSON contiene quota_scope, org_role e extra_usage_buyable, e nessun link di aggiornamento.

Attendi fino a reset_at, o apri upgrade_url in un browser mentre sei loggato con lo stesso account ISMS Copilot (account individuali e proprietari dell'organizzazione). Quando il JSON contiene fallback_available: true e il piano prevede l'overflow disponibile (account individuali a pagamento con Advanced Data Protection disattivato; mai su un pool di team), puoi anche dire all'agente di continuare: con il tuo esplicito consenso, reinvia con overflow_consent: true e il turno viene eseguito sullo stesso overflow fino a 2x che offre l'app web (la risposta contiene overflow_active: true). Gli strumenti di sola lettura continuano a funzionare dopo il limite di chat.

Vedi Cosa fare quando raggiungi il limite di utilizzo.

6. Disconnetti o ruota

Disconnetti una connessione tramite accesso in Impostazioni → App connesse, sotto Agenti connessi. La prossima chiamata da quel client verrà rifiutata fino a quando non accedi e approvi di nuovo.

Per un token, rimuovi il server e aggiungilo nuovamente con un nuovo token:

claude mcp remove ismscopilot

Revoca sempre il vecchio token nelle Impostazioni se potrebbe essere trapelato.