ISMS Copilot mit Claude Code verbinden
Nutzen Sie Ihr ISMS Copilot-Konto in Claude Code. Fügen Sie den Server mit einem Befehl hinzu, melden Sie sich an und genehmigen Sie den Zugriff, dann lesen Sie Ihre Arbeitsbereiche und Erinnerungen und führen echte ISMS Copilot-Gespräche direkt aus Ihrem Terminal. Persönliche Zugriffstoken bleiben als Fallback verfügbar.
Sie können Ihr ISMS Copilot-Konto direkt aus Claude Code, Cursor oder jedem MCP-kompatiblen KI-Tool nutzen. Sobald die Verbindung hergestellt ist, kann Ihr KI-Tool Ihre Arbeitsbereiche und Dokumente auflisten, Ihre Erinnerungen lesen und echte ISMS Copilot-Gespräche führen – es handelt sich um Sie und ist durch Ihr bestehendes Abonnement abgedeckt.
Was Sie benötigen
- Ein ISMS Copilot-Konto. Die Verbindung ist durch Ihr Abonnement abgedeckt, es erfolgt keine separate Abrechnung.
- Ein Terminal mit installiertem Claude Code (oder einem anderen MCP-Client).
- Einige Funktionen hängen von Ihrem Plan ab (siehe Antwortverhalten auswählen).
Verbindung in drei Schritten herstellen
Bereits mit einem persönlichen Zugriffstoken verbunden? Entfernen Sie diesen Server zuerst, sonst verwendet Claude Code ihn weiter: claude mcp remove ismscopilot.
- Server hinzufügen (kein Token erforderlich):
claude mcp add --scope user --transport http ismscopilot https://account.ismscopilot.com/v1/account/mcp- Führen Sie in einer Claude Code-Sitzung
/mcpaus, wählen Sieismscopilotund folgen Sie den Schritten im Browser. Über das Terminal erreichen Sie dasselbe mitclaude mcp login ismscopilot. - Melden Sie sich bei ISMS Copilot an und klicken Sie auf Genehmigen auf der Einwilligungsseite.
Fragen Sie anschließend beispielsweise: "Liste meine ISMS Copilot-Arbeitsbereiche auf."
Die --scope user-Option macht ISMS Copilot in jedem Ordner verfügbar. Ohne diese Option wird die Verbindung nur in dem Verzeichnis registriert, in dem Sie den Befehl ausgeführt haben – das ist der häufigste Grund für das Problem "verbunden, aber nicht sichtbar".
claude.ai und Claude Desktop verbinden sich mit derselben Server-URL und derselben Anmeldung: siehe Jeden MCP-Client verbinden. ChatGPT verbindet sich auf dieselbe Weise, als benutzerdefinierte MCP-App: siehe dieselbe Seite. Für Cursor und Codex siehe Cursor und Codex verbinden.
Fallback: Verbindung mit einem persönlichen Zugriffstoken
Verwenden Sie ein Token, wenn eine Anmeldung nicht möglich ist, z. B. in CI oder auf einem Headless-Rechner:
- Öffnen Sie in ISMS Copilot Einstellungen und dann Verbundene Apps.
- Klicken Sie auf Token erstellen. Geben Sie ihm einen Namen (z. B. "Claude Code CI"), wählen Sie die Berechtigungen aus, die es haben soll (siehe Berechtigungen), und kopieren Sie das Token. Sie sehen es nur einmal.
- Fügen Sie den angezeigten Befehl in Ihr Terminal ein. Er sieht etwa so aus:
claude mcp add --scope user --transport http ismscopilot https://account.ismscopilot.com/v1/account/mcp --header "Authorization: Bearer pat-isms-..."Was Ihr KI-Tool tun kann
Eine Verbindung kann Folgendes lesen und ausführen – und nichts anderes. Eine Anmeldeverbindung erhält alle unten aufgeführten Rechte; ein Token erhält nur die Rechte, die seine Berechtigungen abdecken:
| Fähigkeit | Lesen | Ändern |
|---|---|---|
| Kontoinformationen | Ja | Nein |
| Arbeitsbereiche | Ja (auflisten) | Ja (persönlichen Arbeitsbereich mit create_workspace erstellen, bis zu 10 pro 24 Stunden) |
| Dokumente | Nur Metadaten (Namen und Details auflisten; kein Dateiinhalt) | Nein |
| Erinnerungen | Ja | Ja (erstellen und bearbeiten) |
| Unternehmenskontext | Ja | Ja (set_company_context ersetzt das gesamte Profil) |
| Gespräche | n/a | Ja (neue starten, Nachrichten senden) |
Von Ihrem KI-Tool aus können Sie also Ihre Arbeitsbereiche und Dokumente auflisten, einen persönlichen Arbeitsbereich erstellen, eine Erinnerung hinzufügen oder bearbeiten und ein fundiertes ISMS Copilot-Gespräch führen – alles ohne Ihren Editor zu verlassen.
Antwortverhalten auswählen (Fast, Think und Beyond)
Wenn Sie ein Gespräch in Ihrem KI-Tool starten oder fortsetzen, wählen Sie den Modus. Die Verbindung übernimmt ihn nicht aus der Frage. Wenn der Orchestrator mode weglässt, verwendet ISMS Copilot Fast.
- Fast (Standard): schnelle Antworten, keine vertiefte Analyse.
- Think: tiefere Analyse für komplexere Fragen. Nur für kostenpflichtige Pläne. Bei einem kostenlosen Plan fällt eine Think-Anfrage auf Fast zurück.
- Beyond: mehrstufiger Plan, Entwurf und Überprüfung. Nur für kostenpflichtige Pläne, 10 Durchläufe pro UTC-Tag (50 bei Unlimited). Dauer im Minutenbereich. Der Orchestrator muss
mode: "beyond"beicreate_conversationodersend_messageübergeben und dann etwa alle 10-20 Sekundenget_replyabfragen, bis der Durchlauf abgeschlossen ist. Wenn Beyond nicht ausgeführt werden kann, wird die Antwort über den normalen Ablauf gegeben und enthältbeyond_denied_reason.
In der Praxis:
- „Denke sorgfältig darüber nach“ reicht für Think aus.
- „Nutze Beyond“ oder „Führe dies in Beyond aus“ reicht für Beyond aus. Der Orchestrator wird eine schwierige Frage nicht selbstständig upgraden.
Eine Fast- oder Think-Antwort, die nicht sofort bereitsteht, gibt status: "generating" zurück. Der Orchestrator fragt dann etwa alle 2-5 Sekunden get_reply ab, bis complete zurückgegeben wird.
Siehe Beyond-Modus verwenden.
Wenn Sie ein Nutzungslimit erreichen
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 nutzt dasselbe 4-Stunden-UTC-Sitzungsfenster wie die Chat-App. Wenn create_conversation oder send_message das Limit erreicht, enthält die erste Fehlermeldung den Warte- oder Upgrade-Hinweis (inklusive des nächsten Reset-Zeitpunkts) und der JSON-Block enthält reset_at. Einzelkonten und Organisationsadministratoren erhalten außerdem upgrade_url. Organisationsmitglieder erhalten stattdessen den Team-Hinweis: Fragen Sie den Administrator nach zusätzlicher Nutzung oder warten Sie bis zum nächsten 4-Stunden-Fenster. Ihr JSON enthält quota_scope, org_role und extra_usage_buyable, aber keinen Upgrade-Link.
Sie können:
- Bis
reset_atwarten. upgrade_urlin einem Browser öffnen, während Sie im selben ISMS Copilot-Konto angemeldet sind (Einzelkonten und Organisationsadministratoren).- Wenn das JSON
fallback_available: trueenthält und der Überlauf Ihres Plans verfügbar ist (kostenpflichtige Einzelkonten mit deaktiviertem Advanced Data Protection; niemals bei einem Team-Pool), weisen Sie den Orchestrator an, fortzufahren: Auf Ihre ausdrückliche Zustimmung hin sendet er mitoverflow_consent: trueerneut, und der Durchlauf wird mit demselben bis zu 2-fachen Überlauf ausgeführt, den auch die Web-App bietet (die Antwort enthältoverflow_active: true). - Weiterhin Lesefunktionen nutzen. Arbeitsbereiche, Erinnerungen, Dokumente und Kontoinformationen funktionieren auch nach Erreichen des Chat-Limits.
Siehe Was tun, wenn Sie Ihr Nutzungslimit erreichen.
Einstellungen bleiben in der Web-App
Geschützte Kontoeinstellungen sind über die Verbindung nur lesbar (Unternehmenskontext, wie oben erwähnt, ist das einzige Profil, das ein Token mit company_context:write ersetzen kann). Insbesondere kann Advanced Data Protection (das Ihre Daten über einen EU-basierten Anbieter mit Null-Retention leitet) nicht über Ihr KI-Tool ein- oder ausgeschaltet werden.
Wenn Sie Ihr KI-Tool nach dem Datenschutz fragen, kann es melden, ob dieser für Ihr Konto aktiviert ist, und Sie auf Einstellungen, Datenschutz unter chat.ismscopilot.com verweisen, um ihn zu ändern. Dies ist beabsichtigt: Ein Verbindungstoken sollte keine globale Datenresidenz-Einstellung umschalten können.
Arbeitsbereichs- oder Organisationseinstellungen können Advanced Data Protection für bestimmte Arbeitsbereiche erzwingen, unabhängig von Ihrer persönlichen Kontoeinstellung. Daher kann ein bestimmtes Gespräch möglicherweise im EU-Modus laufen, selbst wenn Ihr Konto-Standard deaktiviert ist.
Berechtigungen
Wenn Sie sich anmelden und auf Genehmigen klicken, erhält das Tool einen festen Satz Berechtigungen: Lesen Ihres Kontos, Arbeitsbereiche, Dokumente (Metadaten), Erinnerungen und Unternehmensprofil; ISMS Copilot fragen und Antworten lesen; Ihr Unternehmensprofil und Erinnerungen aktualisieren sowie Arbeitsbereiche erstellen. Es kann keine API-Schlüssel erstellen oder Credits kaufen. Änderungen, die es vornimmt, werden in ISMS Copilot mit dem Namen des Tools gekennzeichnet, z. B. Added by OAuth app: <name> oder Updated by OAuth app: <name>.
Wenn Sie stattdessen ein Token erstellen, wählen Sie genau aus, was es tun darf (Arbeitsbereiche lesen, Dokumente lesen, Erinnerungen lesen und schreiben, Gespräche starten usw.). Gewähren Sie nur, was Sie benötigen. Ein Token, das nur Ihre Arbeitsbereiche lesen kann, kann Ihre Erinnerungen nicht ändern oder Gespräche starten.
Sie können alle Verbindungen jederzeit unter Einstellungen, Verbundene Apps einsehen und trennen: Token in der Token-Liste, Anmeldeverbindungen unter Verbundene Agenten.
Verbindung erneuern oder Token rotieren
Wenn eine Anmeldeverbindung nicht mehr funktioniert (z. B. nachdem Sie sie getrennt haben), führen Sie /mcp aus, wählen Sie ismscopilot und melden Sie sich erneut an.
Wenn Sie mit einem Token verbunden sind und zu einem neuen wechseln möchten, entfernen Sie zuerst den bestehenden Server. Andernfalls behält Claude Code das alte Token:
claude mcp remove ismscopilotFügen Sie dann den Server erneut hinzu, entweder per Anmeldung oder mit dem neuen Token.
Sicherheit
- Eine Verbindung handelt als Sie, kann also genau das erreichen, was Ihr Konto bereits erreichen kann, begrenzt durch das, was Sie genehmigt oder welche Berechtigungen Sie erteilt haben.
- Sie ist durch Ihr Abonnement abgedeckt, es erfolgt keine separate Abrechnung.
- Sie können sie jederzeit trennen unter Einstellungen, Verbundene Apps. Das Trennen wird sofort wirksam.
- Behandeln Sie ein Token wie ein Passwort. Wenn eines kompromittiert wird, widerrufen Sie es und erstellen Sie ein neues.
Fehlerbehebung
- Verbunden, aber die Tools werden nicht angezeigt: Führen Sie den Verbindungsbefehl erneut mit
--scope useraus oder führen Sieclaude mcp remove ismscopilotaus und fügen Sie es erneut hinzu. - Authentifizierung fehlgeschlagen oder "Benötigt Authentifizierung": Eine Anmeldeverbindung wurde getrennt oder ist abgelaufen: Führen Sie
/mcpaus und melden Sie sich erneut an. Ein Token wurde möglicherweise widerrufen oder ist abgelaufen: Erstellen Sie ein neues unter Einstellungen, Verbundene Apps. - Think-Modus scheint nicht tiefer zu gehen: Think erfordert einen kostenpflichtigen Plan. Bei einem kostenlosen Plan fällt es auf Fast zurück.
- Beyond wurde als normale Antwort ausgeführt: Der Orchestrator hat wahrscheinlich
modeweggelassen. Bitten Sie ihn,mode: "beyond"zu senden, oder sagen Sie „Nutze Beyond“ beim nächsten Durchlauf. Prüfen Siebeyond_denied_reason, wenn eine Beyond-Anfrage herabgestuft wurde.