MCP Self-hosted-download en inhoud van de zip

De MCP Self-hosted-download is een zip die voor één licentie gebouwd wordt, via Mijn account → MCP Self-hosted → Download. Hij bevat docker-compose.yml, een vooraf ingevulde .env, .env.registry, mcp-update.sh, een README en een Claude Code-pluginbundel. Je hebt hem één keer nodig, voor de eerste installatie. Voor add-ons en updates is geen nieuwe nodig.

Waar haal je de MCP Self-hosted-download?

De downloadknop staat naast de licentiesleutel op Mijn account → MCP Self-hosted. Hij verschijnt alleen zolang de licentie actief is. De knop linkt naar een ondertekende URL die 24 uur geldig is; elke keer dat de pagina laadt, wordt er een nieuwe aangemaakt. Het bestand heet mcp-core- gevolgd door je licentiesleutel en .zip.

De zip wordt op de achtergrond gebouwd en per licentie, entitlementset en versie gecachet. Als een build klaar is, krijg je de e-mail “Your MCP bundle for license … has finished building and is ready to download” met een knop Download now.

In plaats van het bestand kunnen drie meldingen verschijnen:

• “This download link is invalid or has expired.” (HTTP 403): de link is ouder dan 24 uur. Herlaad de pagina Licenties en klik opnieuw op Download.
• “This license is not currently active.” (HTTP 403): de licentie is opgeschort of verlopen. Zie MCP-licentie verlengen.
• “The download is not ready yet. Please try again shortly.” (HTTP 404): de build loopt nog. Wacht op de e-mail.

Wat zit er in de MCP Self-hosted-download?

De MCP Self-hosted-download bevat geen broncode. Elke tool zit al in de mcp-core-image; je licentie-entitlements bepalen welke er laden. De zip bevat:

• docker-compose.yml: één service, mcp-core, met de image uit de AddoCore-registry met tag ${MCP_VERSION}. Hij publiceert poort 3200 alleen op 127.0.0.1, mount ./vault, ./state en ./logs, beperkt het geheugen tot 128 MB en herstart tenzij je hem stopt.
• .env: je licentie-instellingen en lege regels voor de add-onvariabelen.
• .env.registry: REGISTRY_USER en REGISTRY_TOKEN, de alleen-lezen-login voor de imageregistry.
• mcp-update.sh: logt in, haalt de image op en start de container.
• README.md: een korte snelstart.
• claude-plugin/ en INSTALL-CLAUDE-PLUGIN.md: een kant-en-klare Claude Code-plugin die naar deze installatie wijst.
• lege mappen vault/, state/ en logs/ voor de mounts.

Wat staat er in de .env van de MCP Self-hosted-download?

De .env is ingevuld, behalve de add-onvariabelen. Voor een licentie met Missive ziet hij er zo uit:

# Generated by AddoCore — do not commit this file.
LICENSE_KEY=<your license key>
LICENSE_ENDPOINT=<pre-filled>
AUTH_STRATEGY=apikey
BEARER_TOKEN=<token of the "Default install" connection>
MCP_VERSION=<version in this bundle>
SEAT_ID=<id of that connection>
HOSTED_SECRETS_ENDPOINT=<pre-filled>

# Missive
MISSIVE_API_TOKEN=
# MISSIVE_MODE=
# MISSIVE_FROM_ADDRESS=

Verplichte variabelen zijn lege regels; optionele staan uitgecommentarieerd. Vul de verplichte waarden in, of laat ze leeg en vul ze in op het tabblad Tools van de licentie. De volledige installatie staat bij mcp-core installeren, en het koppelen van een client bij Claude koppelen aan een MCP-server.

Wanneer heb je een nieuwe MCP Self-hosted-download nodig?

Een nieuwe MCP Self-hosted-download heb je maar in een paar gevallen nodig:

• de eerste installatie van een licentie
• een nieuwe server waarnaar je de oude installatiemap niet kopieert
• een kwijtgeraakt .env-bestand

Je hebt er geen nodig als je:

• een add-on koopt: die wordt aan de licentie toegevoegd en je krijgt een e-mail met de variabelen die hij nodig heeft. Zet ze in .env of op het tabblad Tools en draai docker exec mcp-core npm run refresh-license, of wacht op de volgende check.
• bijwerkt naar een nieuwe versie: draai ./mcp-update.sh.
• credentials wijzigt of een seat toevoegt: dat doe je in Mijn account.

Een verse download heeft een lege map state/. Op een nieuwe server betekent dat een nieuwe instance-id en een nieuwe activatie. Verhuis je van server, kopieer dan de hele map inclusief ./state om de bestaande activatie te behouden.

Hoe werken updates zonder nieuwe download?

Draai het updatescript vanuit de installatiemap:

./mcp-update.sh

Het logt in op de registry met .env.registry, haalt de imagetag uit MCP_VERSION op en start de container. MCP_VERSION staat vast op de versie van je MCP Self-hosted-download, dus het script opnieuw draaien springt nooit onverwacht naar een nieuwere release. Zet hem op latest om altijd de nieuwste release te volgen, of op een specifiek nummer om terug te gaan.

Bestaat de tag niet meer, dan valt het script terug op latest en schrijft dat in .env. Elke andere fout bij het ophalen wordt ongewijzigd getoond en het script stopt. De tool mcp_status meldt wanneer er een nieuwere versie is, dus de MCP Self-hosted-download blijft een eenmalige stap.

Wat doe je als de registry-login vernieuwd is?

AddoCore vernieuwt het registrytoken af en toe. Je krijgt dan de e-mail “Your MCP registry login has been renewed” met een vernieuwde .env.registry als bijlage. Vervang je bestaande bestand door de bijlage en draai ./mcp-update.sh om te bevestigen dat de nieuwe login werkt. Je draaiende installatie blijft intussen werken; docker-compose.yml en .env blijven zoals ze zijn.

Hoe installeer je de Claude Code-plugin uit de MCP Self-hosted-download?

Draai vanuit de installatiemap deze twee commando’s in Claude Code:

/plugin marketplace add ./claude-plugin
/plugin install mcp-core@claude-plugin

Het token in claude-plugin/.mcp.json is het token dat geldig was toen de zip gebouwd werd. Vernieuw je het token van die seat, werk dan ook de Authorization-header in dat bestand bij. Gratis skills zijn een aparte download onder Mijn account → Skills en hebben geen licentie nodig.

Bewaar de map van je MCP Self-hosted-download, vooral .env en ./state, en je hebt de downloadknop zelden nog nodig. Lees daarna MCP-licentiebeheer om seats en credentials vanuit je account te beheren.