Werken met ISMS Copilot vanuit je agent

Wat naar ISMS Copilot gaat, wat bij je agent blijft

Een nuttige test: als het antwoord afhangt van wat een standaard of regelgeving precies zegt, of van je werkruimtecontext, raadpleeg dan ISMS Copilot. Als het afhangt van feiten in je repository, houd die opzoeking dan lokaal en stuur ISMS Copilot een korte samenvatting van de relevante feiten in plaats van de bestanden zelf. Stuur voor een controle de tekst van het document zelf, met geheimen verwijderd. Als je model het antwoord al weet, geen opzoeking nodig heeft en het direct naar een bestand schrijft, houd het dan ook lokaal: ISMS Copilot aanroepen voegt beurten toe en kost meer Claude-gebruik voor kleine taken zoals deze. Compliancewerk dat je op het punt staat af te ronden, laat je nog steeds controleren. Zie waar ISMS Copilot aanroepen niet helpt.

Routeringsregels, per orchestrator

Elke regel hieronder heeft dezelfde inhoud; alleen het bestand verschilt. Plak het in het bestand dat je orchestrator leest. De regels gaan ervan uit dat de server is geregistreerd onder de naam ismscopilot, zoals in de installatiegidsen.

Claude Code

Voeg toe aan CLAUDE.md in de projectroot, of aan ~/.claude/CLAUDE.md voor elk project:

## GRC work goes to ISMS Copilot

For ISO 27001/27701/42001, SOC 2, GDPR, NIS 2, DORA, EU AI Act, Cyber Resilience Act (CRA),
NIST SP 800-171/CMMC, HIPAA or PCI DSS questions, policy drafting, control mapping,
gap analysis, SoA justifications, risk registers and audit prep, use the ismscopilot
MCP server instead of answering from memory: when you need to know what a framework
requires, while you do the work when it needs compliance judgement, and before you finalize it.
You read the files and write the deliverable; ISMS Copilot judges. Keep code, git and shell work local.

- Do not paste framework text. To check work, send the document as message text, with secrets removed, and say in the deliverable which parts were not checked.
- One conversation per deliverable: create_conversation once, then send_message on the same conversation_id for every follow-up.
- Call set_company_context only when I ask to update my company profile.
- Pass workspace_id when the work is for a specific client or company.
- Default mode fast; think for checks and multi-step analysis; beyond on request, for a final check right before an audit, or for long research-grade drafting.
- Pass answer_format "brief" or "decision" unless I ask for the full text.
- If a call returns status "generating", poll get_reply until "complete".
- Write long deliverables to a file and give me the path, not the whole text in chat.
- Verify any citation an audit will depend on against the official source text when you can. Also verify anything ISMS Copilot marks as unconfirmed or says it cannot confirm before relying on it (fetch the official publication if you have web access). Do not routinely re-check other confirmed answers.
- Record which items you verified or could not verify in the deliverable itself, as a short "Verified" note. Say it in chat too, unless I ask for a bare reply such as a file path.

Installatie: Verbind ISMS Copilot met Claude Code.

Codex, OpenCode en Grok

Deze orchestratoren lezen AGENTS.md. Plaats dezelfde regel in AGENTS.md in de projectroot, of in het globale instructiebestand van de orchestrator (bijvoorbeeld ~/.codex/AGENTS.md voor Codex). Raadpleeg de documentatie van je orchestratorversie voor het exacte globale pad.

## GRC work goes to ISMS Copilot

For ISO 27001/27701/42001, SOC 2, GDPR, NIS 2, DORA, EU AI Act, Cyber Resilience Act (CRA),
NIST SP 800-171/CMMC, HIPAA or PCI DSS questions, policy drafting, control mapping,
gap analysis, SoA justifications, risk registers and audit prep, use the ismscopilot
MCP server instead of answering from memory: when you need to know what a framework
requires, while you do the work when it needs compliance judgement, and before you finalize it.
You read the files and write the deliverable; ISMS Copilot judges. Keep code, git and shell work local.

- Do not paste framework text. To check work, send the document as message text, with secrets removed, and say in the deliverable which parts were not checked.
- One conversation per deliverable: create_conversation once, then send_message on the same conversation_id for every follow-up.
- Call set_company_context only when I ask to update my company profile.
- Pass workspace_id when the work is for a specific client or company.
- Default mode fast; think for checks and multi-step analysis; beyond on request, for a final check right before an audit, or for long research-grade drafting.
- Pass answer_format "brief" or "decision" unless I ask for the full text.
- If a call returns status "generating", poll get_reply until "complete".
- Write long deliverables to a file and give me the path, not the whole text in chat.
- Verify any citation an audit will depend on against the official source text when you can. Also verify anything ISMS Copilot marks as unconfirmed or says it cannot confirm before relying on it (fetch the official publication if you have web access). Do not routinely re-check other confirmed answers.
- Record which items you verified or could not verify in the deliverable itself, as a short "Verified" note. Say it in chat too, unless I ask for a bare reply such as a file path.

Installatie: Verbind Cursor en Codex, of Verbind elke MCP-client voor OpenCode en Grok.

Cursor

Maak een projectregel aan op .cursor/rules/ismscopilot.mdc:

---
description: GRC work goes to the ISMS Copilot MCP server
alwaysApply: true
---

For ISO 27001/27701/42001, SOC 2, GDPR, NIS 2, DORA, EU AI Act, Cyber Resilience Act (CRA),
NIST SP 800-171/CMMC, HIPAA or PCI DSS questions, policy drafting, control mapping,
gap analysis, SoA justifications, risk registers and audit prep, use the ismscopilot
MCP server instead of answering from memory: when you need to know what a framework
requires, while you do the work when it needs compliance judgement, and before you finalize it.
You read the files and write the deliverable; ISMS Copilot judges. Keep code, git and shell work local.

- Do not paste framework text. To check work, send the document as message text, with secrets removed, and say in the deliverable which parts were not checked.
- One conversation per deliverable: create_conversation once, then send_message on the same conversation_id for every follow-up.
- Call set_company_context only when I ask to update my company profile.
- Pass workspace_id when the work is for a specific client or company.
- Default mode fast; think for checks and multi-step analysis; beyond on request, for a final check right before an audit, or for long research-grade drafting.
- Pass answer_format "brief" or "decision" unless I ask for the full text.
- If a call returns status "generating", poll get_reply until "complete".
- Write long deliverables to a file and give me the path, not the whole text in chat.
- Verify any citation an audit will depend on against the official source text when you can. Also verify anything ISMS Copilot marks as unconfirmed or says it cannot confirm before relying on it (fetch the official publication if you have web access). Do not routinely re-check other confirmed answers.
- Record which items you verified or could not verify in the deliverable itself, as a short "Verified" note. Say it in chat too, unless I ask for a bare reply such as a file path.

Installatie: Verbind Cursor en Codex.

claude.ai, Claude Desktop en ChatGPT

Voeg ISMS Copilot toe als aangepaste connector (in ChatGPT een aangepaste MCP-app met OAuth en standaardinstellingen) met de eindpunt-URL, meld je vervolgens aan en klik op Goedkeuren. Deze apps hebben geen instructiebestand voor de bovenstaande routeringsregel; plaats deze in het project of in aangepaste instructies als de app deze heeft. Installatie: Verbind elke MCP-client.

Patronen die werken

Eén gesprek per deliverable

Begin elke deliverable (een toegangsbeheerbeleid, een gap-analyse, een reeks SoA-rechtvaardigingen) met create_conversation, verfijn deze vervolgens met send_message op dezelfde conversation_id. De specialist houdt de geschiedenis van de thread aan zijn kant bij, dus je agent hoeft eerdere beurten niet opnieuw te verzenden. Begin een nieuw gesprek voor een niet-gerelateerde deliverable: lange threads gebruiken meer van je gebruiksvenster per bericht.

Werk voor klant en bedrijf beperken tot een werkruimte

Geef workspace_id door (van list_workspaces) wanneer het werk bij een specifieke klant of bedrijf hoort. Bij een beurt met werkruimtebereik leest ISMS Copilot de herinneringen en bestanden van die werkruimte, zodat je agent deze niet opnieuw hoeft te vermelden. Zonder workspace_id wordt de beurt alleen uitgevoerd op je persoonlijke herinneringen.

Een ingebouwde assistent kiezen

Met een persoonlijk toegangstoken kan je agent een vraag doorsturen naar een ingebouwde assistent die zich op één framework richt: Cyber Resilience Act (cra), DORA (dora), EU AI Act (eu-ai-act), NIS 2 (nis2), Privacybeheer (iso27701, dekt ISO/IEC 27701) en AI-beheer (iso42001, dekt ISO/IEC 42001). Laat hem één keer list_assistants aanroepen en daarna assistant met de bijbehorende id doorgeven aan create_conversation. De keuze blijft aan het gesprek gekoppeld, dus vervolgvragen hebben geen assistant nodig. Laat het voor al het andere weg: de algemene specialist beantwoordt elk ander framework zoals voorheen. Het veld assistant van elk antwoord vermeldt welke assistent heeft geantwoord. Aanmeldverbindingen hebben dit nog niet. Details: Elke MCP-client verbinden.

Kiezen op taak

Ingebouwde assistenten bestaan ook per taak. Met een persoonlijk toegangstoken geeft list_assistants ze terug als by_job, naast de framework-experts in built_in. De taken zijn Questionnaire responder, Audit prep, Implementation lead en Incident lead; list_assistants toont de rollen die voor je account zijn ingeschakeld. Er volgen meer rollen. Kies een taak wanneer je agent iets gedaan moet krijgen, zoals een beveiligingsvragenlijst beantwoorden of een audit voorbereiden. Kies een framework-expert wanneer de vraag gaat over wat één framework vereist. Twijfel je, laat assistant dan weg. Noem het framework in het bericht en de rol werkt daarmee. Elk antwoord van een rol noemt het framework waarop het zich richtte. Aanmeldverbindingen hebben dit nog niet.

Herinneringen voor duurzame feiten

Feiten die voor elke toekomstige beurt moeten gelden (de certificeringsscope, de gekozen risicomethodologie, de auditdatum) horen in een herinnering: create_memory, met workspace_id voor een werkruimteherinnering of zonder voor een persoonlijke. Herinneringen zijn beperkt tot 500 tekens elk. Gebruik list_memories om te controleren wat er al staat voordat je een duplicaat toevoegt.

Bedrijfscontext

set_company_context vervangt het bedrijfsprofiel van het account (naam, sector, grootte, land, privacyrol, gegevenstypen, hostingregio, technologiestack, notities), en get_company_context leest het uit. Met een workspace_id werken beide in plaats daarvan op het bedrijf dat aan die werkruimte is gekoppeld (bedrijven en koppelingen: zie Tokens, scopes en beveiliging). Gesprekken die je agent via MCP of de account-API voert, krijgen een profiel onder dezelfde voorwaarden als de webchat, als achtergrond bij elke beurt van een gesprek dat je eigen account is gestart, en antwoorden kunnen feiten daaruit gebruiken: buiten een werkruimte het accountprofiel; in een persoonlijke werkruimte alleen het daaraan gekoppelde bedrijf, en geen profiel als er geen is gekoppeld. Alleen de profielen van je eigen account worden gebruikt, en ze worden nooit gedeeld met een ander account. Het accountprofiel wordt niet toegevoegd in werkruimten of in tijdelijke chats, en er wordt geen profiel toegevoegd als het niet kan worden gelezen (de beurt loopt dan zonder). Feiten die alleen relevant zijn voor één vraag, kunnen nog steeds in het bericht zelf of in een werkruimtegeheugen worden geplaatst.

Fast, Think of Beyond

Een beyond-verzoek dat niet kan worden uitgevoerd, wordt beantwoord via de normale flow, en het resultaat vermeldt de reden in beyond_denied_reason: plan, adp, disabled, trivial, cap of cap_anthropic. Een beurt die op het overlooppad van de over-cap draait, antwoordt ook via de normale flow in plaats van Beyond. Zie Beyond-modus gebruiken.

Vraag om een antwoord dat geschikt is voor een agent

create_conversation en send_message accepteren een optionele answer_format:

Een expliciet aangevraagd volledig document wordt nooit ingekort. Beyond-runs negeren answer_format en vermelden dit met answer_format_applied: false.

Polling-frequentie

Wanneer een oproep status: "generating" retourneert, roep je get_reply aan met de conversation_id en message_id totdat deze complete retourneert:

• Fast- en Think-beurten: elke 2-5 seconden.
• Beyond-runs: elke 10-20 seconden. Je kunt ook de beyond_run_id doorgeven die het ticket heeft geretourneerd.

Wacht op een antwoord voordat je het volgende bericht in hetzelfde gesprek verzendt: een verzending terwijl de vorige beurt nog wordt gegenereerd, wordt afgewezen.

Schrijf lange deliverables naar bestanden

Wanneer de specialist een beleid of een volledige SoA retourneert, laat je jouw orchestrator deze rechtstreeks naar een bestand schrijven en rapporteer je het pad. Een lang document herhalen in de chat plaatst het tweemaal in de context van jouw orchestrator. Zie Wat het aanroepen van ISMS Copilot bespaart.

MCP of de Model API?

ISMS Copilot biedt twee manieren om vanuit een coderingsagent binnen te komen. Ze zijn geschikt voor verschillende taken.

Voor het Model API-patroon, zie Gebruik de API in coderingsagents.