Wat is het verschil tussen Resources en Tools in MCP?

Tools voeren acties uit tegen de API (factuur aanmaken, uitgaven weergeven). Resources tonen statische referentiegegevens die de agent kan raadplegen zonder API-aanroepen te doen. Belastingtarieven, belastingkalenders of uitgavencategorieën zijn altijd beschikbaar als context.

Wat zijn MCP Prompts en hoe worden ze gebruikt?

Prompts zijn geleide workflows die meerdere tools in een logische volgorde aan elkaar koppelen. In plaats van losse operaties uit te voeren, begeleidt een prompt zoals monthly-close de agent stap voor stap: openstaande facturen controleren, uitgaven categoriseren, belastingverplichtingen controleren.

Moet ik iets updaten om v1.2 te gebruiken?

Als je npx @frihet/mcp-server gebruikt, krijg je automatisch de nieuwste versie. Als je een vaste installatie hebt, update dan met npm update @frihet/mcp-server. Er zijn geen breaking changes ten opzichte van v1.1.0.

MCP Server v1.2: resources, prompts en gestructureerde output

De versie 1.2.1 van de Frihet MCP-server voegt geen extra tools toe. Het voegt intelligentie toe. Resources zodat agents fiscale context hebben zonder te vragen. Prompts zodat ze complete workflows kunnen uitvoeren zonder tussenkomst. Gestructureerde output zodat elke reactie deterministisch parseerbaar is.

Deze update verandert de MCP-server van een brug voor CRUD-operaties in een complete interface voor bedrijfsbeheer voor AI-agents.

Resources: altijd beschikbare referentiegegevens

De MCP Resources zijn statische gegevens die de agent op elk moment kan lezen zonder API-aanroepen te doen naar Frihet. Ze verbruiken geen quota, vereisen geen aanvullende authenticatie en zijn beschikbaar vanaf het moment dat de server verbinding maakt.

De v1.2 introduceert 5 resources:

`frihet://api/schema`

Overzicht van alle beschikbare endpoints, authenticatiemethoden en rate-limieten. Wanneer een agent wil weten wat hij met Frihet kan doen, raadpleegt hij deze resource in plaats van dit door middel van trial-and-error te ontdekken.

`frihet://tax/rates`

Huidige belastingtarieven in Spanje: algemeen BTW (21%), verlaagd (10%) en superverlaagd (4%); Canarische IGIC (7%, 3%, 0%); IRPF-inhoudingen. De agent heeft deze context voordat hij een factuur aanmaakt of een uitgave registreert. Hij hoeft niet te vragen welke BTW toe te passen als hij al weet waar jouw bedrijf actief is.

`frihet://tax/calendar`

Indieningsdatums voor kwartaalaangiften: Model 303 (BTW), Model 130 (IRPF), Model 420 (IGIC). Wanneer de agent een kwartaalafsluiting voorbereidt, weet hij precies wanneer elke verplichting vervalt.

`frihet://config/expense-categories`

De 8 uitgavencategorieën met hun aftrekbaarheidsregels. Kantoorbenodigdheden, leveringen, transport, reiskosten, training, verzekeringen, professionele diensten, overig. Elke categorie omvat het aftrekbaarheidspercentage en de toepasselijke voorwaarden.

`frihet://config/invoice-statuses`

De statusstroom van een factuur: concept, uitgegeven, verzonden, geïnd, vervallen, geannuleerd. Elke status omvat de toegestane overgangen en de triggers die geactiveerd kunnen worden (webhooks, meldingen). De agent weet welke acties op elk moment geldig zijn.

Prompts: geleide workflows

Een Tool voert een operatie uit. Een Prompt orkestreert meerdere operaties in een coherente stroom. Het verschil is van “maak deze uitgave aan” naar “verwerk deze 15 uitgaventickets, categoriseer ze, pas de juiste belastingen toe en bevestig voordat je aanmaakt”.

De v1.2 bevat 5 prompts:

`monthly-close`

Geleide maandafsluiting. De agent controleert openstaande facturen, categoriseert niet-toegewezen uitgaven, controleert of de fiscale verplichtingen van de periode zijn gedekt en genereert een samenvatting. Een workflow die normaal gesproken een uur handmatige controle kost, uitgevoerd in één gesprek.

`onboard-client`

Nieuwe klant aanmelden. Bepaalt het belastingtarief op basis van de locatie van de klant (peninsulair BTW, Canarische IGIC, intracommunautair), maakt de registratie aan met de juiste fiscale gegevens en genereert een welkomstofferte. Alles in één reeks.

`quarterly-tax-prep`

Kwartaalbelastingvoorbereiding. Verzamelt alle facturen van de periode, berekent de BTW- of IGIC-grondslagen, past de IRPF-inhoudingen toe en genereert een preview van Model 303 of 130. De agent doet het werk; jij of jouw accountant valideert het resultaat.

`overdue-followup`

Opvolging van vervallen facturen. Identificeert alle te late facturen, groepeert ze per klant, berekent het totale openstaande bedrag per klant en stelt gepersonaliseerde incassoberichten op. Van “ik moet controleren wat ze me verschuldigd zijn” naar “hier zijn de concepten klaar om te verzenden”.

`expense-batch`

Batchverwerking van uitgaven. Ontvangt een lijst met uitgaven, categoriseert ze volgens de geconfigureerde regels, past de bijbehorende belastingen toe, controleert de aftrekbaarheid van elk en maakt ze aan met voorafgaande bevestiging. Ideaal voor het verwerken van verzamelde tickets van een week of een reis.

Gestructureerde output: parseerbare antwoorden

Tot nu toe waren de antwoorden van de MCP-server opgemaakte tekst. Handig voor menselijke leesbaarheid, maar agents hebben gestructureerde gegevens nodig om programmatische beslissingen te nemen.

De v1.2 voegt outputSchema en structuredContent toe aan elke tool. Elke reactie bevat een JSON-schema dat precies de structuur van de geretourneerde gegevens beschrijft. De agent weet voordat hij aanroept welke velden hij zal ontvangen, welk type ze zijn en welke optioneel zijn.

Dit is wat een prompt zoals quarterly-tax-prep in staat stelt om 4 operaties betrouwbaar aan elkaar te koppelen: elke stap produceert gegevens met een bekende structuur die de volgende stap zonder ambiguïteit kan consumeren.

Voor ontwikkelaars die integraties bouwen bovenop de MCP-server, elimineert dit de noodzaak om vrije tekst te parsen. De reactie heeft altijd dezelfde vorm.

Beveiligingsannotaties

Elke tool van de MCP-server bevat nu annotaties die aangeven of de bewerking alleen-lezen of destructief is. Een list-invoices is gemarkeerd als lezen. Een delete-expense is gemarkeerd als destructief.

Dit stelt agents in staat om bevestigingsbeleid te implementeren. Een agent kan leesbewerkingen uitvoeren zonder te vragen, maar expliciete bevestiging vragen voordat gegevens worden verwijderd of gewijzigd. De beveiliging is niet afhankelijk van de agent — het wordt gedefinieerd door de server.

Universele installatie

De server wordt geïnstalleerd met één commando in elke compatibele agent:

npx @frihet/mcp-server

Werkt in Claude Code, Claude Desktop, Cursor, Windsurf, Cline, Codex en elke MCP-client. Voor agents die installatie via skills ondersteunen:

npx skills add Frihet-io/frihet-mcp

Beide methoden geven toegang tot de 30+ tools, de 5 resources, de 5 prompts en de gestructureerde output.

Repository onder Frihet-io

De MCP-server is overgedragen aan de organisatie Frihet-io op GitHub. De URL van de repository is nu github.com/Frihet-io/frihet-mcp. De eerdere links leiden automatisch door.

Het npm-pakket blijft @frihet/mcp-server. Er zijn geen wijzigingen in de installatie.

Voor wie is deze update

Professionals die de MCP-server al gebruiken krijgen Resources als automatische fiscale context en Prompts als workflows die ze voorheen stap voor stap handmatig uitvoerden.

Ontwikkelaars die op Frihet bouwen krijgen gestructureerde output voor deterministische integraties en beveiligingsannotaties voor bevestigingsbeleid.

Boekhoudkantoren en belastingadviseurs krijgen specifieke prompts voor hun workflows: maandafsluiting, kwartaalvoorbereiding, incassofollow-up.

Elk bedrijf dat AI-agents gebruikt krijgt een MCP-server die niet alleen operaties uitvoert, maar ook weet hoe deze aan elkaar te koppelen in echte bedrijfsprocessen.

Hoe te updaten

Als je npx @frihet/mcp-server gebruikt, heb je al de nieuwste versie. Als je een vaste installatie hebt:

npm update @frihet/mcp-server

Er zijn geen breaking changes. Alle bestaande tools behouden hun interface. De Resources, Prompts en gestructureerde output zijn pure toevoegingen.

De volledige documentatie is te vinden op docs.frihet.io/desarrolladores. De broncode op GitHub (Frihet-io/frihet-mcp). Het pakket op npm als @frihet/mcp-server.