Interfaces voor AI-agents

Wat het is

Vier manieren om je website als software te raadplegen, plus het werk dat ze vindbaar maakt: een MCP-server, een publieke JSON-API, een OpenAPI-specificatie, een markdown-versie van elke pagina en aanmelding bij de registers waar assistenten en hun gebruikers naar tools zoeken.

De pagina's zelf veranderen niet. Alles wat een bezoeker ziet blijft precies zoals het was. Wat erbij komt is een tweede ingang, gemaakt voor software.

Waarom een gecrawlde site het aflegt tegen een bevraagbare

Vraagt iemand ChatGPT of Claude naar een leverancier, dan antwoordt de assistent met wat hij kan raadplegen. Meestal is dat de HTML die een crawler weken geleden toevallig ophaalde, zonder jouw JavaScript uit te voeren.

Een site met agent-interfaces staat er anders voor. De assistent roept een tool aan, vraagt om je prijzen, krijgt ze terug als data in de taal waarin hij het vroeg, en citeert ze. Dat is het verschil tussen vaag onthouden worden en exact gelezen worden.

Wat er gebouwd wordt

De MCP-server

MCP is het protocol waarmee assistenten tools aanroepen. Jouw server biedt een kleine, read-only set: laat zien wat je verkoopt, geef de prijslijst, zoek een pagina, geef één pagina volledig terug. Read-only betekent dat hij open op het internet kan staan zonder een ingang te worden naar de rest van wat je draait.

De JSON-API en de OpenAPI-specificatie

Dezelfde inhoud over gewoon HTTP, zonder sleutel. Het OpenAPI-bestand beschrijft elk endpoint, zodat een ontwikkelaar, of een agent die zijn eigen client schrijft, ermee aan de slag kan zonder jou eerst iets te vragen.

Een markdown-versie van elke pagina

Elke pagina antwoordt ook op hetzelfde pad met de suffix .md: front matter, de kop, de tekst, geen navigatie en geen scripts. Dat is wat een assistent werkelijk wil als hij een pagina ophaalt, in plaats van een template waar hij zich doorheen moet werken.

Aanmelden bij de registers

De server en de API worden aangemeld bij de publieke MCP-registers en tooldirectory's. Een tool die niemand kan vinden, wordt door niemand aangeroepen.

Waarom het niet uit de pas gaat lopen

De interfaces worden opgebouwd uit dezelfde data als de pagina's. Dat is de hele truc: ze kunnen niet verouderen, want er is geen tweede kopie van de inhoud die je moet bijhouden. En geen enkele tool accepteert een URL van de aanroeper, dus je server wordt nooit een open proxy voor het verkeer van een ander.

Het bewijs is onze eigen site

polargate.ai draait die interfaces in het openbaar. Gecontroleerd op 3 september 2026: de MCP-server op /api/mcp beantwoordt een tools/list-aanroep met zeven read-only tools, /api/v1 geeft de site terug als JSON zonder sleutel en zonder login, /openapi.json beschrijft die API, en elke pagina antwoordt ook op hetzelfde pad met de suffix .md, voor elke URL die de sitemap die dag telde.

Richt je assistent erop en lees wat hij terugkrijgt. Precies dat gaan jouw kopers straks bij jou doen.

Wat het niet is

Het vervangt zoekmachines niet. De crawlers achter antwoordmachines halen nog steeds ruwe HTML op en voeren nog steeds geen JavaScript uit, dus de pagina's moeten eerst als echte HTML bestaan. Het is ook geen garantie dat je geciteerd wordt: dat kan niemand verkopen. Wat het wel garandeert: als een assistent wil uitzoeken wat je verkoopt en wat het kost, ligt er een precies antwoord klaar in plaats van een gok.