Entitlements vs. toolmodi

Entitlements vs. toolmodi komt neer op twee losse vragen. Een entitlement bepaalt of een tool überhaupt op je server bestaat. Een toolmodus bepaalt wat een geladen tool mag: alleen lezen, of ook schrijven. Je hebt beide nodig: een entitlement zonder read-write-modus geeft leestoegang, en read-write-modus zonder entitlement geeft niets.

Wat is een entitlement?

Een entitlement is een licentierecht voor één tool-add-on, zoals tool:missive, tool:woocommerce, tool:database, tool:brain, tool:wordpress of tool:lightspeed. mcp-core ontvangt de lijst van AddoCore bij het opstarten en bij elke licentiecheck. Je krijgt een entitlement door de add-on te kopen; je ziet de lijst op het tabblad Overzicht van je licentie in Mijn account → MCP Self-hosted.

Entitlements werken op twee niveaus. De licentie heeft de volledige set. Elke seat krijgt een deel daarvan, dat je kiest door tools aan te vinken op het tabblad Seats. Komt er een verzoek binnen, dan registreert de server alleen de tools waarop de aanroepende seat recht heeft. Een tool buiten dat deel wordt niet verborgen of geblokkeerd; hij staat gewoon niet in de toollijst, wat je ook in .env zet.

Wat is een toolmodus?

Een toolmodus is read-only of read-write, ingesteld per tool per seat. In read-only-modus worden de schrijftools van een add-on niet geregistreerd, dus Claude kan ze niet aanroepen en ziet ze niet eens. Voorbeelden:

• Missive read-only toont en leest gesprekken; read-write voegt berichten versturen, taken aanmaken en contacten bijwerken toe.
• WooCommerce read-write voegt orderstatus bijwerken, ordernotities en voorraadupdates toe.
• WordPress read-write voegt content aanmaken en bijwerken, media-uploads en reactiemoderatie toe.
• Database houdt de querytool in beide modi, maar in read-only-modus worden schrijfstatements geweigerd.

Wat zijn de standaardmodi?

Read-only is de standaard voor elke tool behalve Brain. Brain staat standaard op read-write. Met het optionele git-versiebeheer (VERSIONING_ENABLED) is een schrijfactie nooit een onherstelbare overschrijving. Lightspeed eCom is een uitzondering de andere kant op: het heeft helemaal geen schrijfcode, dus het is in elke modus read-only.

Entitlements vs. toolmodi: waar stel je ze in?

Elk wordt op een andere plek ingesteld, en daarom haal je entitlements en toolmodi makkelijk door elkaar.

• Entitlements: door een add-on te kopen of te verwijderen, op het tabblad Add-ons van je licentie of in de shop. Per seat door tools aan te vinken op het tabblad Seats.
• Toolmodi: per seat, met de keuze read-only/read-write naast elke tool op het tabblad Seats.

Elke tool heeft ook een variabele <TOOL>_MODE, zoals MISSIVE_MODE of DB_MODE. Op een licentie met seats, en dat heeft elke huidige licentie, gebruikt de server de modus van de seat, en de standaard van de tool als een seat er geen heeft. Stel de modus in op het tabblad Seats, niet in .env.

Hoe zien de vier combinaties eruit?

De vergelijking tussen entitlements en toolmodi is het makkelijkst als raster:

• Wel entitlement, read-only: de tool staat in de lijst met alleen de leestools.
• Wel entitlement, read-write: de tool staat in de lijst met lees- en schrijftools.
• Geen entitlement, read-only: niets. De tool verschijnt niet.
• Geen entitlement, read-write: nog steeds niets. Een modus voegt nooit een tool toe waarvoor je geen licentie hebt.

Bij een database hoort de echte afdwinging ook in de database zelf: geef mcp-core een databasegebruiker met alleen SELECT-rechten. De Database MCP-setup laat zien hoe.

Waar past de geldigheid van de licentie in?

De geldigheid van de licentie is een derde laag, bovenop entitlements en toolmodi, en geldt voor de hele server. Is AddoCore niet bereikbaar, dan houdt een respijtperiode van 96 uur alle tools werkend. Is de licentie ingetrokken of blijft hij onbereikbaar na de respijtperiode, dan blijven tools met entitlement in de lijst staan, maar geeft elke aanroep een duidelijke foutmelding met de oorzaak. De ingebouwde tool mcp_status werkt in elke situatie. Zie Respijtperiode van de licentie voor de termijnen.

Wanneer gaan wijzigingen in?

Een wijziging aan entitlements of toolmodi bereikt de server bij de volgende licentiecheck, binnen 72 uur, of direct na:

docker exec mcp-core npm run refresh-license

Een herstart is niet nodig. De server bouwt de toollijst per verzoek op, dus het eerste verzoek na de refresh gebruikt de nieuwe set.

Hoe controleer je wat een seat krijgt?

Je kunt entitlements en toolmodi voor één seat op drie manieren controleren:

1. Vraag Claude om mcp_status uit te voeren. Dat toont de licentiestatus en de tools en modi van de aanroepende seat.
2. Draai curl http://localhost:3200/health. activeTools toont elke tool waarop minstens één seat op de licentie recht heeft.
3. Lees docker logs mcp-core. Per verzoek logt de server per tool en seat Registered met de modus, of Skipped met de reden.

Houd entitlements en toolmodi uit elkaar en toegang wordt voorspelbaar: koop wat het team nodig heeft en geef elke seat de smalste modus die werkt. Het add-onmodel van MCP Self-hosted gaat over licenties, en MCP-seats over de instellingen per seat.