De eerste MCP-server aansluiten

Het belangrijkste kort

Een koppeling bestaat uit drie gegevens: het programma dat wordt gestart, zijn argumenten en de toegangsgegevens als omgevingsvariabelen.
Toegangsgegevens horen nooit in het configuratiebestand zelf, maar in een omgevingsvariabele of een sleutelopslag.
De drie meest voorkomende fouten: een verkeerd pad naar het programma, een vergeten herstart van de toepassing, en een toegangssleutel met te ruime rechten.
Vóór productiegebruik staat een korte controlelijst – vooral de vraag wat een misgreep maximaal kan aanrichten.

Het Model Context Protocol is een open standaard waarmee een taalmodel bij gereedschap en data kan – bestanden, agenda, een CRM, een database. Het voordeel boven losse oplossingen: wat er eenmaal als MCP-server bestaat, werkt met elke toepassing die het protocol spreekt.

De eerste koppeling is het punt waarop velen afhaken – niet omdat het ingewikkeld zou zijn, maar omdat de foutmeldingen weinig zeggen.

De drie delen van een koppeling

De server

Een klein programma dat een gegevensbron of een gereedschap beschikbaar stelt. Het draait op jullie computer of op een server en wordt bij behoefte gestart – je hoeft het niet zelf te schrijven, voor de gangbare systemen zijn er kant-en-klare.

De client

De toepassing waarin jullie werken en die de server aanspreekt. Ze start hem, vraagt hem welk gereedschap hij aanbiedt, en legt dat aan het model voor.

De configuratie

Een klein bestand dat de client vertelt: start dit programma, met deze argumenten, met deze toegangsgegevens. Meer staat er niet in – en precies hier gaan de meeste dingen mis.

De inrichting in zes stappen

Server kiezen. Begin met lezende toegang tot iets ongevoeligs – een bestandsmap, een documentatie. Niet met het CRM.
Uitvoeringsomgeving toetsen. De meeste servers hebben Node.js of Python nodig. Controleer de versie voordat je begint: node --version respectievelijk python --version.
Toegangssleutel aanmaken – zo eng mogelijk. Als de server alleen moet lezen, geef hem dan alleen leesrechten. Dat is de stap die het vaakst te royaal wordt gedaan.
Configuratie invullen. Programma, argumenten, omgevingsvariabelen. Absolute paden gebruiken, geen relatieve.
Toepassing volledig afsluiten en opnieuw starten. Niet alleen het venster sluiten – de configuratie wordt bij het opstarten gelezen.
Controleren of het gereedschap er is. De client toont welk gereedschap een server aanbiedt. Verschijnt daar niets, dan is de server niet gestart.

Let op Schrijf een toegangssleutel nooit rechtstreeks in een configuratiebestand dat in een projectmap ligt. Zulke bestanden belanden naar ervaring in back-ups, in versiebeheer en in schermafbeeldingen. Gebruik een omgevingsvariabele of de sleutelopslag van het besturingssysteem.

De struikelblokken die in geen enkele documentatie staan

Het pad klopt niet

De meest voorkomende fout van allemaal. De toepassing start de server in een andere omgeving dan jullie opdrachtregel – een programma dat in de terminal wordt gevonden, is daar mogelijk onbekend.

Oplossing: het volledige pad invullen. Onder macOS en Linux uitzoeken met which node, onder Windows met where node.

Geen herstart

De configuratie wordt gelezen bij het opstarten van de toepassing. Het venster sluiten volstaat niet – onder macOS draait de toepassing door.

Oplossing: volledig afsluiten en opnieuw starten. Klinkt banaal, kost regelmatig een half uur.

De sleutel heeft te veel rechten

Een toegangssleutel met schrijf- en verwijderrechten valt bij het inrichten niet op. Hij valt op wanneer een opdracht verkeerd wordt begrepen.

Oplossing: twee sleutels aanmaken – een lezende voor het dagelijks werk, een schrijvende alleen daar waar schrijven echt nodig is.

Server start, maar meldt niets

Een server die bij het opstarten afbreekt, verschijnt in de client meestal gewoon als leeg – zonder foutmelding.

Oplossing: voer de startopdracht één keer met de hand uit op de opdrachtregel. Daar staat dan wat er ontbreekt.

Wist je dat?

Een MCP-server beschrijft zijn eigen gereedschap – naam, doel, verwachte gegevens. Het model komt pas tijdens de uitvoering te weten wat het kan.

Daaruit volgt iets praktisch: de kwaliteit van die beschrijvingen bepaalt in hoge mate hoe betrouwbaar een gereedschap wordt ingezet. Een server met de beschrijving «zoekt contacten» wordt slechter bediend dan een met «zoekt contacten op bedrijfsnaam of e-mailadres; geeft hoogstens 50 treffers terug; vindt geen verwijderde records». Wie zelf een server bouwt, steekt de tijd het beste in die teksten.

Controlelijst vóór productiegebruik

Vraag	Waarom ze telt
Wat kan een misgreep maximaal aanrichten?	Bepaalt of schrijfrechten te verantwoorden zijn
Wordt de toegang gelogd?	Zonder log valt achteraf niets na te gaan
Wie kent de toegangssleutel?	Bepaalt wie hem bij personeelswissel moet vervangen
Zijn er persoonsgegevens binnen bereik?	Dan gelden verplichtingen rond gegevensbescherming – ook bij de aanbieder van het model
Hoe schakel je hem snel uit?	Moet duidelijk zijn voordat je het nodig hebt

Uit de praktijk

De vierde regel wordt bij het uitproberen bijna altijd overgeslagen en heeft de grootste gevolgen. Zodra een server toegang heeft tot klantgegevens, worden die gegevens doorgegeven aan de aanbieder van het model – dat is verwerking in opdracht, met alles wat daarbij hoort.

Voor de eerste poging betekent dat: neem een map met ongevoelige bestanden, niet de klantenlijst. Het verschil tussen «uitproberen» en «in bedrijf» is niet technisch van aard – het ontstaat op het moment dat er echte gegevens in het spel zijn.

Prompt

Help me mijn eerste MCP-koppeling in te richten en te toetsen.

Mijn situatie:
- Besturingssysteem: [macOS / Windows / Linux]
- Toepassing waarin ik werk: [client]
- Wat ik wil koppelen: [gegevensbron of gereedschap]
- Moet de toegang lezen of ook schrijven? [lezen / beide]
- Zijn er persoonsgegevens binnen bereik? [ja / nee / onduidelijk]

Opdrachten:
1. Noem de gegevens die ik in de configuratie moet invullen,
   en leg elk daarvan in één zin uit.
2. Zeg me hoe ik onder mijn besturingssysteem het volledige pad
   naar het programma achterhaal.
3. Noem de engst mogelijke rechten voor de toegangssleutel.
   Onderbouw waarom verdergaande rechten niet nodig zijn.
4. Geef me drie controlestappen waarmee ik vaststel of de server
   draait – en wat er telkens te doen is als dat niet zo is.
5. Als er persoonsgegevens binnen bereik zijn: noem wat er vooraf
   geregeld moet zijn.

Vraag niet naar de toegangsgegevens zelf – die vul ik in als
omgevingsvariabele.

Conclusie

De technische drempel ligt lager dan hij lijkt: drie gegevens in een configuratiebestand, een herstart, klaar. De drie terugkerende fouten zijn een relatief in plaats van absoluut pad, een vergeten herstart en een te royale toegangssleutel.

De eigenlijke beslissing is geen technische: ze zit in waartoe jullie toegang verlenen. Begin met iets waarbij een misgreep zonder gevolgen blijft – en regel de vragen rond gegevensbescherming voordat er echte klantgegevens in het spel zijn, niet daarna.

Veelgestelde vragen

Hoe richt je een MCP-server in?

In zes stappen: een server voor een ongevoelige gegevensbron kiezen, de uitvoeringsomgeving toetsen (meestal Node.js of Python), een toegangssleutel met zo eng mogelijke rechten aanmaken, programma, argumenten en omgevingsvariabelen in de configuratie invullen, de toepassing volledig opnieuw starten en controleren of het gereedschap in de client verschijnt.

Heb je programmeerkennis nodig voor een MCP-koppeling?

Nee, als er een kant-en-klare server voor het doelsysteem bestaat. De inrichting bestaat uit het invullen van drie gegevens in een configuratiebestand. Programmeerkennis heeft pas nodig wie zelf een server schrijft voor een systeem waarvoor er geen is.

Waarom verschijnt de MCP-server niet in de toepassing?

Meestal door een van drie oorzaken: het pad naar het programma is relatief in plaats van absoluut opgegeven en wordt in de omgeving van de toepassing niet gevonden, de toepassing is niet volledig afgesloten en opnieuw gestart, of de server breekt bij het opstarten af. Dat laatste geval vind je door de startopdracht één keer met de hand op de opdrachtregel uit te voeren.

Waar bewaar je de toegangsgegevens voor een MCP-server?

In een omgevingsvariabele of in de sleutelopslag van het besturingssysteem – nooit rechtstreeks in het configuratiebestand. Zulke bestanden belanden naar ervaring in back-ups, versiebeheer en schermafbeeldingen. Zinvol zijn bovendien twee gescheiden sleutels: een lezende voor het dagelijks werk, een schrijvende alleen daar waar hij nodig is.

Waar moet je op letten qua gegevensbescherming?

Zodra een server toegang heeft tot persoonsgegevens, worden die doorgegeven aan de aanbieder van het model – dat is verwerking in opdracht, met overeenkomst, vermelding in de privacyverklaring en een grondslag voor de doorgifte naar het buitenland. Voor eerste pogingen is een map met ongevoelige bestanden daarom het juiste vertrekpunt.