Je eigen data en dienst veilig ontsluiten voor partners én AI-assistenten. Een nette API-laag met versioning, auth en rate-limits, plus een MCP-server zodat Claude en ChatGPT je product echt kunnen gebruiken in plaats van er alleen over te praten.
Een SaaS-bedrijf wilde partners zelf laten koppelen en zijn product bruikbaar maken binnen AI-assistenten, maar had alleen een interne database en wat ad-hoc endpoints. Ik bouwde er een echte API-laag omheen, met auth, versioning en documentatie, en daarnaast een MCP-server zodat een assistent als Claude of ChatGPT het product als gereedschap kan aanroepen. Dit is dezelfde opzet als Cortex, de MCP-server achter mijn eigen kennisbank die deze website voedt. De demo hieronder laat zien hoe een assistent via die tools echt werk doet.
Vereenvoudigde demo met voorbeelddata · een voorproef, geen volledig product
De data en logica zaten opgesloten in een intern systeem. Partners die wilden koppelen kregen losse endpoints die bij elke wijziging weer braken, en van gebruik binnen een AI-assistent was geen sprake. De kern van de opdracht zat niet in "een API erbij", maar in een deur die je met een gerust hart open kunt zetten: partners die precies genoeg toegang krijgen, een contract dat niet stiekem breekt, en een vorm die een AI-assistent daadwerkelijk kan bedienen zonder dat je je data te grabbel gooit.
Een nette API-laag over het bestaande systeem, zodat partners tegen een stabiel contract koppelen en jij je interne opzet vrij kunt blijven verbouwen.
Auth, scopes en rate-limits vanaf het begin, zodat elke partner en elke assistent alleen bij het stukje kan dat hij nodig heeft, en niet meer.
Een MCP-server maakt dezelfde functies beschikbaar als tools voor Claude en ChatGPT, zodat een assistent je product echt kan gebruiken.
De keuzes achter de demo, eerlijk uitgelegd. Dit is de opzet zoals ik hem in de praktijk bouw, geen afgeschermde black box.
Ik zet nooit de database rechtstreeks open, maar leg er een expliciete API-laag overheen die precies definieert wat er in- en uitgaat. Dat doe ik omdat je interne schema van jou is en mag veranderen: als partners tegen een stabiel contract koppelen in plaats van tegen je tabellen, kun je binnenin vrij verbouwen zonder dat er buiten iets breekt. Het contract is de scheidslijn tussen jouw vrijheid en hun zekerheid.
Ik bouw authenticatie en autorisatie er niet later omheen, maar meteen erin: elke partner krijgt zijn eigen sleutel of OAuth-toegang met scopes die precies afbakenen wat hij mag zien en doen. Een publiek endpoint is een aanvals- en kostenoppervlak, dus least-privilege is het uitgangspunt. Zo kan een partner die alleen orders hoeft te lezen nooit per ongeluk bij klantgegevens of schrijfacties.
Ik zet de API op met expliciete versies, zodat v1 bevroren blijft terwijl ik doorontwikkel. Dat is essentieel omdat een partner één keer tegen je contract aan bouwt en er daarna op vertrouwt. Wijzig je dan ongemerkt een veld, dan valt hun integratie om zonder dat ze iets deden. Met versioning en aangekondigde deprecations verander je zonder iemand te verrassen.
Ik ontsluit exact dezelfde functies ook als MCP-server, waarbij elke tool getypeerd is en een heldere beschrijving heeft van wat hij doet en wanneer je hem inzet. Dat precieze contract is de reden dat een assistent de tool goed gebruikt in plaats van te gokken. Het is dezelfde aanpak als Cortex, de MCP-server achter mijn eigen kennisbank: een assistent kan je product pas echt bedienen als elk gereedschap een scherp, beschreven contract is.
Ik genereer de documentatie uit hetzelfde schema dat de API afdwingt, met voorbeelden en testsleutels om mee te spelen. Dat doe ik omdat een API die niemand snapt een API is die niemand gebruikt. Als de docs automatisch meebewegen met het contract, lopen ze nooit achter op de werkelijkheid en kan een partner binnen een middag koppelen zonder jou te hoeven mailen.
Je functies als getypeerde tools die een assistent echt kan aanroepen.
Iedere partner en assistent krijgt precies de rechten die past, niet meer.
v1 blijft stabiel terwijl je doorbouwt, met aangekondigde deprecations.
Bescherming tegen overbelasting en onbedoeld hoog gebruik per afnemer.
Documentatie en voorbeelden die automatisch meebewegen met de API.
Partners krijgen updates gepusht in plaats van te moeten pollen.
Deze case koppelt aan bestaande systemen. Een paar van de integraties die hierbij passen, allemaal op maat te koppelen.
Elk onderdeel werkt op zichzelf, maar wordt sterker in combinatie. Een paar voorbeelden uit de praktijk:
Van gesloten systeem naar bouwsteen voor partners en assistenten.
Gidsen die dieper op dit onderwerp ingaan.
Deze case is een referentie-build voor Eigen API's & MCP-servers. Bekijk hoe ik dat aanpak, of doe de gratis Automatiseringsscan en zie in twee minuten waar bij jou de winst zit.
Vertel me wat je voor ogen hebt of waar je tegenaan loopt, dan denk ik mee en zeg ik eerlijk wat er kan, vrijblijvend.
