Verbind ISMS Copilot met Claude Code

Claude doet het werk. ISMS Copilot is de compliance-expert die het raadpleegt en controleert of het werk voldoet. Jij beslist en tekent.

Je kunt je ISMS Copilot-account rechtstreeks gebruiken vanuit Claude Code, Cursor of elke andere AI-tool die compatibel is met MCP. Eenmaal verbonden, kan je AI-tool je werkruimten en documenten weergeven, je herinneringen lezen en echte ISMS Copilot-gesprekken voeren, waarbij het handelt als jij en gedekt wordt door je bestaande abonnement.

Wat je nodig hebt

• Een ISMS Copilot-account. De verbinding valt onder je abonnement, zonder aparte facturering.
• Een terminal met Claude Code (of een andere MCP-client) geïnstalleerd.
• Sommige mogelijkheden zijn afhankelijk van je abonnement (zie Kiezen hoe het antwoordt).

Verbinden in drie stappen

Al verbonden met een persoonlijk toegangstoken? Verwijder die server eerst, anders blijft Claude Code deze gebruiken: claude mcp remove ismscopilot.

1. Voeg de server toe (geen token nodig):

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

2. Voer in een Claude Code-sessie /mcp uit, kies ismscopilot en volg de stappen in je browser. Vanaf een terminal doet claude mcp login ismscopilot hetzelfde.
3. Meld je aan bij ISMS Copilot en klik op Goedkeuren op de toestemmingspagina.

Vraag vervolgens bijvoorbeeld: "toon mijn ISMS Copilot-werkruimten."

claude.ai en Claude Desktop verbinden met dezelfde server-URL en dezelfde aanmelding: zie Verbind elke MCP-client. ChatGPT verbindt op dezelfde manier, als een aangepaste MCP-app: zie dezelfde pagina. Voor Cursor en Codex, zie Verbind Cursor en Codex.

Fallback: verbinden met een persoonlijk toegangstoken

Gebruik een token wanneer aanmelden niet mogelijk is, bijvoorbeeld in CI of op een headless machine:

1. Open in ISMS Copilot Instellingen en vervolgens Verbonden apps.
2. Klik op Token aanmaken. Geef het een naam (bijvoorbeeld "Claude Code CI"), kies de rechten die het moet hebben (zie Rechten) en kopieer het token. Je ziet het slechts één keer.
3. Plak het getoonde commando in je terminal. Het ziet er als volgt uit:

claude mcp add --scope user --transport http ismscopilot https://account.ismscopilot.com/v1/account/mcp --header "Authorization: Bearer pat-isms-..."

Wat je AI-tool kan doen

Een verbinding kan het volgende lezen en doen, en niets anders. Een aanmeldingsverbinding krijgt elke rij hieronder; een token krijgt de rijen die onder zijn rechten vallen:

Dus vanuit je AI-tool kun je je werkruimten en documenten weergeven, een persoonlijke werkruimte aanmaken, een herinnering toevoegen of bewerken en een gefundeerd ISMS Copilot-gesprek voeren, allemaal zonder je editor te verlaten.

Kiezen hoe het antwoordt (Fast, Think en Beyond)

De server kiest geen modus. Je agent gebruikt Fast standaard, Think voor controles en meertrapsanalyses, en Beyond op verzoek, voor een laatste controle vlak voor een audit of voor langdurig onderzoekskwaliteit opstellen. Als de agent mode weglaat, gebruikt ISMS Copilot Fast.

• Fast (standaard): snelle antwoorden, geen uitgebreide redenering.
• Think: diepgaandere redenering voor controles en meertrapsanalyses. Alleen voor betaalde abonnementen. Bij een gratis abonnement valt een Think-verzoek terug op Fast.
• Beyond: meertrapsplan, opstellen en verifiëren. Alleen voor betaalde abonnementen, 10 runs per UTC-dag (50 bij Unlimited). Minuten-schaal. De agent moet mode: "beyond" doorgeven bij create_conversation of send_message, en vervolgens ongeveer elke 10-20 seconden get_reply pollen tot de run voltooid is. Als Beyond niet kan worden uitgevoerd, wordt de beurt beantwoord via de normale flow en bevat deze beyond_denied_reason.

In de praktijk:

• “Denk hier zorgvuldig over na” is voldoende voor Think.
• “Gebruik Beyond” of “voer dit uit in Beyond” is voldoende voor Beyond. Zonder dat kan de agent nog steeds Beyond kiezen voor een laatste controle vlak voor een audit, of voor langdurig onderzoekskwaliteit opstellen.

Een Fast- of Think-beurt die niet direct klaar is, retourneert status: "generating". De agent polt vervolgens ongeveer elke 2-5 seconden get_reply tot deze complete retourneert.

Zie Beyond-modus gebruiken.

Als je tegen een gebruikslimiet aanloopt

Aanmeldingsverbindingen (Claude, ChatGPT): de foutmelding vermeldt de limiet en wanneer deze reset, zonder uitnodiging om te upgraden. De JSON bevat reset_at maar nooit upgrade_url, usage_url of extra_usage_buyable. De upgrade- en aankoopvelden die hieronder worden beschreven, verschijnen alleen bij verbindingen met een persoonlijk toegangstoken.

De verbinding gebruikt dezelfde gebruikslimiet als de chat-app: het tegoed van je abonnement, met het resetmoment dat de app toont. Als create_conversation of send_message de limiet bereikt, is de eerste foutmelding de wacht-of-upgradezin (inclusief het volgende resetmoment) en bevat het JSON-blok reset_at. Solo-accounts en organisatie-eigenaren krijgen ook upgrade_url. Organisatieleden krijgen in plaats daarvan de teamzin: vraag de eigenaar om extra gebruik, of wacht tot het volgende 4-uursvenster. Hun JSON bevat quota_scope, org_role en extra_usage_buyable, en geen upgradelink.

Je kunt:

1. Wachten tot reset_at.
2. upgrade_url openen in een browser terwijl je bent aangemeld bij hetzelfde ISMS Copilot-account (solo-accounts en organisatie-eigenaren).
3. Wanneer de JSON fallback_available: true bevat en de overflow van je abonnement beschikbaar is (solo betaalde accounts met Advanced Data Protection uit; nooit bij een teampool), geef je de agent opdracht om door te gaan: op jouw expliciete toestemming stuurt het opnieuw met overflow_consent: true en wordt de beurt uitgevoerd op dezelfde tot 2x overflow die de web-app biedt (het antwoord bevat overflow_active: true).
4. Blijven leestools gebruiken. Werkruimten, herinneringen, documenten en accountgegevens werken nog steeds na de chatlimiet.

Zie Wat te doen als je je gebruikslimiet bereikt.

Instellingen blijven in de web-app

Beschermde accountinstellingen zijn alleen-lezen vanuit de verbinding (bedrijven, hierboven, vormen de uitzondering: een aanmeldingsverbinding, of een token met company_context:write, kan deze aanmaken, wijzigen en verwijderen en ze koppelen aan werkruimten of ontkoppelen, tot aan de limiet van je abonnement). Met name Advanced Data Protection (dat je gegevens via een in de EU gevestigde, zero-retentieprovider routeert) kan niet worden in- of uitgeschakeld vanuit je AI-tool.

Als je je AI-tool vraagt naar Data Protection, kan het rapporteren of deze is ingeschakeld voor je account en verwijst het je naar Instellingen, Data Protection op chat.ismscopilot.com om deze te wijzigen. Dit is opzettelijk: een verbindingstoken mag geen globale gegevensresidency-instelling kunnen wijzigen.

Rechten

Wanneer je je aanmeldt en op Goedkeuren klikt, krijgt de tool één vaste set: lees je account, werkruimten, documenten (metadata), herinneringen en bedrijven; vraag ISMS Copilot, lees antwoorden en markeer een vastgelopen antwoord als mislukt; maak bedrijven aan, wijzig en verwijder ze en koppel ze aan werkruimten of ontkoppel ze, bewerk herinneringen en maak werkruimten aan. Het kan geen API-sleutels aanmaken of credits kopen. Wijzigingen die het aanbrengt, worden in ISMS Copilot gelabeld met de naam van de tool, als Added by OAuth app: <name> of Updated by OAuth app: <name>.

Wanneer je in plaats daarvan een token aanmaakt, kies je precies wat het kan doen (werkruimten lezen, documenten lezen, herinneringen lezen en schrijven, gesprekken starten, enzovoort). Geef alleen wat je nodig hebt. Een token dat alleen je werkruimten kan lezen, kan je herinneringen niet wijzigen of gesprekken starten.

Je kunt op elk moment alle verbindingen bekijken en verbreken in Instellingen, Verbonden apps: tokens in de tokenlijst, aanmeldingsverbindingen onder Verbonden agents.

Opnieuw verbinden of een token roteren

Als een aanmeldingsverbinding niet meer werkt (bijvoorbeeld nadat je deze hebt verbroken), voer je /mcp uit, kies je ismscopilot en meld je opnieuw aan.

Als je verbonden bent met een token en wilt overschakelen naar een nieuw token, verwijder je eerst de bestaande server. Anders blijft Claude Code het oude token gebruiken:

claude mcp remove ismscopilot

Voeg vervolgens de server opnieuw toe, met aanmelden of met het nieuwe token.

Beveiliging

• Een verbinding handelt als jij, dus het kan precies bereiken wat je account al kan bereiken, beperkt door wat je hebt goedgekeurd of de rechten die je hebt verleend.
• Het valt onder je abonnement, zonder aparte facturering.
• Je kunt het op elk moment verbreken in Instellingen, Verbonden apps. Het verbreken werkt onmiddellijk.
• Behandel een token als een wachtwoord. Als er een wordt blootgesteld, trek het dan in en maak een nieuwe aan.

Problemen oplossen

• Verbonden maar de tools worden niet weergegeven: voer het verbindingscommando opnieuw uit met --scope user, of voer claude mcp remove ismscopilot uit en voeg het opnieuw toe.
• Authenticatie mislukt of "heeft authenticatie nodig": een aanmeldingsverbinding is verbroken of verlopen: voer /mcp uit en meld je opnieuw aan. Een token is mogelijk ingetrokken of verlopen: maak een nieuwe aan in Instellingen, Verbonden apps.
• Think-modus lijkt niet diepgaander: Think vereist een betaald abonnement. Bij een gratis abonnement valt het terug op Fast.
• Beyond werd uitgevoerd als een normaal antwoord: de agent heeft waarschijnlijk mode weggelaten. Vraag het om mode: "beyond" te verzenden, of zeg “gebruik Beyond” bij de volgende beurt. Controleer beyond_denied_reason als een Beyond-verzoek is gedegradeerd.