Collega ISMS Copilot a Claude Code

Puoi utilizzare il tuo account ISMS Copilot direttamente da Claude Code, Cursor o qualsiasi strumento AI compatibile con MCP. Una volta connesso, il tuo strumento AI può elencare i tuoi workspace e documenti, leggere le tue memorie e condurre vere conversazioni ISMS Copilot, agendo come te e coperto dalla tua sottoscrizione esistente.

Di cosa hai bisogno

• Un account ISMS Copilot. La connessione è coperta dalla tua sottoscrizione, senza fatturazione separata.
• Un terminale con Claude Code (o un altro client MCP) installato.
• Alcune funzionalità dipendono dal tuo piano (vedi Scegliere come risponde).

Connetti in tre passaggi

Sei già connesso con un token di accesso personale? Rimuovi prima quel server, altrimenti Claude Code continua a usarlo: claude mcp remove ismscopilot.

1. Aggiungi il server (nessun token necessario):

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

2. In una sessione di Claude Code, esegui /mcp, seleziona ismscopilot e segui i passaggi nel browser. Da un terminale, claude mcp login ismscopilot fa la stessa cosa.
3. Accedi a ISMS Copilot e clicca Approva nella pagina di consenso.

Poi chiedi, ad esempio, "elenca i miei workspace ISMS Copilot."

claude.ai e Claude Desktop si collegano allo stesso URL del server con lo stesso accesso: vedi Collega qualsiasi client MCP. ChatGPT si collega allo stesso modo, come app MCP personalizzata: vedi la stessa pagina. Per Cursor e Codex, vedi Collega Cursor e Codex.

Fallback: connetti con un token di accesso personale

Usa un token quando l'accesso non è possibile, ad esempio in CI o su una macchina headless:

1. In ISMS Copilot, apri Impostazioni, poi App connesse.
2. Clicca Crea token. Assegnagli un nome (ad esempio, "Claude Code CI"), scegli i permessi che dovrebbe avere (vedi Permessi) e copia il token. Lo vedrai solo una volta.
3. Incolla il comando mostrato nel tuo terminale. Assomiglia a questo:

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

Cosa può fare il tuo strumento AI

Una connessione può leggere e fare quanto segue, e nient'altro. Una connessione tramite accesso ottiene ogni riga sotto; un token ottiene le righe coperte dai suoi permessi:

Quindi, dal tuo strumento AI puoi elencare i tuoi workspace e documenti, creare un workspace personale, aggiungere o modificare una memoria e condurre una conversazione ISMS Copilot basata sui dati, il tutto senza lasciare il tuo editor.

Scegliere come risponde (Fast, Think e Beyond)

Quando avvii o continui una conversazione dal tuo strumento AI, scegli la modalità. La connessione non la seleziona dalla domanda. Se l'agente omette mode, ISMS Copilot utilizza Fast.

• Fast (predefinito): risposte rapide, senza ragionamento esteso.
• Think: ragionamento più approfondito per domande più difficili. Solo piani a pagamento. Su un piano gratuito, una richiesta Think ricade su Fast.
• Beyond: piano multi-step, bozza e verifica. Solo piani a pagamento, 10 esecuzioni per giorno UTC (50 su Unlimited). Scala di minuti. L'agente deve passare mode: "beyond" su create_conversation o send_message, poi eseguire il polling di get_reply circa ogni 10-20 secondi fino al completamento dell'esecuzione. Se Beyond non può essere eseguito, il turno risponde tramite il flusso normale e include beyond_denied_reason.

In pratica:

• “Pensa attentamente a questo” è sufficiente per Think.
• “Usa Beyond” o “esegui questo in Beyond” è sufficiente per Beyond. L'agente non aggiornerà una domanda difficile da solo.

Un turno Fast o Think che non è pronto inline restituisce status: "generating". L'agente poi esegue il polling di get_reply circa ogni 2-5 secondi fino a quando restituisce complete.

Vedi Utilizzo della modalità Beyond.

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 del team: chiedi al proprietario per un utilizzo extra, o attendi fino alla prossima finestra di 4 ore. Il loro JSON include quota_scope, org_role e extra_usage_buyable, e nessun link di aggiornamento.

Puoi:

1. Attendere fino a reset_at.
2. Aprire upgrade_url in un browser mentre sei loggato con lo stesso account ISMS Copilot (account individuali e proprietari dell'organizzazione).
3. Quando il JSON include fallback_available: true e il tuo piano ha il sovraccarico disponibile (account individuali a pagamento con Advanced Data Protection disattivato; mai su un pool di team), chiedi all'agente di continuare: con il tuo esplicito consenso, reinvia con overflow_consent: true e il turno viene eseguito sullo stesso sovraccarico fino a 2x che offre l'app web (la risposta include overflow_active: true).
4. Continuare a utilizzare gli strumenti di lettura. Workspace, memorie, documenti e informazioni account funzionano ancora dopo il limite di chat.

Vedi Cosa fare quando raggiungi il limite di utilizzo.

Le impostazioni rimangono nell'app web

Le impostazioni protette dell'account sono in sola lettura dalla connessione (il contesto aziendale, sopra, è l'unico profilo che un token con company_context:write può sostituire). In particolare, Advanced Data Protection (che instrada i tuoi dati attraverso un provider con sede nell'UE e a ritenzione zero) non può essere attivata o disattivata dal tuo strumento AI.

Se chiedi al tuo strumento AI informazioni sulla Data Protection, può segnalare se è abilitata per il tuo account e ti indirizzerà a Impostazioni, Data Protection su chat.ismscopilot.com per modificarla. Questo è intenzionale: un token di connessione non dovrebbe essere in grado di modificare un'impostazione globale di residenza dei dati.

Permessi

Quando accedi e clicchi Approva, lo strumento ottiene un set fisso: leggere il tuo account, workspace, documenti (metadati), memorie e profilo aziendale; chiedere a ISMS Copilot e leggere le risposte; aggiornare il tuo profilo aziendale e le memorie, e creare workspace. Non può creare chiavi API o acquistare crediti. Le modifiche apportate sono etichettate in ISMS Copilot con il nome dello strumento, come Added by OAuth app: <name> o Updated by OAuth app: <name>.

Quando crei un token, scegli esattamente cosa può fare (leggere workspace, leggere documenti, leggere e scrivere memorie, avviare conversazioni, e così via). Concedi solo ciò di cui hai bisogno. Un token che legge solo i tuoi workspace non può modificare le tue memorie o avviare conversazioni.

Puoi vedere e disconnettere ogni connessione in qualsiasi momento in Impostazioni, App connesse: i token nell'elenco dei token, le connessioni tramite accesso sotto Agent connessi.

Riconnettere o ruotare un token

Se una connessione tramite accesso smette di funzionare (ad esempio dopo averla disconnessa), esegui /mcp, seleziona ismscopilot e accedi di nuovo.

Se ti sei connesso con un token e vuoi passare a uno nuovo, rimuovi prima il server esistente. Altrimenti Claude Code mantiene il vecchio token:

claude mcp remove ismscopilot

Poi aggiungi di nuovo il server, con accesso o con il nuovo token.

Sicurezza

• Una connessione agisce come te, quindi può accedere esattamente a ciò a cui il tuo account può già accedere, limitato da ciò che hai approvato o dai permessi che hai concesso.
• È coperta dalla tua sottoscrizione, senza fatturazione separata.
• Puoi disconnetterla in qualsiasi momento in Impostazioni, App connesse. La disconnessione ha effetto immediato.
• Tratta un token come una password. Se uno viene esposto, revocalo e creane uno nuovo.

Risoluzione dei problemi

• Connesso ma gli strumenti non compaiono: esegui di nuovo il comando di connessione con --scope user, o esegui claude mcp remove ismscopilot e aggiungilo di nuovo.
• Autenticazione fallita o "necessita autenticazione": una connessione tramite accesso è stata disconnessa o scaduta: esegui /mcp e accedi di nuovo. Un token potrebbe essere stato revocato o scaduto: creane uno nuovo in Impostazioni, App connesse.
• La modalità Think non sembra più approfondita: Think richiede un piano a pagamento. Su un piano gratuito ricade su Fast.
• Beyond è stato eseguito come una risposta normale: è probabile che l'agente abbia omesso mode. Chiedigli di inviare mode: "beyond", o di' “usa Beyond” nel prossimo turno. Controlla beyond_denied_reason se una richiesta Beyond è stata declassata.