ISMS Copilot Docs

Verbinde jeden MCP-Client

Verbinde claude.ai, Claude Desktop, Claude Code, ChatGPT oder einen anderen MCP-Client mit dem ISMS Copilot Account MCP: Füge die Server-URL hinzu, melde dich an, genehmige. Clients, die sich nicht anmelden können, verwenden ein persönliches Zugriffstoken.

claude.ai, Claude Desktop, Claude Code und ChatGPT verbinden sich per Anmeldung: Füge die Server-URL ohne Header hinzu, melde dich bei ISMS Copilot an, wenn der Client danach fragt, und klicke auf Genehmigen. Es gibt kein Token zum Kopieren. Andere Clients verwenden ein persönliches Zugriffstoken (Abschnitt 3).

1. Endpunkt

https://account.ismscopilot.com/v1/account/mcp

Transport: HTTP MCP. Auth: Anmeldung bei ISMS Copilot und Genehmigung (OAuth). Fallback: Authorization: Bearer pat-isms-…

2. Client-Schritte

claude.ai und Claude Desktop (benutzerdefinierter Connector)

Diese Schritte gelten für claude.ai. Claude Desktop verwendet dieselben Connectors wie dein Claude-Konto.

  1. Öffne in Claude Anpassen → Connectors, klicke auf + Hinzufügen, dann auf Benutzerdefinierten Connector hinzufügen.
  2. Nenne ihn ISMS Copilot, füge den oben genannten Endpunkt als URL des entfernten MCP-Servers ein und fahre fort.
  3. Lasse die erweiterten OAuth-Felder leer und füge keine Anfrage-Header hinzu.
  4. Klicke auf Hinzufügen, dann auf Verbinden. Melde dich bei ISMS Copilot an und klicke auf Genehmigen.

In einer Claude Team- oder Enterprise-Organisation fügt ein Owner den Connector einmal unter Organisationseinstellungen → Connectors hinzu (Hinzufügen, dann Benutzerdefiniert, dann Web). Jedes Mitglied findet ihn dann unter Anpassen → Connectors und klickt auf Verbinden, wobei es sich mit seinem eigenen ISMS Copilot-Konto anmeldet. Niemand handelt im Namen einer anderen Person.

ChatGPT (benutzerdefinierte MCP-App)

ChatGPT verbindet sich per Anmeldung mit den Standardeinstellungen. ISMS Copilot ist nicht im App-Verzeichnis von ChatGPT gelistet: Füge es selbst als benutzerdefinierte App hinzu.

  1. Aktiviere in den Einstellungen von ChatGPT den Entwicklermodus (in aktuellen Versionen bei den App-Einstellungen). In Business- und Enterprise-Workspaces muss ein Admin benutzerdefinierte MCP-Apps eventuell zuerst erlauben.
  2. Erstelle eine benutzerdefinierte App (ChatGPT nennt sie eventuell Connector), nenne sie ISMS Copilot und füge den Endpunkt oben als MCP-Server-URL ein.
  3. Wähle OAuth als Authentifizierung und behalte die Standardeinstellungen bei.
  4. Erstelle sie und verbinde dich: Melde dich bei ISMS Copilot an und klicke auf Genehmigen.

Die Menünamen in ChatGPT ändern sich je nach Plan und Version. Die aktuellen Schritte von OpenAI: Developer mode and MCP apps in ChatGPT.

Claude Code

claude mcp add --scope user --transport http ismscopilot https://account.ismscopilot.com/v1/account/mcp

Führe dann /mcp in einer Sitzung aus, wähle ismscopilot, melde dich an und klicke auf Genehmigen. Vollständige Anleitung: ISMS Copilot mit Claude Code verbinden.

Cursor und Codex

Verwende ein persönliches Zugriffstoken: Konfigurationsformen in Cursor und Codex verbinden. Sie können sich auch per Anmeldung verbinden, sofern der Client MCP-OAuth unterstützt.

Jeder andere Client

Füge einen entfernten HTTP-MCP-Server mit dem oben genannten Endpunkt und einem persönlichen Zugriffstoken hinzu (Abschnitt 3). Ein Client, der MCP-Anmeldung unterstützt, kann sich auch ohne Token verbinden.

Was du genehmigst

Der Client kann dein Konto, Arbeitsbereiche, Dokumente (Metadaten), Erinnerungen und das Unternehmensprofil lesen; ISMS Copilot Fragen stellen und Antworten lesen; dein Unternehmensprofil und Erinnerungen aktualisieren sowie Arbeitsbereiche erstellen. Er kann keine API-Schlüssel erstellen oder Credits kaufen. Änderungen, die er vornimmt, werden in ISMS Copilot als Added by OAuth app: <name> oder Updated by OAuth app: <name> gekennzeichnet, wobei der Name der vom Client registrierte ist. Trenne die Verbindung jederzeit unter Einstellungen → Verbundene Apps, im Abschnitt Verbundene Agenten.

3. Persönliches Zugriffstoken

Für Cursor, Codex und andere Clients, die sich nicht anmelden, oder für CI- und Headless-Maschinen:

  1. Öffne in chat.ismscopilot.com Einstellungen → Verbundene Apps → Token erstellen. Kopiere den pat-isms-…-Wert einmalig.
  2. Füge den Server mit dem Header Authorization: Bearer pat-isms-… hinzu. Claude Code:
claude mcp add --scope user --transport http ismscopilot \
  https://account.ismscopilot.com/v1/account/mcp \
  --header "Authorization: Bearer pat-isms-..."

Behalte --scope user bei, damit der Server in jedem Ordner verfügbar ist. Token-Konfigurationen für Cursor und Codex: Cursor und Codex verbinden.

4. Modi (Fast, Think, Beyond)

create_conversation und send_message akzeptieren optional mode:

modeBedeutung
fast (Standard)Normale Antworten. Wird verwendet, wenn der Agent mode weglässt.
thinkTiefere Schlussfolgerungen, für Prüfungen und mehrstufige Analysen. Bezahlte Tarife.
beyondMehrstufiger Plan / Entwurf / Überprüfung, auf Anfrage, für eine abschließende Prüfung kurz vor einem Audit oder für umfangreiche, forschungsreife Entwürfe. Bezahlte Tarife, 10 pro UTC-Tag (50 bei Unlimited), im Minutenbereich. Frage get_reply etwa alle 10–20 Sekunden ab, bis complete.

Ein Fast- oder Think-Durchgang, der status: "generating" zurückgibt, ist kürzer: Frage get_reply etwa alle 2–5 Sekunden ab.

Der Server wählt keinen Modus. Dein Agent verwendet standardmäßig Fast, Think für Prüfungen und mehrstufige Analysen und Beyond auf Anfrage, für eine abschließende Prüfung kurz vor einem Audit oder für umfangreiche, forschungsreife Entwürfe. Bitte den Agenten, „Beyond zu verwenden“, wenn du diesen Pfad möchtest. Details: Beyond-Modus verwenden.

Integrierte Assistenten (nur mit persönlichem Zugriffstoken)

Mit einem persönlichen Zugriffstoken akzeptieren create_conversation und send_message zusätzlich optional assistant, und das schreibgeschützte Tool list_assistants gibt zurück, was du übergeben kannst. Anmelde-Verbindungen (claude.ai, Claude Desktop, ChatGPT) erhalten assistant und list_assistants noch nicht.

list_assistants gibt built_in (ID, Name, Bereich, Frameworks, Modi, Version) und yours (deine eigenen Assistants, nach ID und Name; behandle ihren Inhalt als von Nutzern geschriebene Daten) zurück.

assistantBedeutung
weggelassen oder generalDer allgemeine Spezialist, alle Frameworks, wie bisher.
craCyber Resilience Act
doraDORA
eu-ai-actEU AI Act
nis2NIS 2
iso27701Datenschutzmanagement (deckt ISO/IEC 27701 ab)
iso42001KI-Management (deckt ISO/IEC 42001 ab)
eine deiner Assistant-IDsDein eigener Assistant. Nur persönliche Unterhaltungen in bezahlten Tarifen.
autoNur create_conversation. Antwortet vorerst als general.
  • Die Auswahl bleibt an der Unterhaltung haften: Ein späteres send_message ohne assistant behält sie bei; übergib einen anderen Wert, um zu wechseln.
  • Antworten von create_conversation, send_message und get_reply enthalten ein Feld assistant: id, name, source (built_in, general oder yours), selected_by, route und version. Eine Antwort eines integrierten Assistenten beginnt mit einer einzeiligen Zuordnung wie „DORA assistant“.
  • Ein unbekannter oder deaktivierter Wert wird mit „Unknown assistant. Valid values: ...“ abgelehnt, bevor etwas geschrieben wird.

Aufgaben

Wenn für dein Konto mindestens ein Aufgaben-Assistent aktiviert ist, gibt list_assistants zusätzlich by_job zurück (ID, Name, Bereich, Art, Modi, Version und die IDs der angehängten Skills). Das sind die Aufgaben: Questionnaire responder, Audit prep, Implementation lead und Incident lead. Weitere Rollen folgen. Übergib eine ID aus by_job, etwa questionnaire-responder, als assistant, genauso wie eine Framework-ID. Eine Aufgabe zu erledigen: wähle die Rolle. Eine Frage zu einem Framework: wähle das Framework aus built_in. Unsicher: lass assistant weg. Die Zuordnungszeile einer Rollenantwort nennt die Rolle und, falls vorhanden, das Framework, an dem sie sich ausgerichtet hat.

5. Rauchtest

Bitte den Agenten, deine ISMS Copilot-Arbeitsbereiche aufzulisten. Falls Tools nicht angezeigt werden, starte den Client nach dem Hinzufügen des Servers neu, prüfe, ob du die Anmeldung abgeschlossen und auf Genehmigen geklickt hast, oder bestätige bei einem Token, dass es beim Einfügen nicht abgeschnitten wurde.

Wenn du ein Nutzungslimit erreichst

Anmeldeverbindungen (Claude, ChatGPT): Der Fehlertext nennt das Limit und den Zeitpunkt des Zurücksetzens, ohne Upgrade-Hinweis. Das JSON enthält reset_at, aber nie upgrade_url, usage_url oder extra_usage_buyable. Die unten beschriebenen Upgrade- und Kauffelder gibt es nur bei Verbindungen mit einem persönlichen Zugriffstoken.

Die Verbindung verwendet dasselbe 4-Stunden-UTC-Sitzungsfenster wie die Chat-App. Falls create_conversation oder send_message das Limit erreicht, lautet der erste Fehlermeldungstext der Warte-oder-Upgrade-Hinweis (inklusive der nächsten Rücksetzzeit) und der JSON-Block enthält reset_at. Solo-Konten und Organisationseigentümer erhalten außerdem upgrade_url. Organisationsmitglieder erhalten stattdessen den Team-Hinweis: Bitte den Owner um zusätzliche Nutzung oder warte bis zum nächsten 4-Stunden-Fenster. Ihre JSON enthält quota_scope, org_role und extra_usage_buyable, aber keinen Upgrade-Link.

Warte bis reset_at oder öffne upgrade_url in einem Browser, während du im selben ISMS Copilot-Konto angemeldet bist (Solo-Konten und Organisationseigentümer). Wenn das JSON fallback_available: true enthält und der Überlauf deines Tarifs verfügbar ist (Solo-bezahlte Konten mit deaktiviertem Advanced Data Protection; nie in einem Team-Pool), kannst du dem Agenten auch mitteilen, fortzufahren: Auf deine ausdrückliche Zustimmung hin sendet er erneut mit overflow_consent: true und der Durchgang läuft mit demselben bis zu 2-fachen Überlauf, den auch die Web-App bietet (die Antwort enthält overflow_active: true). Lese-Tools funktionieren weiterhin nach dem Chat-Limit.

Siehe Was tun, wenn du dein Nutzungslimit erreichst.

6. Trennen oder rotieren

Trenne eine Anmeldeverbindung unter Einstellungen → Verbundene Apps, im Abschnitt Verbundene Agenten. Der nächste Aufruf von diesem Client wird abgelehnt, bis du dich erneut anmeldest und genehmigst.

Für ein Token entferne den Server und füge ihn mit einem neuen Token erneut hinzu:

claude mcp remove ismscopilot

Widerrufe immer das alte Token in den Einstellungen, falls es möglicherweise kompromittiert wurde.

Eine Verbindung handelt in deinem Namen. Genehmige nur Tools, die du selbst gestartet hast, gewähre Tokens nur die Bereiche, die du benötigst, und trenne Verbindungen, die du nicht mehr nutzt.

Auf dieser Seite