Collega ISMS Copilot a Claude Code

Claude svolge il lavoro. ISMS Copilot è l'esperto di conformità che consulta e verifica il lavoro. Tu decidi e firmi.

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 con 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 continuerà a utilizzarlo: claude mcp remove ismscopilot.

1. Aggiungi il server (non è necessario un token):

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 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

Utilizza 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 con ISMS Copilot basata sui dati, il tutto senza lasciare il tuo editor.

Scegliere come risponde (Fast, Think e Beyond)

Il server non sceglie una modalità. Il tuo orchestratore utilizza Fast per impostazione predefinita, Think per verifiche e analisi multi-step, e Beyond su richiesta, per una verifica finale subito prima di un audit, o per la stesura di documenti di ricerca approfonditi. Se l'orchestratore omette mode, ISMS Copilot utilizza Fast.

• Fast (predefinito): risposte rapide, senza ragionamento esteso.
• Think: ragionamento più approfondito per verifiche e analisi multi-step. 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'orchestratore deve passare mode: "beyond" su create_conversation o send_message, poi interrogare 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. Senza questo, l'orchestratore potrebbe comunque scegliere Beyond per una verifica finale subito prima di un audit, o per la stesura di documenti di ricerca approfonditi.

Un turno Fast o Think che non è pronto inline restituisce status: "generating". L'orchestratore poi interroga 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 dell'errore indica il limite e quando si resetta, senza invito all'aggiornamento. Il JSON contiene reset_at ma mai upgrade_url, usage_url o extra_usage_buyable. I campi di aggiornamento e acquisto descritti di seguito appaiono solo sulle connessioni con token di accesso personale.

La connessione utilizza lo stesso limite di utilizzo dell'app di chat: il contingente del tuo piano, con l'orario di reset mostrato nell'app. 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 singoli e i proprietari dell'organizzazione ricevono anche upgrade_url. I membri dell'organizzazione ricevono invece la frase per il team: chiedi al proprietario per ulteriore utilizzo, 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.

Puoi:

1. Attendere fino a reset_at.
2. Aprire upgrade_url in un browser mentre sei loggato con lo stesso account ISMS Copilot (account singoli e proprietari dell'organizzazione).
3. Quando il JSON contiene fallback_available: true e l'overflow del tuo piano è disponibile (account singoli a pagamento con Advanced Data Protection disattivato; mai su un pool di team), chiedi all'orchestratore 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).
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 di sola lettura dalla connessione (le aziende, sopra, sono l'eccezione: una connessione tramite accesso, o un token con company_context:write, può crearle, modificarle ed eliminarle e collegarle ai workspace o scollegarle, fino al limite aziende del tuo piano). In particolare, Advanced Data Protection (che instrada i tuoi dati attraverso un provider con sede nell'UE e a conservazione zero) non può essere attivata o disattivata dal tuo strumento AI.

Se chiedi al tuo strumento AI riguardo la 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 aziende; chiedere a ISMS Copilot, leggere le risposte e contrassegnare una risposta bloccata come fallita; creare, modificare ed eliminare aziende e collegarle ai workspace o scollegarle, modificare 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, ecc.). 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: riesegui il comando di connessione con --scope user, o esegui claude mcp remove ismscopilot e aggiungilo di nuovo.
• Autenticazione fallita o "necessita di 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'orchestratore 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.