Bedrijfsdata via MCP: Claude Code, Codex en Cursor koppelen aan Nederlandse bedrijven

Wat levert een MCP-koppeling met bedrijfsdata op?

Met een MCP-koppeling voor bedrijfsdata zoekt je AI-agent zelf in een Nederlandse bedrijvendatabase. Je hoeft geen lijst meer te downloaden en in een chat te plakken. Je stelt gewoon je vraag, en de agent zoekt zelf de tool die daarbij past. Met het antwoord werkt hij meteen verder, bijvoorbeeld in een CSV voor je CRM.

MCP staat voor Model Context Protocol. Het is een open standaard waarmee een AI-toepassing tools van een andere dienst kan aanroepen. De specificatie van het Model Context Protocol beschrijft hoe een client en een server dat afspreken. Claude Code, Codex en Cursor kunnen alle drie met een MCP-server over HTTP werken.

Wat heb je nodig?

• Een gratis FirmTrove-account. Aanmelden kan op app.firmtrove.nl.
• Een toegangssleutel. Die maak je in je account onder Koppelingen. De sleutel zie je één keer.
• Claude Code, Codex of Cursor op je eigen computer.

Zet de sleutel in een omgevingsvariabele, bijvoorbeeld FIRMTROVE_KEY. Dan staat hij niet in een configuratiebestand en komt hij niet per ongeluk in je repository terecht.

Zo koppel je Claude Code, Codex en Cursor

Het adres van de server is https://app.firmtrove.nl/mcp. De sleutel gaat mee als Bearer-token.

1. Claude Code: claude mcp add --transport http firmtrove https://app.firmtrove.nl/mcp --header 'Authorization: Bearer ${FIRMTROVE_KEY}'. Gebruik enkele aanhalingstekens, dan bewaart Claude Code de verwijzing naar de variabele en niet de sleutel zelf. Controleer daarna met claude mcp get firmtrove of de status Connected is.
2. Codex: codex mcp add firmtrove --url https://app.firmtrove.nl/mcp --bearer-token-env-var FIRMTROVE_KEY. Met codex mcp list zie je de koppeling staan.
3. Cursor: zet de server in .cursor/mcp.json met de url en een Authorization-header die naar ${env:FIRMTROVE_KEY} verwijst.
4. Stel een vraag. De agent vraagt de lijst met tools op en kiest er zelf een.

Op de pagina API en MCP staan dezelfde stappen met schermafbeeldingen van een echte koppeling.

Welke tools krijgt je agent?

De server geeft zes tools. Je agent kan niet vrij in de database rondkijken. Hij kan alleen deze zes dingen doen, binnen de limieten van jouw account.

• firmtrove_search_companies zoekt op naam, sector, provincie, postcode, oprichtingsjaar en of er een website, telefoonnummer of zakelijk e-mailadres is.
• firmtrove_get_company haalt één bedrijf op, met alle velden die je mag zien.
• firmtrove_market_size telt bedrijven per sector en provincie.
• firmtrove_find_similar zoekt vergelijkbare bedrijven en zegt waarom.
• firmtrove_export maakt een CSV binnen je exportlimiet.
• firmtrove_dataset_info geeft de stand en de labels van de database.

Een echte vraag, een echt antwoord

Op 23 september 2026 vroegen we Claude Code hoeveel bedrijven met software in de naam er in de provincie Utrecht staan. Claude riep firmtrove_search_companies aan met de zoekterm software en de provincie Utrecht. Het antwoord: 87 bedrijven, met onder meer Bulxoft Software in Lexmond en R2 Software in Mijdrecht, elk met hun website. Daarna exporteerden we vijf van die bedrijven met firmtrove_export. Het account had toen nog 91 van de 100 gratis exportrijen voor die maand over.

Elk bedrijf in het antwoord heeft een label dat zegt wat je bij hergebruik moet doen, zoals de bron vermelden. Een veld dat je volgens de bron niet mag doorgeven, blijft uit het antwoord weg. De agent ziet dan in withheld welk veld ontbreekt en waarom. Welke licenties per bron gelden, staat op de pagina bronnen en rechten.

Limieten die je agent moet kennen

CSV, REST en MCP delen één rijentegoed per account en kalendermaand. Elke CSV-rij telt mee. Via API en MCP telt hetzelfde bedrijfs-ID samen één keer per kalendermaand. Free heeft 100 rijen, met maximaal 100 per CSV-export. Pro kost €29 per maand exclusief btw: 5.000 rijen in je eerste betaalde maand, daarna 2.500 extra per opeenvolgende betaalde maand tot 25.000. Jaarbetaling kost €290 vooraf exclusief btw en geeft 25.000 rijen per kalendermaand. Bestaande betaalde accounts behouden 25.000 rijen per kalendermaand. Met Pro exporteer je maximaal 5.000 rijen per CSV. De details staan op de pagina API en MCP, in het fair-usebeleid en op de prijspagina.

Geef je agent daarom een duidelijke opdracht. Laat hem eerst tellen of een kleine pagina ophalen, en pas daarna exporteren. Gebruik bij een export altijd een vaste sleutel voor dubbele aanvragen, zodat een herhaalde aanroep geen tweede export maakt.

Veelgestelde vragen

Kan mijn agent de hele database leeghalen?

Nee. Elke zoekvraag geeft een begrensde pagina terug en elke export telt mee voor je limiet. Stelselmatig kopiëren mag ook niet volgens het fair-usebeleid, en een vrije databasevraag zit niet in de tools.

Is MCP iets anders dan de API?

Het zijn twee ingangen tot dezelfde gegevens met dezelfde limieten. MCP is handig als een AI-agent zelf beslist welke stap hij zet. De REST API past beter bij een vast script. Lees meer in bedrijfsdata via API of MCP.

Wat gebeurt er met mijn vragen?

FirmTrove houdt per account het aantal verzoeken en de exports bij, net als bij de browser, voor de limieten en tegen misbruik. Wat je agent verder met het antwoord doet, gebeurt bij jouw eigen AI-dienst.