MCP-servers

MCP (Model Context Protocol) is een open standaard waarmee een AI-assistent gereedschap van een ander systeem kan gebruiken. Wij bouwen MCP-servers voor onze eigen systemen en hosten ze zelf. Het team gebruikt ze vanuit Claude.

Drie servers zijn er voor het team. De eerste leest de inhoud van de website in Payload. De tweede bouwt mailreeksen en workflows in HubSpot. De derde geeft verkeers- en zoekcijfers uit BigQuery, met veertien vaste vragen. Zelf een zoekopdracht opstellen kan de AI daar niet.

De vierde is de onderhoudsmotor: één programma voor al het herhalende onderhoud aan een Payload-site. Hij kwam er omdat er 117 losse scripts stonden, bijna de helft gemaakt voor één klus. In de motor doet een taak pas iets als hij in het takenregister is aangemeld. De redactie bedient hem vanuit Claude Code.

De drie teamservers draaien sinds augustus 2026 op ons cluster. Op 24 augustus 2026 stonden er 26 mailreeksen als concept in HubSpot, geladen met de HubSpot-server: 233 mails en 52 workflows.

De onderhoudsmotor draait sinds september 2026 als MCP-server en telde op 27 september 27 taken. Hij werkt op jeleefstijlalsmedicijn.nl. Sinds 26 september 2026 is ook jlam.nl aangesloten, de site waar je nu op zit. Daar kan hij lezen en in één collectie schrijven.

Daarnaast liggen er koppelingen voor Multivers, e-Boekhouden, Odoo, WooCommerce, Mollie en mail. Die draaien lokaal, op een eigen computer, en zijn gebruikt in proeven met factuurverwerking in Odoo en Multivers.

Een server leest met zo min mogelijk rechten. Schrijven mag pas na een vastgelegd besluit per server. De HubSpot-server schrijft tot concept: geen tool verstuurt een mail of zet een workflow aan. Dat doet een mens in HubSpot zelf.

De onderhoudsmotor schrijft alleen na een droogloop, een proefrun die niets verandert, op exact dezelfde invoer. De droogloop geeft een plan en een vingerafdruk, een code die bij die invoer hoort. De schrijfopdracht moet die code meesturen. Rollen in Keycloak bepalen per site wie mag lezen, schrijven of publiceren. De collecties met contacten en deelnames blijven dicht.

In de motor zit geen taalmodel. Bij een wijziging aan een document legt hij de oude en de nieuwe waarde vast. Zo is de wijziging terug te draaien zolang niemand er daarna aan werkte. Vervangen bestanden en globale instellingen zijn niet terug te draaien.

De vier servers draaien op ons Kubernetes-cluster in Amsterdam. Dat is de groep servers waarop onze diensten staan. Uitrollen gaat via GitHub Actions en ArgoCD. Sleutels komen uit 1Password en staan niet in de code.

Het logboek van de motor staat in een eigen opslagbucket. Met zijn sleutel kan de motor daar schrijven en lezen. Wissen kan hij er niet.

De drie teamservers loggen nog in via de vorige inlogdienst, de onderhoudsmotor via Keycloak. De vorige inlogdienst gaat eruit. De teamservers zijn nog niet over.

De koppelingen voor boekhoudpakketten en webwinkels draaien alleen lokaal. Hosten op het cluster, zoals de teamservers, is nog niet gedaan.