Tokens, scopes en beveiliging

Hoe inlogverbindingen (OAuth) en pat-isms tokens werken: wat elk kan doen, scopes, verbreken, vervaldatum en harde limieten.

Een MCP-client fungeert als uw gebruiker op één van twee manieren: u meldt zich aan en keurt deze goed (OAuth, de standaard), of u geeft deze een persoonlijk toegangstoken met beperkingen op basis van de geselecteerde scopes.

Inloggen (OAuth)

Wanneer u https://account.ismscopilot.com/v1/account/mcp toevoegt aan een client zonder header, vraagt de client u om in te loggen bij ISMS Copilot. De toestemmingspagina toont het adres waar de resultaten naartoe gaan en de naam die de app aan zichzelf heeft gegeven. Keur alleen goed als u de verbinding zelf vanuit uw eigen AI-tool bent gestart.

Eén Goedkeuren verleent één vastgelegde set:

Kan	Scopes
Uw account, werkruimten, documenten (metadata), herinneringen en bedrijfsprofiel lezen	`account:read`, `workspaces:read`, `documents:read`, `memories:read`, `company_context:read`
Vragen stellen aan ISMS Copilot en antwoorden lezen	`conversations:create`
Uw bedrijfsprofiel en herinneringen bijwerken, en werkruimten aanmaken	`company_context:write`, `memories:write`, `workspaces:write`

Een inlogverbinding kan nooit API-sleutels aanmaken, weergeven of intrekken, en kan nooit API-credits controleren of kopen. Dat blijft alleen mogelijk met tokens. De antwoorden bevatten ook nooit upgrade- of aankoopvelden zoals upgrade_url of extra_usage_buyable.

Wijzigingen die een aangemelde app maakt, worden in ISMS Copilot gelabeld met de naam die de app heeft geregistreerd: Added by OAuth app: <name> bij herinneringen, Updated by OAuth app: <name> bij uw bedrijfsprofiel en werkruimten. De naam wordt gekozen door de app zelf, dus behandel deze als een hint, niet als bewijs. Een latere wijziging vanuit de web-app of een token overschrijft het label.

Verbinding verbreken: Instellingen → Gekoppelde apps, onder Gekoppelde agents. De volgende oproep van die app wordt geweigerd en het refreshtoken stopt met werken. Om opnieuw te verbinden, meldt u zich aan en keurt u opnieuw goed.

Persoonlijke toegangstokens (fallback)

Gebruik een token voor een client die niet kan inloggen, voor CI en headless machines, of wanneer u een beperktere set scopes wilt dan de inlogprocedure verleent.

Voorvoegsel en levenscyclus

Stap	Gedrag
Aanmaken	Instellingen → Gekoppelde apps → Token aanmaken
Weergeven	Volledig geheim wordt één keer getoond; begint met `pat-isms-`
Opslaan	Alleen in clientconfiguratie; nooit committen naar git
Intrekken	Dezelfde Instellingen-pagina; treedt onmiddellijk in werking
Vervaldatum	Optioneel bij aanmaken

Scopes (typisch)

Exacte labels in de UI kunnen licht variëren; de bedoeling is:

Account

Mogelijkheid	Lezen	Schrijven / actie
Accountinformatie	ja	nee
Werkruimten	lijst (`workspaces:read`)	persoonlijke werkruimten aanmaken met `create_workspace` (`workspaces:write`)
Documenten	alleen metadata weergeven (geen get-by-ID tool)	nee
Herinneringen	ja	aanmaken / bewerken indien toegestaan
Bedrijfscontext	`get_company_context` (`company_context:read`)	`set_company_context` (`company_context:write`), een volledige vervanging van het profiel
Conversaties	n.v.t.	starten en verzenden indien toegestaan

Model API (Groep Gekoppelde apps)

Scope	Doel
`api_keys:read`	Metadata van `sk-isms` sleutels weergeven (geen geheimen)
`api_keys:write`	`sk-isms` sleutels aanmaken / intrekken via MCP
`api_credits:read`	Voorafbetaald API-creditsaldo lezen
`api_credits:checkout`	Een Stripe Checkout-URL aanmaken voor bijvullen (een persoon betaalt in de browser)

Deze scopes laten een pat-isms niet toe om inferentie uit te voeren. De orchestrator gebruikt nog steeds een aparte sk-isms sleutel voor api.ismscopilot.com. Zie Opzetten vanuit Claude Code of Grok.

Verleen de minimale set voor de taak van de orchestrator. Een alleen-lezen werkruimtetoken kan geen conversaties starten.

Harde limieten (by design)

Aanmaken van werkruimten is alleen persoonlijk en gebudgetteerd. Een door een orchestrator aangemaakte werkruimte wordt niet gedeeld met uw team, erft niet de Advanced Data Protection van uw organisatie en is beperkt tot 10 nieuwe werkruimten per 24 uur (elke aanmaak telt mee, inclusief die via de web-app en de starterwerkruimte van een nieuw account). Stel persona, instructies en teamdeling in via de web-app.
Schrijfacties voor bedrijfscontext zijn een volledige vervanging. set_company_context overschrijft het hele profiel met de velden die u doorgeeft (bedrijfsnaam, sector, schaal, hoofdkantoorland, privacyrol, gegevenstypen, hostingregio, technologiestack, notities); een leeg object wist het. Lees het eerst met get_company_context als u slechts één veld wilt wijzigen.
Beyond is beschikbaar wanneer de orchestrator mode: "beyond" doorgeeft (Fast is de standaard). Betaalde abonnementen, 10 runs per UTC-dag (50 op Unlimited). Zie Beyond-modus gebruiken.
Advanced Data Protection kan niet worden in- of uitgeschakeld via het token. De orchestrator kan de status rapporteren; u wijzigt deze in Instellingen → Gegevensbescherming.
Snelheidslimieten zijn van toepassing (in de orde van ~120 verzoeken/minuut per token; gelijktijdige conversaties zijn beperkt per account). Als u tegen limieten aanloopt, vertraag dan en probeer opnieuw.
pat-isms alleen voert geen model-API-aanvullingen uit. Model API-tools maken sk-isms aan en openen credit checkout; Embed partnerfacturering blijft gescheiden.

Beveiligingschecklist

Geef tokens een naam op basis van apparaat of doel (claude-laptop, cursor-ci).
Geef de voorkeur aan korte vervaldatum voor tijdelijke machines.
Trek tokens in wanneer een laptop verloren gaat of een CI-geheim roteert.
Plaats nooit pat-isms-… in publieke repositories, schermafbeeldingen of supporttickets.

Gebruik telt mee voor uw normale chatabonnement en abonnementslimieten, niet voor voorafbetaalde API-credits. Uw orchestrator leest elk teruggestuurd antwoord als invoer, dus de antwoordtekst telt ook mee voor de context en het gebruik van de aanroepende tool zelf.

Tokens, scopes en beveiliging

Op deze pagina