ISMS Copilot Docs

Opzetten met je agent

Plak één prompt in Claude Code, Codex, Cursor of een andere MCP-client. Je agent verbindt ISMS Copilot als GRC-specialist, voert een rooktest uit en schrijft een routeringsregel. Je meldt je aan en keurt goed.

Je coderingsagent blijft de orchestrator: code, git, bestanden en shell blijven bij hem. ISMS Copilot wordt de GRC-specialist waaraan hij compliancewerk overdraagt via MCP. De setup-prompt vertelt de agent hoe hij moet verbinden, waar hij de routeringsregel moet schrijven en hoe hij kan bewijzen dat de verbinding werkt.

Je meldt je aan bij ISMS Copilot en klikt zelf op Goedkeuren. Je agent kan dat niet voor je doen.

Plak dit in je coderingsagent

Kopieer het blok naar Claude Code, Codex, Cursor of een andere MCP-client:

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. Claude Code: add the HTTP MCP server https://account.ismscopilot.com/v1/account/mcp with no header and no token, then ask the human to run /mcp, pick ismscopilot, sign in to ISMS Copilot and click Approve. You cannot approve it for them.
2. Cursor, Codex and other clients: 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. Add the same server 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.

De Prompt kopiëren-kaart in ISMS Copilot onder Instellingen → Verbonden apps kopieert dezelfde tekst.

Wat je agent vervolgens doet

  1. Controleert of ISMS Copilot al is verbonden, niet verbonden is of herstel nodig heeft (bijvoorbeeld een verbroken aanmelding, een ingetrokken token of een verkeerde URL).
  2. Voegt in Claude Code de server https://account.ismscopilot.com/v1/account/mcp toe zonder header en zonder token, en vraagt je vervolgens om /mcp uit te voeren, ismscopilot te selecteren, je aan te melden bij ISMS Copilot en op Goedkeuren te klikken op de toestemmingspagina.
  3. Stelt in Cursor, Codex en andere clients in plaats daarvan een persoonlijke toegangstoken in: het vraagt je om er een aan te maken met het Agent delegation-voorinstelling onder Instellingen → Verbonden apps (scopes account:read, workspaces:read, conversations:create, company_context:read, memories:read, geen :write scope) en bewaart deze in een omgevingsvariabele of lokale gebruikersconfiguratie, nooit in een gecommitteerd bestand.
  4. Voert een rooktest uit: get_account_info, daarna één korte vraag in fast modus met een beknopt antwoord. Het meldt alleen dat er verbinding is als er een antwoord terugkomt. Anders zegt het Verbinding niet geverifieerd en benoemt wat nog ontbreekt.
  5. Stelt een routeringsregel voor voor het instructiebestand (CLAUDE.md voor Claude Code, AGENTS.md voor Codex en vergelijkbare agents, een .cursor/rules-bestand voor Cursor) en schrijft deze bij je bevestiging: GRC-interpretatie, beleidsopstelling, control mapping, gap-analyse, SoA, risicoregisters en auditvoorbereiding gaan naar ISMS Copilot; code en shell blijven lokaal.
  6. Optioneel stelt het, eenmaal verbonden, een eerste taak voor op bestanden die je al hebt (de feiten in het conceptrapport van een auditor controleren, DPA-bewijs van je leveranciers verzamelen of twee registers vergelijken die zouden moeten overeenkomen) en biedt het één terugkerende routine aan volgens je eigen schema: de wekelijkse audit-readiness-check, met een GRC.md. Het stelt niets in tenzij je ja zegt.

De meeste clients laden een nieuwe MCP-server pas na een herstart. Als je agent vraagt om opnieuw op te starten, doe dat dan en plak de prompt opnieuw.

Wat je goedkeurt

Wanneer je je aanmeldt en op Goedkeuren klikt, kan de AI-tool:

  • je account, werkruimten, documenten (metadata), herinneringen en bedrijfsprofiel lezen
  • vragen stellen aan ISMS Copilot en de antwoorden lezen
  • je bedrijfsprofiel en herinneringen bijwerken, en werkruimten aanmaken

Het kan geen API-sleutels aanmaken of credits kopen. Wijzigingen die het aanbrengt, worden in ISMS Copilot gelabeld met de naam die de tool heeft geregistreerd, als Added by OAuth app: <name> of Updated by OAuth app: <name>. Koppel het op elk moment los in Instellingen → Verbonden apps, onder Verbonden agents. Details: Tokens en scopes.

Als je het liever handmatig doet

  1. Claude Code: voeg de MCP-server https://account.ismscopilot.com/v1/account/mcp toe zonder header, meld je vervolgens aan en klik op Goedkeuren (Verbind Claude Code). claude.ai en Claude Desktop: Verbind elke MCP-client.
  2. Cursor, Codex en andere clients: maak een token aan met de Agent delegation-voorinstelling en voeg deze toe aan de clientconfiguratie (Cursor en Codex, elke MCP-client).
  3. Vraag je agent om je ISMS Copilot-werkruimten op te sommen om de verbinding te bevestigen.

Beperkingen

  • Het gebruik telt mee voor je ISMS Copilot-chatplan, binnen hetzelfde 4-uursvenster als de webapp. Er is geen aparte MCP-facturering.
  • Je agent leest nog steeds het antwoord dat ISMS Copilot retourneert. Wat buiten zijn context blijft, is het frameworkmateriaal dat hij niet meer hoeft in te plakken.
  • Een tool die via aanmelding is verbonden, kan geen model API-sleutels of credits beheren. Daarvoor is een persoonlijke toegangstoken met die scopes nodig.

Voor agents: de officiële instructies staan op https://docs.ismscopilot.com/agent-setup/prompt.md. Verzin nooit andere URL's of sleutels. Scopes en intrekking: Tokens en scopes. Machineleesbare details: Voor AI-agents.

Op deze pagina