MCP koppelen aan AFAS

Ja, je kunt AI via MCP koppelen aan AFAS Profit. AFAS biedt elke Profit-klant standaard een API, en daar bouw je een MCP-server bovenop. Het bijzondere aan AFAS: je bepaalt zelf welke gegevens er via de API naar buiten mogen. De AI ziet daardoor alleen wat jij in AFAS hebt klaargezet.

Hoe AFAS gegevens deelt

AFAS werkt met connectoren. Een GetConnector is een overzicht dat je zelf in AFAS samenstelt, met precies de velden en filters die je kiest. Via de API haalt een andere applicatie dat overzicht op. Met een UpdateConnector kan een applicatie juist gegevens in AFAS aanmaken, aanpassen of verwijderen.

Welke connectoren een koppeling mag gebruiken, regel je in een app connector. Daar koppel je ook de gebruikersgroep en de sleutel aan. Een MCP-server op AFAS bestaat dus uit twee delen. In AFAS zet je de overzichten klaar. In de MCP-server maak je daar tools van die de AI kan aanroepen.

Wat MCP is, lees je in MCP: hoe je AI koppelt aan je bestaande software.

Wat je ermee kunt

Een relatie voorbereiden

Heeft een accountmanager straks een afspraak? Dan vraagt hij de AI om de gegevens van die relatie, met de laatste contactmomenten erbij. Je zet daarvoor een GetConnector klaar met de relatievelden die je wilt delen. De AI zet het op een rij, zonder dat iemand door AFAS hoeft te klikken.

Openstaande posten per klant

Houd je je debiteuren in AFAS bij? Met een overzicht van openstaande posten kan de AI vragen beantwoorden als "welke klanten lopen meer dan een maand achter?". Wie gaat bellen, heeft het antwoord meteen.

Projecten en uren

Schrijft je team uren in AFAS? Dan kan een overzicht per project laten zien hoeveel uur er al op zit, en door wie. Een projectleider vraagt het gewoon aan de AI, ook als hij zelf niet in AFAS werkt.

Wat er technisch nodig is

De API van AFAS. Die is er standaard. Je hebt de omgevings-ID en een sleutel nodig, en die krijg je van de beheerder van je AFAS-omgeving.

Een app connector voor de MCP-server. AFAS raadt aan om voor elke externe applicatie een eigen app connector te maken. Met een eigen gebruikersgroep en een systeemgebruiker die alleen de rechten heeft die nodig zijn.

GetConnectoren voor de vragen. Per vraag die de AI moet kunnen beantwoorden, zet je een overzicht klaar. Alleen de connectoren die in de app connector staan, kan de MCP-server aanroepen.

Inloggen met OAuth of een token. AFAS ondersteunt OAuth 2.1 en wordt daar de standaard. De oudere tokens zonder OAuth worden volgens AFAS uitgefaseerd. Kies voor een nieuwe koppeling dus OAuth.

Een MCP-server die de API aanroept. Die server biedt de AI een paar tools aan, zoals "toon openstaande posten van relatie". Achter elke tool zit een GetConnector in AFAS.

Een MCP-koppeling kost bij ons €5.000 tot €15.000 excl. btw. Hoe die prijs is opgebouwd, lees je in wat kost een MCP-koppeling.

Waar je op let

Stel de rechten in AFAS zelf strak af. Gebruik geen bestaande gebruikersgroep als "Iedereen". AFAS raadt een eigen groep en systeemgebruiker per koppeling aan. Een GetConnector geeft daarnaast alleen records terug die de filterautorisatie toestaat. Daarmee bepaal je in AFAS zelf wat de AI kan zien.

Begin met alleen lezen. Zet in het begin alleen GetConnectoren in de app connector. UpdateConnectoren, die gegevens aanpassen, komen pas later. En dan met een mens die bevestigt voordat er iets in AFAS verandert.

Houd personeelsgegevens erbuiten. Staan er ook personeels- of salarisgegevens in je AFAS-omgeving? Neem die dan niet op in de overzichten voor de AI. Wat een tool teruggeeft, gaat naar het AI-model.

Ga zorgvuldig om met de sleutel. Volgens AFAS is een token net zoiets als een gebruikersnaam met wachtwoord. Deel hem nooit via een onbeveiligd kanaal, en houd het aantal sleutels klein. Een app connector kun je ook beperken tot bepaalde IP-adressen.

Kijk mee in het logboek. AFAS houdt per app connector een logboek bij. Zo zie je wat de MCP-server opvraagt. Hoe je verder met de risico's omgaat, lees je in Is MCP veilig?

Zelf een MCP-server op AFAS?

Hoe we zo'n server bouwen en wat je ervoor nodig hebt, lees je bij MCP-server laten bouwen. Wil je weten wat AI met jouw AFAS-omgeving kan? Stuur Adem een bericht.

Veelgestelde vragen

Wat heb ik van onze AFAS-beheerder nodig voor een MCP-koppeling?

De omgevings-ID en een app connector voor de koppeling, met een eigen gebruikersgroep en systeemgebruiker. Daarin zet de beheerder de GetConnectoren die de AI mag gebruiken. Voor het inloggen kies je OAuth 2.1, of een token dat de beheerder veilig met je deelt.

Welke gegevens uit AFAS kan de AI zien?

Alleen wat je via GetConnectoren in de app connector beschikbaar maakt. Die overzichten stel je zelf samen, en de filterautorisatie bepaalt welke records erin komen. Wat er niet in staat, kan de AI niet opvragen.

Mag een MCP-server UpdateConnectoren van AFAS gebruiken?

Dat kan, want UpdateConnectoren maken gegevens aan, passen ze aan of verwijderen ze. Wij zetten ze in het begin niet in de app connector en werken alleen met GetConnectoren. Komt er later een tool die iets aanpast, dan bevestigt een mens dat eerst.