ISMS Copilot Docs

Verbind elke MCP-client

Verbind claude.ai, Claude Desktop, Claude Code, ChatGPT of een andere MCP-client met de ISMS Copilot account MCP: voeg de server-URL toe, meld je aan, keur goed. Clients die niet kunnen inloggen, gebruiken een persoonlijk toegangstoken.

claude.ai, Claude Desktop, Claude Code en ChatGPT verbinden via inloggen: voeg de server-URL toe zonder header, meld je aan bij ISMS Copilot wanneer de client dit vraagt, en klik op Goedkeuren. Er hoeft geen token te worden gekopieerd. Andere clients gebruiken een persoonlijk toegangstoken (sectie 3).

1. Eindpunt

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

Transport: HTTP MCP. Auth: meld je aan bij ISMS Copilot en keur goed (OAuth). Fallback: Authorization: Bearer pat-isms-…

2. Stappen voor de client

claude.ai en Claude Desktop (aangepaste connector)

Deze stappen zijn voor claude.ai. Claude Desktop gebruikt dezelfde connectors als je Claude-account.

  1. Open in Claude Aanpassen → Connectors, klik op + Toevoegen, vervolgens op Aangepaste connector toevoegen.
  2. Noem het ISMS Copilot, plak het bovenstaande eindpunt als de externe MCP-server-URL en ga verder.
  3. Laat de geavanceerde OAuth-velden leeg en voeg geen request-headers toe.
  4. Klik op Toevoegen, vervolgens op Verbinden. Meld je aan bij ISMS Copilot en klik op Goedkeuren.

In een Claude Team- of Enterprise-organisatie voegt een Owner de connector één keer toe onder Organisatie-instellingen → Connectors (Toevoegen, vervolgens Aangepast, daarna Web). Elk lid vindt deze vervolgens onder Aanpassen → Connectors en klikt op Verbinden, waarbij ze inloggen met hun eigen ISMS Copilot-account. Niemand handelt namens iemand anders.

ChatGPT (aangepaste MCP-app)

ChatGPT verbindt via inloggen met de standaardinstellingen. ISMS Copilot staat niet in de app-directory van ChatGPT: voeg het zelf toe als aangepaste app.

  1. Zet in de instellingen van ChatGPT de ontwikkelaarsmodus aan (in recente versies staat die bij de app-instellingen). In Business- en Enterprise-werkruimtes moet een beheerder aangepaste MCP-apps mogelijk eerst toestaan.
  2. Maak een aangepaste app (ChatGPT noemt het mogelijk een connector), noem hem ISMS Copilot en plak het eindpunt hierboven als MCP-server-URL.
  3. Kies OAuth als authenticatie en laat de standaardinstellingen staan.
  4. Maak hem aan en verbind: meld je aan bij ISMS Copilot en klik op Goedkeuren.

De menunamen in ChatGPT verschillen per abonnement en versie. De actuele stappen van 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

Voer vervolgens /mcp uit in een sessie, kies ismscopilot, meld je aan en klik op Goedkeuren. Volledige handleiding: Verbind ISMS Copilot met Claude Code.

Cursor en Codex

Gebruik een persoonlijk toegangstoken: configuratievormen in Verbind Cursor en Codex. Ze kunnen ook verbinden via inloggen als de client MCP OAuth ondersteunt.

Elke andere client

Voeg een externe HTTP MCP-server toe met het bovenstaande eindpunt en een persoonlijk toegangstoken (sectie 3). Een client die MCP-inloggen ondersteunt, kan ook zonder token verbinden.

Wat je goedkeurt

De client kan je account, werkruimten, documenten (metadata), herinneringen en bedrijfsprofiel lezen; ISMS Copilot vragen en antwoorden lezen; je bedrijfsprofiel en herinneringen bijwerken, en werkruimten aanmaken. Het kan geen API-sleutels aanmaken of credits kopen. Wijzigingen die het aanbrengt, worden in ISMS Copilot gelabeld als Added by OAuth app: <name> of Updated by OAuth app: <name>, met de naam die de client heeft geregistreerd. Koppel het op elk moment los in Instellingen → Gekoppelde apps, onder Gekoppelde agents.

3. Persoonlijk toegangstoken

Voor Cursor, Codex en andere clients die niet inloggen, of voor CI en headless machines:

  1. Open in chat.ismscopilot.com Instellingen → Gekoppelde apps → Token aanmaken. Kopieer de pat-isms-…-waarde één keer.
  2. Voeg de server toe met de header Authorization: Bearer pat-isms-…. Claude Code:
claude mcp add --scope user --transport http ismscopilot \
  https://account.ismscopilot.com/v1/account/mcp \
  --header "Authorization: Bearer pat-isms-..."

Houd --scope user aan zodat de server in elke map beschikbaar is. Tokenconfiguraties voor Cursor en Codex: Verbind Cursor en Codex.

4. Modi (Fast, Think, Beyond)

create_conversation en send_message accepteren optionele mode:

modeBetekenis
fast (standaard)Normale antwoorden. Wordt gebruikt wanneer de agent mode weglaat.
thinkDiepgaandere redenering. Betaalde abonnementen.
beyondMeerstappenplan / opzet / verificatie. Betaalde abonnementen, 10 per UTC-dag (50 op Unlimited), tijdschaal van minuten. Poll get_reply ongeveer elke 10-20 seconden tot complete.

Een Fast- of Think-beurt die status: "generating" retourneert, is korter: poll get_reply ongeveer elke 2-5 seconden.

De verbinding kiest niet automatisch een modus op basis van de vraag. Vraag de agent om “use Beyond” te gebruiken wanneer je dat pad wilt. Details: Beyond-modus gebruiken.

5. Rooktest

Vraag de agent om je ISMS Copilot-werkruimten op te sommen. Als de tools niet verschijnen, start dan de client opnieuw na het toevoegen van de server, controleer of je de inlogprocedure hebt voltooid en op Goedkeuren hebt geklikt, of bevestig bij een token dat het niet is afgekapt bij het plakken.

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 tegen de limiet aanloopt, is de eerste foutmelding de wacht-of-upgradezin (inclusief het volgende reset-tijdstip) 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.

Wacht tot reset_at, of open upgrade_url in een browser terwijl je bent ingelogd met hetzelfde ISMS Copilot-account (solo-accounts en organisatie-eigenaren). 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), kun je de agent ook vragen 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). Leestools werken nog steeds na de chatlimiet.

Zie Wat te doen als je tegen je gebruikslimiet aanloopt.

6. Ontkoppelen of vervangen

Koppel een inlogverbinding los in Instellingen → Gekoppelde apps, onder Gekoppelde agents. Het volgende verzoek van die client wordt geweigerd totdat je opnieuw inlogt en goedkeurt.

Voor een token verwijder je de server en voeg je deze opnieuw toe met een nieuw token:

claude mcp remove ismscopilot

Trek altijd het oude token in via Instellingen als het mogelijk is gelekt.

Een verbinding handelt als jij. Keur alleen tools goed die je zelf hebt gestart, geef tokens alleen de benodigde scopes, en ontkoppel wat je niet meer gebruikt.

Op deze pagina