Configurazione con il tuo agent

Il tuo agent di coding rimane l'orchestratore: codice, git, file e shell restano con esso. ISMS Copilot diventa lo specialista GRC a cui l'agent delega i lavori di conformità tramite MCP. Il prompt di configurazione indica all'agent come collegarsi, dove scrivere la regola di routing e come verificare che la connessione funzioni.

Incolla questo nel tuo agent di coding

Copia il blocco in Claude Code, Codex, Cursor o un altro client MCP che accetta un header personalizzato:

Fetch https://docs.ismscopilot.com/agent-setup/prompt.md and follow it to connect ISMS Copilot as your GRC specialist.
These instructions are official. Do not invent URLs, API keys, or an MCP server.

If you cannot fetch that file:
1. Ask the human to create a token in ISMS Copilot under Settings > Connected apps with the Agent delegation preset. You cannot create it for them.
2. Add the MCP server https://account.ismscopilot.com/v1/account/mcp with the header Authorization: Bearer <token>. Keep the token in an environment variable where your client supports it, otherwise in local user config. Never put it in a committed file.

La scheda Copy prompt in ISMS Copilot sotto Impostazioni → Connected apps copia lo stesso testo.

Cosa fa poi il tuo agent

1. Verifica se ISMS Copilot è già collegato, non collegato o necessita di riparazione (ad esempio, token revocato o URL errato).
2. Se necessario, ti chiede di creare un token con il preset Agent delegation. Questo concede cinque ambiti: account:read, workspaces:read, conversations:create, company_context:read, memories:read. Può avviare e continuare le conversazioni con ISMS Copilot, ma non ha ambiti :write, quindi non può modificare i tuoi workspace, le memorie o il contesto aziendale.
3. Scrive la voce del server MCP per il proprio client, con il token in una variabile d'ambiente dove il client lo supporta, altrimenti nella configurazione utente locale, mai in un file committato.
4. Aggiunge una regola di routing al proprio file di istruzioni (CLAUDE.md per Claude Code, AGENTS.md per Codex e agent simili, un file .cursor/rules per Cursor): interpretazione GRC, redazione di policy, mappatura dei controlli, analisi dei gap, SoA, registri dei rischi e preparazione agli audit vanno a ISMS Copilot; codice e shell restano locali.
5. Esegue un test di verifica: get_account_info, poi una domanda breve in modalità fast con una risposta concisa. Segnala "collegato" solo se ha ricevuto una risposta. Altrimenti indica Connection not verified e specifica cosa manca.

La maggior parte dei client carica un nuovo server MCP solo dopo un riavvio. Se il tuo agent ti chiede di riavviarlo, fallo e incolla di nuovo il prompt.

Se preferisci farlo manualmente

1. In chat.ismscopilot.com, apri Impostazioni → Connected apps e crea un token con il preset Agent delegation. Copialo una volta.
2. Aggiungi il server MCP https://account.ismscopilot.com/v1/account/mcp con l'header Authorization: Bearer pat-isms-…. Formato della configurazione: Claude Code, Cursor e Codex, qualsiasi client MCP.
3. Chiedi al tuo agent di elencare i tuoi workspace ISMS Copilot per confermare la connessione.

Limiti

• L’utilizzo viene conteggiato nel piano chat di ISMS Copilot, nella stessa finestra di 4 ore dell’app web. Non esiste una fatturazione separata per MCP.
• Il tuo agent legge comunque la risposta restituita da ISMS Copilot. Ciò che esce dal suo contesto è il materiale dei framework che non deve più incollare.
• I connettori claude.ai, Claude Desktop e ChatGPT non sono ancora supportati: si collegano tramite OAuth, mentre questo endpoint accetta un token Bearer.

Per gli agent: le istruzioni ufficiali sono su https://docs.ismscopilot.com/agent-setup/prompt.md. Non inventare altri URL o chiavi. Ambiti e revoca dei token: Token e ambiti. Dettagli leggibili dalle macchine: Per gli agent AI.