MCP Self-hosted installeren met Docker Compose

Om MCP Self-hosted te installeren download je de bundel voor je licentie via Mijn account → MCP Self-hosted, vul je het .env-bestand in en draai je ./mcp-update.sh. Het script logt in bij de containerregistry van AddoCore, pullt de image en start de container mcp-core. Hetzelfde commando regelt ook elke latere update.

Wat heb je nodig voordat je MCP Self-hosted installeert?

Je hebt een host nodig met Docker en Docker Compose (het commando docker compose), een bash-shell om het script te draaien en een actieve MCP Self-hosted-licentie. Node.js draait in de image, dus verder hoeft er niets op de host geïnstalleerd te worden. De container heeft uitgaand HTTPS nodig naar twee plekken: het licentie-endpoint van AddoCore en de containerregistry op registry.gitlab.com. Werkt je firewall met een allowlist, voeg dan beide toe voordat je begint.

Zonder licentie kun je MCP Self-hosted niet installeren. Op de productpagina van MCP Self-hosted staat wat MCP Self-hosted omvat.

Wat zit er in de zip waarmee je MCP Self-hosted installeert?

De zip wordt voor je licentie gegenereerd. Hij bevat geen broncode, alleen wat Docker nodig heeft om de gepubliceerde image te pullen en te draaien:

• docker-compose.yml: één service, mcp-core, met de image-tag uit MCP_VERSION.
• .env: vooraf ingevuld met je licentiesleutel, het licentie-endpoint, de auth-strategie, het token van je eerste seat en een blok lege variabelen per tool op je licentie.
• .env.registry: de alleen-lezen-credentials voor de containerregistry.
• mcp-update.sh: het installatie- en updatescript.
• README.md en INSTALL-CLAUDE-PLUGIN.md, plus de map claude-plugin/ met een kant-en-klare Claude Code-plugin.
• Lege mappen vault/, state/ en logs/ die in de container worden gemount.

Houd .env en .env.registry buiten versiebeheer. Beide bevatten geheimen.

Welke .env-waarden vul je in?

Het bovenste deel van .env is al ingevuld en blijft normaal gesproken zoals het is. Laat LICENSE_ENDPOINT op dit adres staan: vanaf versie 1.2.0 accepteert mcp-core alleen licentieantwoorden die AddoCore heeft ondertekend.

LICENSE_KEY=...
LICENSE_ENDPOINT=https://addocore.com/wp-json/mcpl/v1/check
AUTH_STRATEGY=apikey
BEARER_TOKEN=...
MCP_VERSION=<version in your bundle>
SEAT_ID=...
HOSTED_SECRETS_ENDPOINT=https://addocore.com/wp-json/mcpl/v1/secrets

Daaronder heeft elke tool op je licentie een eigen blok. Verplichte variabelen zijn lege regels, optionele staan als commentaar:

# Missive
MISSIVE_API_TOKEN=
# MISSIVE_MODE=
# MISSIVE_FROM_ADDRESS=

Vul de verplichte waarden voor elke tool in voordat je MCP Self-hosted installeert. De exacte variabelen per tool staan in de MCP-installatiehandleidingen. Je kunt ze hier ook leeg laten en later invullen op het tabblad Tools van je licentie in Mijn account; ze worden versleuteld opgeslagen en de draaiende container pikt ze op bij de volgende licentiecheck.

Wat doet ./mcp-update.sh?

Als je MCP Self-hosted installeert, voert het script vier stappen uit vanuit de map die je hebt uitgepakt:

1. Het leest .env.registry en draait docker login met --password-stdin, zodat het registry-token nooit in je shellgeschiedenis terechtkomt.
2. Het pullt de image voor de versie in MCP_VERSION.
3. Bestaat die versie niet in de registry (een typfout, of een oude versie die is opgeruimd), dan zet het MCP_VERSION=latest in .env en pullt opnieuw. Elke andere pullfout wordt ongewijzigd getoond en het script stopt.
4. Het start de container op de achtergrond.

cd /path/to/unzipped-bundle
chmod +x mcp-update.sh
./mcp-update.sh

De container heet mcp-core, herstart automatisch tenzij je hem stopt, heeft een geheugenlimiet van 128 MB en luistert op 127.0.0.1:3200. Alleen de host zelf kan die poort bereiken. Wil je hem vanaf andere machines bereiken, zet er dan een reverse proxy met HTTPS voor.

Hoe controleer je de licentie nadat je MCP Self-hosted hebt geïnstalleerd?

Lees de containerlogs. Bij het starten print mcp-core een samenvatting en controleert daarna zijn licentie bij AddoCore:

docker logs -f mcp-core

Zoek naar de regel HTTP/MCP: http://localhost:3200/mcp en een regel die begint met Check OK, gevolgd door valid=true en de entitlements op je licentie, bijvoorbeeld tool:missive. De allereerste samenvatting kan Active tools: (none entitled) tonen, omdat de licentiecheck net na het starten van de server draait. Zonder AI-client kun je dezelfde informatie als JSON opvragen:

curl http://localhost:3200/health

Het antwoord bevat status, de transports, de auth-strategie, de licentiestatus en de id’s van de actieve tools. Meldt de licentieregel een fout, controleer dan eerst LICENSE_KEY en LICENSE_ENDPOINT.

Hoe werk je mcp-core bij?

Draai ./mcp-update.sh opnieuw vanuit de map waarmee je MCP Self-hosted hebt geïnstalleerd. Het pullt de versie waar MCP_VERSION naar wijst en herstart de container. Je .env, vault, state en logs staan op de host, dus die worden niet aangeraakt. MCP_VERSION staat standaard vast op de versie in je bundel, dus gewoon opnieuw draaien geeft je diezelfde versie terug. Zet hem op latest om altijd de nieuwste release te krijgen, of op een specifiek versienummer om vast te zetten of terug te draaien.

Wat verandert er als je later een add-on koopt?

Niets op schijf. Elke tool zit al in de image; een add-on voegt alleen een entitlement toe aan je licentie. Je krijgt een e-mail met de variabelen die de tool nodig heeft. Vul ze in in .env of onder Inloggegevens en haal de nieuwe entitlement direct op:

docker exec mcp-core npm run refresh-license

Zonder dat commando komt de wijziging binnen met de volgende geplande check, binnen 72 uur.

En de Claude Code-pluginbundel?

De map claude-plugin/ is al ingesteld op http://localhost:3200/mcp met het token uit .env. Claude verbinden met een MCP-server behandelt de twee installatiecommando’s en de configuratie voor Claude Desktop.

Welke fouten komen vaak voor bij het installeren van MCP Self-hosted?

• Het script vanuit een andere map draaien. Het leest ./.env.registry, dus draai het vanuit de bundelmap.
• De image met de hand pullen. De registry vereist eerst een login; het script doet dat voor je.
• Poort 3200 is op de host al in gebruik. Stop de andere service of verander de hostkant van de poortmapping.
• Een tweede installatie op dezelfde licentie. MCP Self-hosted bevat één activatie; een tweede container krijgt de melding dat de licentie het maximale aantal actieve installaties heeft bereikt. Geef de oude vrij op het tabblad Geavanceerd.

Met deze stappen installeer je MCP Self-hosted één keer en werk je het bij met hetzelfde script. Stel daarna je MCP-seats in, zodat elke persoon of elk apparaat een eigen token krijgt.