MCP-diagnostiek: wat MCP Self-hosted verstuurt en toont

MCP-diagnostiek is de gebruikssamenvatting die mcp-core bij elke licentiecheck meestuurt: versie, platform, actieve tools en het aantal aanroepen en fouten. Er zit niets in van de data die je tools lezen of schrijven. Op je eigen server tonen de tool mcp_status, het endpoint /health en de containerlogs dezelfde status in meer detail.

Wat stuurt mcp-core mee bij elke licentiecheck?

Elke check is één HTTPS-POST naar AddoCore met drie velden in de body: je license_key, de instance_id van deze installatie en een payload met de MCP-diagnostiek. Het verzoek wordt ondertekend met HMAC-SHA256 in de headers X-MCPL-Timestamp, X-MCPL-Nonce en X-MCPL-Signature. TLS beschermt de inhoud onderweg; de handtekening bewijst dat het verzoek van jouw licentie komt en niet opnieuw is afgespeeld.

De payload bevat precies deze velden:

• mcp_version: de draaiende versie van mcp-core
• node_version en os: de Node.js-versie in de image en het platform
• install_type: docker bij een standaardinstallatie
• auth_strategy: apikey of oauth
• active_tools: de tool-id’s waarop deze installatie recht heeft, zoals missive of woocommerce
• uptime_hours: hoe lang het proces al draait
• tool_calls_since_last_check: een telling per toolnaam
• error_counts: mislukte aanroepen per toolnaam
• last_error_codes: de 10 meest recente foutcodes
• seat_usage: dezelfde aanroep- en fouttellingen per seat, op basis van een interne id

Wat zit er nooit in MCP-diagnostiek?

MCP-diagnostiek bevat nooit de inhoud die je tools aanraken. Geen vaultnotities, geen databaserijen, geen tekst van e-mails of Missive-berichten, geen WordPress- of WooCommerce-content. Ook uitgesloten: API-tokens, hostnamen, IP-adressen, querytekst en prompts.

Ook labels van seats blijven weg. Het label dat je in Mijn account typt, zoals “Laptop Anna”, is vrije tekst, dus de uitsplitsing per seat gebruikt alleen de nietszeggende seat_id die AddoCore heeft uitgegeven. Er staat dan “seat nummer twee deed 14 aanroepen naar missive_list_conversations“, meer niet.

De foutcodes zijn korte markeringen, geen meldingen. Een geblokkeerde aanroep wordt vastgelegd als license_blocked, een afgeremde aanroep als rate_limited, een tool die een fout teruggaf als tool_error, en een exception als de foutcode of naam ervan.

Wanneer worden de tellers van MCP-diagnostiek gereset?

De tellers worden gereset na elke geslaagde licentiecheck, dus elke payload beslaat de periode sinds de vorige goede check, normaal 72 uur. Een mislukte check reset niets. De volgende geslaagde check bevat de tellingen voor de hele tussenliggende periode. De ingebouwde tool mcp_status wordt helemaal niet meegeteld.

Hoe lang bewaart AddoCore MCP-diagnostiek?

AddoCore bewaart elke check met de payload maximaal 90 dagen. Een dagelijkse taak telt die op tot dagtotalen, en ruwe checks die ouder zijn worden verwijderd. Het activatierecord bewaart de instance-id, de mcp-core-versie, het tijdstip van de laatste check en een SHA-256-hash van het IP-adres van het verzoek, nooit het adres zelf.

Met deze gegevens kan support vragen beantwoorden als “welke versie draait deze klant” of “welke tool faalt steeds” zonder toegang tot je server. Een WordPress-verzoek om persoonsgegevens te exporteren of te wissen omvat ook je MCP-licenties.

Hoe lees je MCP-diagnostiek op je eigen server?

Drie lokale bronnen geven je meer detail dan de payload. Geen ervan verlaat je server.

De tool mcp_status werkt in elke licentiestatus. Vraag Claude om hem uit te voeren. Hij toont de mcp-core-versie en of er een nieuwere is, de licentiestatus met eventuele melding, de datum Valid until, en de entitlements en toolmodi van de seat die je gebruikt.

Het endpoint /health heeft geen token nodig:

curl http://127.0.0.1:3200/health

Het geeft JSON zoals dit terug:

{"status":"ok","transports":["streamable-http","sse-legacy"],"authStrategy":"apikey","license":{"state":"valid","allowed":true},"activeTools":["missive","woocommerce"]}

De containerlogs tonen elke check en elke geregistreerde tool:

docker logs mcp-core

Zoek naar regels als Check OK valid=true status=active entitlements=core,tool:missive of Registered 'missive' … license=valid callsAllowed=true. Tools schrijven ook een dagelijkse actielog naar ./logs, één markdownbestand per dag.

Hoe helpt MCP-diagnostiek bij probleemoplossing?

Vergelijk het lokale beeld met wat je verwacht. Is activeTools leeg, dan heeft de licentie nog geen tool-entitlements of is er nog geen check geslaagd. Heeft een tool wel een entitlement maar ontbreekt hij in Claude, dan noemt de log de ontbrekende variabele, bijvoorbeeld een regel dat er geen WooCommerce-winkel is ingesteld. Is de licentiestatus grace of expired, dan heeft de server AddoCore niet bereikt; zie Respijtperiode van de licentie. Specifieke meldingen staan bij MCP-foutcodes.

MCP-diagnostiek blijft bewust klein: tellingen en versies aan onze kant, alle details in je eigen logs. Lees daarna MCP-licentiebeheer om de seats achter de tellingen per seat te beheren.