MCP-seats: tokens, tools en modi

MCP-seats zijn de identiteiten die verbinding maken met je draaiende mcp-core-server. Elke seat heeft een eigen token, een eigen selectie van de tools op je licentie en per tool een eigen modus: read-only of read-write. Een MCP Self-hosted-licentie bevat er drie. Je beheert ze via Mijn account → MCP Self-hosted, op het tabblad Seats van je licentie.

Wat is een MCP-seat, en wat niet?

Een seat is één persoon, apparaat of service die met je server praat: Claude Desktop op een laptop, Claude Code op een buildmachine, een automatisering. Het is geen installatie. Een installatie is een activatie, en MCP Self-hosted bevat er één. Eén container kan alle MCP-seats op de licentie bedienen; elk verzoek wordt geauthenticeerd tegen één ervan en krijgt de toollijst van die seat. Elke seat heeft ook een eigen rate limit: standaard 60 toolaanroepen per minuut per add-on.

Waar beheer je MCP-seats?

Open Mijn account → MCP Self-hosted en kies het tabblad Seats van de licentie. De tabel heeft vier kolommen:

• Label: de naam die je de seat gaf.
• Tools: de entitlements die deze seat mag gebruiken.
• Token: het token zelf, met een kopieerknop.
• Acties: Regenerate token en Revoke.

Een licentie zonder seats toont “No seats yet.” In de praktijk zie je er altijd minstens één: bij het bouwen van je download wordt een seat “Default install” aangemaakt met alle tools op de licentie en de standaardmodus per tool. Het token daarvan wordt ook weggeschreven naar BEARER_TOKEN in .env en naar de Claude Code-plugin in claude-plugin/.mcp.json.

Hoe voeg je MCP-seats toe?

Gebruik het formulier onder de tabel:

1. Vul een Label in, bijvoorbeeld “Claude Desktop” of “Supportlaptop”.
2. Vink de tools aan die deze seat mag gebruiken. Alleen tools op je licentie staan in de lijst.
3. Kies read-only of read-write naast elke aangevinkte tool.
4. Klik op Add seat en kopieer het nieuwe token uit de tabel.

Is het maximum bereikt, dan maakt het formulier plaats voor “You have reached the maximum number of seats for this license.” Een extra seat kost € 18,15 excl. btw: € 15,00 per jaar. Pas de nieuwe seat daarna toe op je draaiende server:

docker exec mcp-core npm run refresh-license

Welke tools en modus krijgt een seat?

Geef elke seat alleen wat die persoon of dat proces nodig heeft. Wie klantmail beantwoordt, heeft Missive nodig, in read-write als Claude antwoorden moet versturen. Een developer die data controleert, heeft Database in read-only nodig. Smalle MCP-seats zijn overzichtelijker en makkelijker in te trekken.

Modi per tool:

• Read-only is de standaard voor elke tool behalve Brain, die standaard op read-write staat.
• In read-only-modus worden schrijftools helemaal niet geregistreerd. Bij Database blijft de querytool beschikbaar, maar schrijfstatements worden geweigerd.
• Lightspeed eCom heeft in geen enkele modus schrijftools.

De volledige logica staat bij entitlements vs. toolmodi.

Hoe vernieuw of trek je een token in?

Beide acties staan in de kolom Acties en vragen eerst om bevestiging.

• Regenerate token maakt een nieuw token voor dezelfde seat. De bevestiging meldt dat het huidige token stopt met werken zodra mcp-core de wijziging oppikt, bij de volgende licentiecheck of direct na docker exec mcp-core npm run refresh-license, en dat je het token moet bijwerken overal waar de seat gebruikt wordt.
• Revoke verwijdert de seat. Andere seats op de licentie blijven werken.

De draaiende server bewaart de MCP-seats uit zijn laatste licentiecheck. Draai na een vernieuwing of intrekking het refresh-commando, zodat de server die nu toepast en niet pas bij de volgende geplande check. Vernieuw je “Default install”, werk dan ook BEARER_TOKEN in .env en de Authorization-header in claude-plugin/.mcp.json bij en draai ./mcp-update.sh opnieuw.

Wanneer gaan wijzigingen in MCP-seats in?

Wijzigingen gaan in bij de volgende automatische licentiecheck, binnen 72 uur, of direct als je docker exec mcp-core npm run refresh-license draait. Het tabblad Details van je licentie zegt hetzelfde. Een herstart of nieuwe download is niet nodig: de server bouwt de toollijst per verzoek op, dus het eerste verzoek na de refresh gebruikt al de nieuwe tools en modi.

Wat zijn winkels en sites?

WooCommerce, WordPress en Lightspeed eCom kunnen met meer dan één winkel of site praten. Die extra winkels stel je in op het tabblad Tools met Winkel toevoegen; de credentials daar worden gedeeld door alle seats op de licentie. Elke rij op het tabblad Seats krijgt dan een keuzelijst met de winkels, en een knop Save selection. Een zelf gehoste mcp-core gebruikt alleen de winkels die zijn aangevinkt bij de seat waarvan de SEAT_ID in .env staat, normaal “Default install”, en elke seat op die container bereikt diezelfde winkels. Vinkjes bij andere seats beperken die niet. Vink minstens één winkel aan bij “Default install”, anders krijgt de container geen winkels uit het portaal. Haal ze niet door elkaar: een winkel is een doelsysteem, een seat is een clientidentiteit.

Hoe controleer je wat een seat ziet?

Maak verbinding met het token van die seat en vraag Claude om mcp_status uit te voeren. Dat toont de licentiestatus en de tools en modi van de aanroepende seat. De containerlog schrijft ook per seat een regel voor elke tool die geregistreerd of overgeslagen wordt, met de reden.

Richt MCP-seats in per persoon of apparaat en je kunt toegang afbakenen, vernieuwen en intrekken zonder de server aan te raken. Koppel Claude daarna aan de server met het nieuwe token, of lees hoe tokens gecontroleerd worden bij MCP-authenticatie. Het add-onmodel van MCP Self-hosted legt uit hoe seats zich verhouden tot activaties.