ISMS Copilot Docs

Mit ISMS Copilot aus deinem Agenten arbeiten

Wann dein Agent ISMS Copilot konsultiert und die Arbeit prüfen lässt, was in deinem Agenten bleibt, einsatzbereite Weiterleitungsregeln für Claude Code, Codex, OpenCode, Grok und Cursor sowie die Muster, die jeden Aufruf klein halten.

Ihr Coding-Agent erledigt die Arbeit: Er verwaltet Ihr Repository, Ihre Shell und Ihre Dateien. ISMS Copilot ist der Compliance-Experte, den er über den Account MCP konsultiert und von dem er diese Arbeit prüfen lässt. Sie entscheiden und unterzeichnen. Diese Seite behandelt, wann Ihr Agent ISMS Copilot aufruft (zum Konsultieren, während der Arbeit und zum Prüfen vor dem Abschluss), wie Sie ihn dazu anweisen und wie Sie jeden Aufruf klein halten.

Wenn Ihr Agent eine Verbindung herstellt, sendet der Server bereits eine kurze Routing-Notiz (das MCP-instructions-Feld), die angibt, was an ISMS Copilot geht, was bei Ihrem Agenten bleibt und wann Arbeit geprüft werden soll. Agenten folgen dieser Notiz nicht immer, daher macht eine Routing-Regel in Ihrem Projekt oder in den Benutzeranweisungen das Verhalten zuverlässig.

Was an ISMS Copilot geht, was bei Ihrem Agenten bleibt

ISMS Copilot konsultierenIm Agenten behalten
Exakte Anforderungen und Kennungen: DORA RTS-Artikel, die NIS2-Durchführungsverordnung, ISO 42001-Kontrollen, CMMC-PraktikenKleine, bekannte Änderungen und schnelle Entwürfe, die Ihr Modell bereits handhabt
Framework-Interpretation: ISO 27001, ISO 27701, ISO 42001, SOC 2, DSGVO, NIS 2, DORA, EU AI Act, Cyber Resilience Act (CRA), NIST SP 800-171/CMMC, HIPAA, PCI DSSCode, Tests, Refactorings, Git und Pull Requests
Entwürfe, die Framework-Grundlagen oder Ihre Arbeitsbereichserinnerungen, Dateien und Unternehmenskontext benötigen: Richtlinien, Verfahren, SoA-Begründungen, Risikoregister-EinträgeLesen und Bearbeiten von Dateien, Shell-Befehle
Kontrollzuordnung und Gap-AnalyseAllgemeine Fragen, die nichts mit Compliance zu tun haben
Prüfungsvorbereitung und BeweislisteEntscheidung, was im Code-Repository geändert werden soll, und Schreiben des endgültigen Ergebnisses auf die Festplatte

Ein nützlicher Test: Wenn die Antwort genau davon abhängt, was ein Standard oder eine Verordnung besagt, oder vom Kontext Ihres Arbeitsbereichs, konsultieren Sie ISMS Copilot. Wenn sie von Fakten in Ihrem Repository abhängt, behalten Sie dieses Nachschlagen lokal und senden Sie ISMS Copilot eine kurze Zusammenfassung der relevanten Fakten, anstatt die Dateien selbst. Für eine Prüfung senden Sie den Dokumenttext selbst, ohne Geheimnisse. Wenn Ihr Modell die Antwort bereits kennt, keine Nachschlage benötigt und sie direkt in eine Datei schreibt, behalten Sie es ebenfalls lokal: Der Aufruf von ISMS Copilot fügt Schritte hinzu und verursacht höhere Claude-Nutzungskosten bei kleinen Aufgaben wie dieser. Compliance-Arbeit, die Sie gerade finalisieren, wird trotzdem geprüft. Siehe wo der Aufruf von ISMS Copilot nicht hilft.

Routing-Regeln, pro Orchestrator

Jede der folgenden Regeln hat denselben Inhalt; nur die Datei unterscheidet sich. Fügen Sie sie in die Datei ein, die Ihr Orchestrator liest. Die Regeln gehen davon aus, dass der Server unter dem Namen ismscopilot registriert ist, wie in den Setup-Anleitungen beschrieben.

Claude Code

Fügen Sie dies zu CLAUDE.md im Projektstamm oder zu ~/.claude/CLAUDE.md für jedes Projekt hinzu:

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

Setup: ISMS Copilot mit Claude Code verbinden.

Codex, OpenCode und Grok

Diese Orchestratoren lesen AGENTS.md. Fügen Sie dieselbe Regel in AGENTS.md im Projektstamm oder in der globalen Anweisungsdatei des Orchestrators ein (z. B. ~/.codex/AGENTS.md für Codex). Überprüfen Sie die Dokumentation Ihrer Orchestrator-Version auf den genauen globalen Pfad.

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

Setup: Cursor und Codex verbinden oder Jeden MCP-Client verbinden für OpenCode und Grok.

Cursor

Erstellen Sie eine Projektregel unter .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.

Setup: Cursor und Codex verbinden.

claude.ai, Claude Desktop und ChatGPT

Fügen Sie ISMS Copilot als benutzerdefinierten Connector (in ChatGPT eine benutzerdefinierte MCP-App mit OAuth und Standardeinstellungen) mit der Endpunkt-URL hinzu, melden Sie sich an und klicken Sie auf Genehmigen. Diese Apps haben keine Anweisungsdatei für die oben genannte Routing-Regel; fügen Sie sie in die Projekt- oder benutzerdefinierten Anweisungen ein, falls die App diese unterstützt. Setup: Jeden MCP-Client verbinden.

Erfolgreiche Muster

Eine Unterhaltung pro Ergebnis

Beginnen Sie jedes Ergebnis (eine Zugriffskontrollrichtlinie, eine Gap-Analyse, eine Reihe von SoA-Begründungen) mit create_conversation, und verfeinern Sie es anschließend mit send_message unter derselben conversation_id. Der Spezialist behält den Verlauf des Threads auf seiner Seite, sodass Ihr Agent frühere Schritte nicht erneut senden muss. Beginnen Sie eine neue Unterhaltung für ein nicht verwandtes Ergebnis: Lange Threads verbrauchen mehr von Ihrem Nutzungsfenster pro Nachricht.

Client- und Unternehmensarbeit auf einen Arbeitsbereich beschränken

Übergeben Sie workspace_id (von list_workspaces), wenn die Arbeit einem bestimmten Kunden oder Unternehmen gehört. Bei einem arbeitsbereichsbezogenen Schritt liest ISMS Copilot die Erinnerungen und Dateien dieses Arbeitsbereichs, sodass Ihr Agent diese nicht erneut angeben muss. Ohne workspace_id läuft der Schritt nur mit Ihren persönlichen Erinnerungen.

Einen integrierten Assistenten wählen

Mit einem persönlichen Zugriffstoken kann Ihr Agent eine Frage an einen integrierten Assistenten weiterleiten, der sich auf ein Framework konzentriert: Cyber Resilience Act (cra), DORA (dora), EU AI Act (eu-ai-act), NIS 2 (nis2), Datenschutzmanagement (iso27701, deckt ISO/IEC 27701 ab) und KI-Management (iso42001, deckt ISO/IEC 42001 ab). Lassen Sie ihn einmal list_assistants aufrufen und dann assistant mit der passenden ID an create_conversation übergeben. Die Auswahl bleibt an der Unterhaltung haften, sodass Folgefragen kein assistant benötigen. Für alles andere lassen Sie es weg: Der allgemeine Spezialist beantwortet wie bisher jedes andere Framework. Das Feld assistant jeder Antwort gibt an, welcher Assistent geantwortet hat. Anmelde-Verbindungen haben das noch nicht. Details: Beliebigen MCP-Client verbinden.

Nach Aufgabe wählen

Integrierte Assistenten gibt es auch nach Aufgabe. Mit einem persönlichen Zugriffstoken gibt list_assistants sie als by_job zurück, neben den Framework-Experten in built_in. Die Aufgaben sind Questionnaire responder, Audit prep, Implementation lead und Incident lead; list_assistants zeigt die für Ihr Konto aktivierten. Weitere Rollen folgen. Wählen Sie eine Aufgabe, wenn Ihr Agent etwas erledigen soll, etwa einen Sicherheitsfragebogen beantworten oder sich auf ein Audit vorbereiten. Wählen Sie einen Framework-Experten, wenn es darum geht, was ein bestimmtes Framework verlangt. Im Zweifel lassen Sie assistant weg. Nennen Sie das Framework in der Nachricht, und die Rolle arbeitet danach. Jede Antwort einer Rolle nennt das Framework, an dem sie sich ausgerichtet hat. Anmelde-Verbindungen haben das noch nicht.

Erinnerungen für dauerhafte Fakten

Fakten, die für jeden zukünftigen Schritt gelten sollen (der Zertifizierungsumfang, die gewählte Risikomethodik, das Prüfungsdatum), gehören in eine Erinnerung: create_memory, mit workspace_id für eine Arbeitsbereichserinnerung oder ohne für eine persönliche. Erinnerungen sind auf 500 Zeichen begrenzt. Verwenden Sie list_memories, um zu prüfen, was bereits vorhanden ist, bevor Sie eine Duplizierung hinzufügen.

Unternehmenskontext

set_company_context ersetzt das Unternehmensprofil des Accounts (Name, Branche, Größe, Land, Datenschutzrolle, Datentypen, Hosting-Region, Tech-Stack, Notizen), und get_company_context liest es aus. Mit einer workspace_id wirken beide stattdessen auf das mit diesem Arbeitsbereich verknüpfte Unternehmen (Unternehmen und Verknüpfungen: siehe Tokens, Bereiche und Sicherheit). Gespräche, die Ihr Agent über MCP oder die Account-API führt, erhalten ein Profil unter denselben Bedingungen wie im Web-Chat, als Hintergrundinformation für jeden Durchgang eines Gesprächs, das Ihr eigener Account gestartet hat, und Antworten können Fakten daraus verwenden: außerhalb eines Arbeitsbereichs das Account-Profil; in einem persönlichen Arbeitsbereich nur das damit verknüpfte Unternehmen, und kein Profil, wenn keines verknüpft ist. Es werden nur die Profile Ihres eigenen Accounts genutzt, und sie werden niemals mit einem anderen Account geteilt. Das Account-Profil wird weder in Arbeitsbereichen noch in temporären Chats hinzugefügt, und es wird kein Profil hinzugefügt, wenn es nicht gelesen werden kann (der Durchgang läuft dann ohne es ab). Fakten, die nur für eine einzelne Frage relevant sind, können weiterhin in der Nachricht selbst oder in einem Arbeitsbereichsspeicher abgelegt werden.

Fast, Think oder Beyond

modeVerwendung für
fast (Standard)Die meisten Fragen und kurze Entwürfe.
thinkPrüfungen, bevor Ihr Agent Arbeit finalisiert, und mehrstufige Analysen: Lückenanalyse über mehrere Kontrollen hinweg, Mapping zwischen Frameworks. Bezahlte Pläne; bei einem kostenlosen Plan fällt es auf fast zurück.
beyondAuf Anfrage, für eine abschließende Prüfung kurz vor einem Audit oder für umfangreiche, forschungsreife Entwürfe. Bezahlte Pläne, begrenzt auf 10 Durchläufe pro UTC-Tag (50 bei Unlimited), Dauer im Minutenbereich.

Eine beyond-Anfrage, die nicht ausgeführt werden kann, wird über den normalen Ablauf beantwortet, und das Ergebnis gibt in beyond_denied_reason an, warum: plan, adp, disabled, trivial, cap oder cap_anthropic. Ein Durchgang, der auf dem Überlaufpfad läuft, wird ebenfalls über den normalen Ablauf beantwortet, anstatt Beyond zu nutzen. Siehe Beyond-Modus verwenden.

Fordern Sie eine Antwort an, die für einen Agenten strukturiert ist

create_conversation und send_message akzeptieren ein optionales answer_format:

answer_formatAntwortstruktur
briefDie kürzeste korrekte Antwort, etwa 150 Wörter, Framework-Referenzen inline.
decisionEmpfehlung zuerst, dann Begründung, Risiken und nächste Schritte als Aufzählungspunkte, etwa 300 Wörter.
full oder weggelassenDer Standard-Chat-Stil.

Ein explizit angefordertes vollständiges Dokument wird niemals gekürzt. Beyond-Durchläufe ignorieren answer_format und weisen darauf hin mit answer_format_applied: false.

Abfrageintervall

Wenn ein Aufruf status: "generating" zurückgibt, rufen Sie get_reply mit der conversation_id und message_id auf, bis complete zurückgegeben wird:

  • Fast- und Think-Durchgänge: alle 2–5 Sekunden.
  • Beyond-Durchläufe: alle 10–20 Sekunden. Sie können auch die beyond_run_id übergeben, die das Ticket zurückgegeben hat.

Warten Sie auf eine Antwort, bevor Sie die nächste Nachricht in derselben Konversation senden: Ein Senden, während der vorherige Durchgang noch generiert wird, wird abgelehnt.

Lange Arbeitsergebnisse in Dateien schreiben

Wenn der Spezialist eine Richtlinie oder eine vollständige SoA zurückgibt, lassen Sie Ihren Orchestrator diese direkt in eine Datei schreiben und melden Sie den Pfad. Die Wiederholung eines langen Dokuments im Chat führt dazu, dass es doppelt im Kontext Ihres Orchestrators erscheint. Siehe Was der Aufruf von ISMS Copilot spart.

MCP oder die Model API?

ISMS Copilot bietet zwei Möglichkeiten für den Einstieg aus einem Coding-Agenten. Sie eignen sich für unterschiedliche Aufgaben.

Account MCPModel API Sub-Agent
Anmeldedatenpat-isms-… persönliches Zugriffstokensk-isms-… API-Schlüssel
AbrechnungIhr ISMS Copilot-Tarif, dasselbe Nutzungslimit wie die Chat-AppVorab bezahlte API-Guthaben
ZustandZustandsbehaftet: Konversationen, Arbeitsbereiche, Speicher, DateienZustandslos: Jede Vervollständigung steht für sich
Tools in Ihrem AgentenJa, native MCP-ToolsNein: Der Endpunkt ist Text rein, Text raus, aufgerufen aus einem Skript oder Schritt
Am besten geeignet fürInteraktive Arbeit, bei der Sie und Ihr Agent ein Arbeitsergebnis über mehrere Durchgänge verfeinernFeste, wiederholbare Compliance-Schritte in Skripten, CI oder Automatisierung

Für das Model-API-Muster siehe API in Coding-Agents verwenden.

Wenn ein Durchgang auf Ihr Planlimit stößt, enthält der Tool-Fehler den Reset-Zeitpunkt und, falls zutreffend, den Upgrade-Link oder die Überlaufoption. Siehe Jeden MCP-Client verbinden.

Auf dieser Seite