MCP-beheer
MCP-beheer omvat alles na de eerste installatie van mcp-core: de licentie in Mijn account, seats en activaties, jaarlijkse verlengingen via Mollie, de diagnostiek die elke licentiecheck meestuurt en de foutmeldingen die je ziet als er iets misgaat. Deze sectie bundelt de naslagpagina’s voor die taken.
Wat houdt MCP-beheer in?
MCP-beheer gebeurt op twee plekken: Mijn account op addocore.com en de shell van de server waarop mcp-core draait. De website bevat de licentie, de seats met hun tokens, de credentials van add-ons en de facturatie. De server bevat de draaiende container, het bestand .env en een lokale licentiecache in de map ./state.
De twee kanten communiceren via één kanaal: de licentiecheck. Je server roept AddoCore aan, nooit andersom. Daarom verschijnen de meeste wijzigingen die je in Mijn account maakt pas na de volgende check op de server, niet op het moment dat je op Opslaan klikt.
Waar beheer je je MCP-licentie?
Onder Mijn account → MCP Self-hosted. Elke zelf gehoste licentie toont de licentiesleutel, een downloadknop en vijf tabbladen: Overzicht, Tools, Seats, Add-ons en Geavanceerd. Het tabblad Add-ons verschijnt alleen als add-ons op die licentie gewijzigd kunnen worden.
Ook andere delen van Mijn account zijn van belang voor beheer:
- Abonnementen toont elke terugkerende regel en bevat de instelling voor automatische facturatie (kaart of SEPA-incasso).
- Opties bevat de e-mailmeldingen over licenties: verlengherinneringen, mislukte betalingen en mislukte licentiechecks.
- Skills toont de gratis skill-downloads, waarvoor geen licentie nodig is.
- MCP Hosted verschijnt alleen als je een MCP Hosted-seat gebruikt in plaats van een zelf gehoste installatie.
De volledige uitleg van elk tabblad staat in de handleiding licentiebeheer hieronder.
Hoe blijft mcp-core in sync met je account?
mcp-core controleert zijn licentie bij het opstarten en daarna elke 72 uur, nooit vaker. Elke check levert de entitlements (welke tools mogen laden), de seats met hun tokens en toolmodi, en de nieuwste uitgebrachte versie. De server bewaart het laatste goede antwoord op schijf.
Om een wijziging direct toe te passen in plaats van tot 72 uur te wachten, draai je:
docker exec mcp-core npm run refresh-license
Dat stuurt een signaal naar het mcp-core-proces, dat dan een gewone check tegen hetzelfde endpoint uitvoert. Geen herstart en geen nieuwe download. Eén uitzondering: wijzigen add-on-credentials op het tabblad Tools, dan herstart de container zichzelf na de check om de nieuwe waarden te laden.
Welke beheertaken lopen vanzelf?
Een groot deel van MCP-beheer vraagt niets van jou:
- de licentiecheck bij het opstarten en elke 72 uur
- de respijtperiode van 96 uur als je server AddoCore niet kan bereiken
- de jaarlijkse verlengbetaling via Mollie, met een herinneringsmail 30 dagen vooraf
- het vrijgeven van activaties die zich 30 dagen niet gemeld hebben
Deze taken vragen jou:
- seats toevoegen of intrekken, en een token vernieuwen na een lek
- de betaalmethode bijwerken na een mislukte verlenging
.env.registryvervangen na een e-mail over een vernieuwde registry-login./mcp-update.shdraaien als je een nieuwe versie wilt
Wat staat er in de handleidingen voor MCP-beheer?
Elke handleiding in deze sectie beantwoordt één vraag:
- MCP-licentiebeheer: de pagina Licenties, seats, tokens, credentials, add-ons en activaties.
- Entitlements vs. toolmodi: welke tools überhaupt laden, en welke read-only of read-write draaien.
- Respijtperiode van de licentie: wat er gebeurt als een licentiecheck mislukt, en de licentiestatussen die mcp-core gebruikt.
- MCP-licentie verlengen: verlengingen via Mollie, Payment issue, Suspended, opzeggen.
- MCP-diagnostiek: wat elke check verstuurt, en hoe je
mcp_statusen/healthleest. - MCP Self-hosted-download: de inhoud van de zip, wanneer je een nieuwe download nodig hebt, vernieuwing van het registrytoken.
- MCP-foutcodes: antwoorden op licentiechecks, HTTP-statuscodes en toolfouten.
Welke commando’s gebruik je het meest voor MCP-beheer?
Vier commando’s dekken het meeste dagelijkse MCP-beheer op de server. Draai ze vanuit de map met docker-compose.yml:
./mcp-update.sh
docker exec mcp-core npm run refresh-license
docker logs mcp-core
curl http://127.0.0.1:3200/health
./mcp-update.sh logt in op de AddoCore-registry, haalt de versie op die in MCP_VERSION staat en start de container. Het refresh-commando forceert een licentiecheck. docker logs toont de licentie- en registryregels, bijvoorbeeld Check OK valid=true status=active. Het endpoint /health heeft geen token nodig en geeft de licentiestatus en de actieve tools als JSON terug.
Waar begin je met MCP-beheer als er iets niet meer werkt?
Vraag Claude eerst om de tool mcp_status uit te voeren. Die is ingebouwd in mcp-core, heeft geen entitlement nodig en blijft werken terwijl de licentie alle andere tools blokkeert. Hij meldt de draaiende versie, de licentiestatus, de datum Valid until, de entitlements en toolmodi van de seat die je gebruikt, en of er een nieuwere versie is.
Toont de status een melding die je niet kent, zoek die dan op in de handleiding over foutcodes hierboven. Ontbreekt een tool in de lijst, controleer dan eerst de entitlements van die seat en daarna de containerlogs op een regel dat de tool niet is ingesteld.
Het meeste MCP-beheer komt neer op drie gewoontes: bewaar de map ./state als je van server verhuist, houd de betaalmethode actueel en draai een refresh nadat je iets in Mijn account hebt gewijzigd. Open als volgende stap de handleiding licentiebeheer om elk tabblad van de pagina Licenties te zien.