Hoe een AI-agent met je systemen praat: koppelingen, API's en MCP uitgelegd

"Een agent zonder koppelingen is een slimme gesprekspartner. Pas met koppelingen kan hij iets doen."

Als ik vertel wat een AI-agent kan, vragen ondernemers meestal hetzelfde: "Maar hoe komt hij bij mijn gegevens?" Dat is de goede vraag. Het model zelf kan lezen en schrijven; wat het werk oplevert, is dat het bij je mail, je CRM en je documenten kan. Dat noem je koppelen, en het is het deel dat de meeste tijd kost.

Kort antwoord: een agent praat met je systemen via koppelingen, meestal een API. Dat is een vaste manier waarop het ene programma het andere kan aanspreken. MCP (Model Context Protocol) is een open standaard die dat voor AI-toepassingen gelijkmaakt. Voor een eerste agent is een directe koppeling of een workflowtool vaak voldoende. De vraag die telt, is niet hoe je koppelt, maar wat de agent mag lezen en wijzigen.

Inhoudsopgave

1. Waarom koppelen het lastigste deel is
2. Wat is een API
3. Wat is een webhook
4. Wat is MCP
5. Welke koppelingen leg je als eerste
6. Wat als je systeem geen API heeft
7. Waar het vaak misgaat

Waarom koppelen het lastigste deel is

Het taalmodel doet weinig anders dan tekst lezen en tekst schrijven. Alles daaromheen is gewone softwarebouw: inloggen, gegevens ophalen, gegevens terugschrijven, fouten opvangen. Elk systeem doet dat net anders. Het ene CRM wil een sleutel, het andere een inlogprocedure. Het ene geeft honderd contacten per keer, het andere tien.

Daarom zit in een offerte voor een agent meestal de meeste tijd in de koppelingen, niet in de AI. Het is ook de reden waarom het aantal koppelingen de prijs bepaalt. Zie wat kost een AI-agent echt en systemen koppelen zonder IT-project.

Wat is een API

API staat voor application programming interface. In gewone taal: een loket met regels. Een programma kan bij dat loket een vraag stellen ("geef me de contactgegevens van klant 123") of een opdracht geven ("voeg deze afspraak toe"), en krijgt een antwoord in een vaste vorm.

Wat je moet weten:

• Authenticatie. Een API vraagt om een sleutel of een inlog. Die sleutel bepaalt wat het programma mag. Geef de agent een eigen sleutel met minimale rechten, zie AI-agents beveiligen.
• Limieten. Veel API's laten maar een beperkt aantal vragen per minuut toe.
• Veranderingen. Een leverancier kan een API aanpassen. Daarom hoort monitoring bij het beheer.
• Kosten. Sommige API's zitten in je abonnement, andere kosten extra.

Wat is een webhook

Een webhook is het omgekeerde van een API-vraag. In plaats van dat jij steeds vraagt "is er iets nieuws?", belt het systeem jou zodra er iets gebeurt. Bij een nieuw formulier, een betaalde factuur of een binnengekomen mail krijgt je agent direct een seintje. Dat is sneller en goedkoper dan om de paar minuten kijken.

Wat is MCP

MCP staat voor Model Context Protocol. Het is een open standaard, in 2024 geïntroduceerd door Anthropic, waarmee AI-toepassingen op één uniforme manier verbinding maken met tools en gegevensbronnen. Zie modelcontextprotocol.io voor de officiële uitleg.

Het idee in een beeld: een gemeenschappelijk stopcontact. Zonder standaard moet je voor elke combinatie van AI-toepassing en tool een eigen koppeling bouwen. Met MCP bouw je één keer een "server" voor je tool (bijvoorbeeld je CRM), en elke AI-toepassing die MCP spreekt kan die gebruiken.

Een eerlijke aanbeveling: voor een eerste agent heb je MCP meestal niet nodig. Het wordt interessant als je agents hebt die dezelfde tools delen. Let wel op de veiligheid: een MCP-server is code die namens de agent dingen doet, dus gebruik alleen servers van bronnen die je vertrouwt, en geef ze net als alles minimale rechten. De documentatie van Anthropic over het gebruik van tools vind je op docs.anthropic.com, en over MCP op docs.anthropic.com/en/docs/agents-and-tools/mcp.

Welke koppelingen leg je als eerste

Begin met koppelingen die weinig risico hebben en veel opleveren.

1. Lezen voor schrijven. Laat de agent eerst alleen lezen: de inbox, het CRM, de agenda. Pas als dat goed werkt, voeg je iets schrijven toe.
2. Concepten voor verzenden. Laat de agent een concept opslaan en niet versturen. Dat is één recht minder.
3. Eén systeem tegelijk. Een agent met twee koppelingen die goed werkt, is beter dan een agent met vijf die half werkt.
4. Systemen waar het werk al gebeurt. Mail, formulieren en CRM zijn bijna altijd de plekken waar een proces begint.

Voor een praktisch stappenplan om je eerste agent te bouwen, zie AI-agent bouwen: stappenplan voor je eerste agent. Voor de keuze tussen een no-codetool en maatwerk, zie n8n, Make of maatwerk.

Wat als je systeem geen API heeft

Het komt voor, vooral bij oudere branchesoftware. Je hebt dan een paar opties:

Als je merkt dat je veel moet omzeilen, is dat een signaal om te kijken naar het systeem zelf. Zie bedrijfssysteem laten bouwen: wat eerst en wat later.

Waar het vaak misgaat

• De sleutel is te krachtig. De agent gebruikt de sleutel van de beheerder. Eén fout of aanval en alles staat open.
• Geen foutafhandeling. De koppeling valt een nacht uit en niemand merkt het. Zorg voor een melding.
• Dubbele acties. De agent probeert iets opnieuw na een time-out en de factuur wordt twee keer aangemaakt. Een goede koppeling is daar tegen beschermd.
• Gegevens kloppen niet. Een agent kan geen goed werk doen op slechte data. Een nummer in het verkeerde veld, een klant twee keer in het CRM. Zie CRM voor een stichting: wat je echt nodig hebt voor een voorbeeld van opruimen voor je koppelt.
• Niemand weet wat er gekoppeld is. Documenteer welke koppelingen er zijn, wie de sleutels beheert en wat er gebeurt als er een uitvalt.

Hulp nodig?

Een koppeling die goed is ingericht, merk je niet. Wil je weten wat er bij jouw systemen mogelijk is? Bekijk procesautomatisering of plan een gesprek via contact. Gaat het om een groter systeem met meerdere koppelingen? Dan past de Rapid Solution Studio.

Gerelateerde artikelen

• AI-agents voor het MKB: de complete gids
• AI-agent, workflow of chatbot: welke past bij jouw taak?
• AI-agents beveiligen: prompt injection, rechten en logboeken
• Systemen koppelen zonder IT-project
• Wat kost workflow-automatisering voor het MKB?

Bronnen en verder lezen

• Model Context Protocol, de officiële site van de standaard
• Anthropic, MCP in de documentatie
• Anthropic, Tool use
• n8n en Make, tools om koppelingen zonder code te leggen

Dit artikel is geschreven door Vincent van Munster van WeAreImpact. Hij legt dagelijks koppelingen tussen systemen en AI-agents, in zijn eigen systeem en voor klanten.