Verbind ISMS Copilot met Claude Code

Je kunt je ISMS Copilot-account rechtstreeks gebruiken vanuit Claude Code, Cursor of elke 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 wordt gedekt door 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 hem 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 maken verbinding met dezelfde server-URL met dezelfde aanmelding: zie Verbind elke MCP-client. ChatGPT verbindt op dezelfde manier, als 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 Gekoppelde 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 zo 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 onderstaande regel; een token krijgt de regels die zijn rechten dekken:

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)

Wanneer je een gesprek start of voortzet vanuit je AI-tool, kies je de modus. De verbinding kiest deze niet op basis van de vraag. Als de orchestrator mode weglaat, gebruikt ISMS Copilot Fast.

• Fast (standaard): snelle antwoorden, geen uitgebreide redenering.
• Think: diepgaandere redenering voor moeilijkere vragen. Alleen voor betaalde abonnementen. Op een gratis abonnement valt een Think-verzoek terug op Fast.
• Beyond: meerstappenplan, opzet en verificatie. Alleen voor betaalde abonnementen, 10 runs per UTC-dag (50 op Unlimited). Minuten-schaal. De orchestrator 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 goed over na” is voldoende voor Think.
• “Gebruik Beyond” of “voer dit uit in Beyond” is voldoende voor Beyond. De orchestrator zal een moeilijke vraag niet zelf upgraden.

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

Zie Beyond-modus gebruiken.

Als je tegen een gebruikslimiet aanloopt

Inlogverbindingen (Claude, ChatGPT): de fouttekst noemt de limiet en wanneer die wordt gereset, zonder uitnodiging tot upgraden. De JSON bevat reset_at, maar nooit upgrade_url, usage_url of extra_usage_buyable. De upgrade- en aankoopvelden hieronder verschijnen alleen bij verbindingen met een persoonlijk toegangstoken.

De verbinding gebruikt hetzelfde 4-uurs UTC-sessievenster als de chat-app. 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 upgrade-link.

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 het JSON fallback_available: true bevat en de overflow van je abonnement beschikbaar is (solo betaalde accounts met Advanced Data Protection uit; nooit op een teampool), geef de orchestrator dan de 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. Blijf leestools gebruiken. Werkruimten, herinneringen, documenten en accountinformatie 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 (bedrijfscontext, hierboven, is het enige profiel dat een token met company_context:write kan vervangen). Met name Advanced Data Protection (dat je gegevens via een in de EU gevestigde provider met nulretentie routeert) kan niet worden in- of uitgeschakeld vanuit je AI-tool.

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

Rechten

Wanneer je je aanmeldt en op Goedkeuren klikt, krijgt de tool één vaste set rechten: lees je account, werkruimten, documenten (metadata), herinneringen en bedrijfsprofiel; vraag ISMS Copilot en lees antwoorden; werk je bedrijfsprofiel en herinneringen bij, 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 ontkoppelen in Instellingen, Gekoppelde apps: tokens in de tokenlijst, aanmeldingsverbindingen onder Gekoppelde agents.

Opnieuw verbinden of een token roteren

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

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

claude mcp remove ismscopilot

Voeg vervolgens de server opnieuw toe, met aanmelding 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 is gedekt door je abonnement, zonder aparte facturering.
• Je kunt het op elk moment ontkoppelen in Instellingen, Gekoppelde apps. Ontkoppelen werkt onmiddellijk.
• Behandel een token als een wachtwoord. Als er een is 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 ontkoppeld of verlopen: voer /mcp uit en meld je opnieuw aan. Een token is mogelijk ingetrokken of verlopen: maak een nieuwe aan in Instellingen, Gekoppelde apps.
• Think-modus lijkt niet diepgaander: Think vereist een betaald abonnement. Op een gratis abonnement valt het terug op Fast.
• Beyond werd uitgevoerd als een normaal antwoord: de orchestrator 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.