instellectEen goede MCP-tool heeft een specifieke taak, een gevalideerd invoerschema en een voorspelbare uitkomst. Geef lezen, voorbereiden en wijzigen waar zinvol afzonderlijke tools. Beschrijvende metadata kan helpen bij selectie, maar dwingt zelf geen rechten af.
Gebruik een naam die het gevolg beschrijft
“Manage customer” kan zoeken, aanpassen of verwijderen betekenen. Een specifiekere taak zoals klantstatus opvragen maakt de benodigde bevoegdheid duidelijker. Beschrijf verplichte referenties, de betekenis van velden en hoe ontbrekende informatie wordt teruggegeven. Vermijd dat één vrij tekstveld alle regels draagt; begrens waarden die technisch begrensd kunnen worden.
Valideer op de server
Een model kan een schemaveld verkeerd interpreteren of een ongewenste combinatie produceren. Controleer naast het schema zakelijke regels en toegangsrechten in de uitvoeringslaag. Een indicatie dat een tool alleen leest is nuttig voor gebruikersinterfaces, maar geen securitycontrole. De implementatie moet daadwerkelijk geen wijziging uitvoeren. Voor externe bestemmingen hoort ook bestemmingstoetsing bij het contract.
Ontwerp bruikbare fouten
Maak onderscheid tussen ongeldige invoer, ontbrekende toegang, niet gevonden gegevens en tijdelijke onbeschikbaarheid. De client moet kunnen bepalen of een vervolgvraag of retry passend is. Stuur niet meer recordvelden terug dan de taak nodig heeft. Een compacte, consistente respons is gemakkelijker te beoordelen dan een volledige API-export. Gebruik MCP-servertests om het contract te bewaken.
Van brede API naar een beperkte tool
| Onderdeel | Bruikbaar contract | Te vaag |
|---|---|---|
| Invoer | Klantreferentie en toegestane velden | Vrije opdracht om iets met CRM te doen |
| Effect | Alleen actuele status lezen | Automatisch ontbrekende gegevens aanpassen |
| Uitvoer | Status, bronreferentie, ophaalmoment | Alle klantvelden plus interne headers |
| Fout | Toegang geweigerd zonder dossierinhoud | Volledige stacktrace met credentialdetails |
Een ontbrekend klantnummer
De gebruiker noemt twee bedrijven met dezelfde naam. De tool verwacht een eenduidige referentie en kiest niet zelf een record om de call te laten slagen. De client stelt een verduidelijkingsvraag. Na selectie haalt de tool de toegestane status op. Daardoor wordt een onduidelijke gebruikersvraag geen stilzwijgende wijziging of informatieverstrekking over het verkeerde bedrijf.
Neem mee naar je team.
- Lees de toolnaam zonder context: is het effect duidelijk?
- Test ontbrekende, extra en tegenstrijdige argumenten.
- Controleer dat output en foutmeldingen binnen de gegevensgrens blijven.
Met ruimte voor je besluit, eigenaar en testbewijs. Geen e-mailadres nodig.
Bronnen & verantwoording
Technische achtergrond bij dit onderwerp. De keuzetabel, checklist en fictieve voorbeelden zijn een eigen redactionele uitwerking van Instellect. De beschreven patronen zijn geen overzicht van reeds beschikbare productfuncties.
Geraadpleegd op 11 oktober 2026. Een correctie doorgeven? Mail Instellect.