Bestanden converteren in Claude en Cursor met de GuruPDF MCP

Je coding-agent kan een app opzetten, een stack trace ontwarren en met je in discussie gaan over tabs versus spaties. Maar geef hem een PDF en vraag om een bewerkbaar Word-document, en hij loopt vast. Bestanden staan op je schijf; het model leeft in de chat. Niets verbindt die twee.

Die kloof is precies de reden waarom we de GuruPDF MCP hebben gebouwd — een kleine MCP-server die Claude, Cursor en elke andere MCP-client een manier geeft om écht bestanden te converteren. Zet een pad in je prompt, zeg wat je wilt, en het geconverteerde bestand staat even later weer op je schijf. Geen uploadscherm, geen "download het, en upload het dan ergens anders weer opnieuw." Gewoon "converteer ~/contracts/lease.pdf naar Word."

Wat een MCP voor bestandsconversie eigenlijk is

MCP — het Model Context Protocol — is de stekker waarmee een AI-agent tools buiten zijn eigen hoofd kan gebruiken. Een server stelt een paar acties beschikbaar; de agent roept ze aan wanneer je prompt erom vraagt. Er zijn MCP-servers voor databases, browsers, GitHub.

Er was er geen goede voor bestanden. Dus een PDF MCP — eigenlijk een MCP voor bestandsconversie, want hij reikt veel verder dan PDF — is gewoon een server die een bestand in het ene formaat aanneemt en een ander teruggeeft. PDF naar Word. Een map vol afbeeldingen naar één PDF. Een gescande pagina naar doorzoekbare tekst. De agent vraagt; GuruPDF converteert.

Onder de motorkap is het dezelfde engine die achter gurupdf.com zit: 126 tools, 100+ formaten, nu bereikbaar vanuit je editor.

In ongeveer twee minuten ingesteld

Je hebt twee dingen nodig: Node (voor npx) en een gratis GuruPDF API-sleutel. Haal een sleutel op via gurupdf.com/profile — gratis accounts krijgen dagelijkse credits, dus je kunt meteen aan de slag met converteren.

De server installeert en draait zichzelf via npx; er valt niets te klonen:

npx gurupdf-mcp

Die ga je echter niet handmatig draaien — je laat je MCP-client ernaar wijzen. Voor Cursor, Claude Desktop, VS Code of Windsurf zet je dit in je MCP-config:

{
  "mcpServers": {
    "gurupdf": {
      "command": "npx",
      "args": ["-y", "gurupdf-mcp"],
      "env": { "GURUPDF_API_KEY": "your-token-here" }
    }
  }
}

Herstart de client en je agent krijgt er stilletjes vier tools bij: een bestand converteren, een taak controleren, opvragen wat er ondersteund wordt, en je creditsaldo controleren. Dat is de hele setup.

Wat je er daadwerkelijk mee kunt doen

Dit is het leuke deel. Zodra het aangesloten is, zijn dit echte prompts die gewoon werken:

• "Converteer ~/Downloads/invoice.pdf naar Word zodat ik de totalen kan bewerken." — een bewerkbare .docx verschijnt naast het origineel.
• "Maak van elke screenshot in ~/shots één PDF." — afbeeldingen samengevoegd, op volgorde, in één bestand.
• "Deze scan is gewoon een afbeelding. OCR het en geef me de tekst." — echte tekst weer uit de pixels gehaald.
• "Comprimeer report.pdf, het is 40 MB en ik moet het mailen." — een kleiner bestand dat nog steeds leesbaar is.
• "Maak een PDF van https://example.com/pricing." — de live pagina, gerenderd naar PDF.

Je hoeft nooit toolnamen of formaten uit je hoofd te leren. Verwoord je doel in gewone taal en de server kiest welke van de 126 tools past, draait die, en schrijft het resultaat naar schijf. Samenvoegen, splitsen, roteren, met een wachtwoord beveiligen, watermerken, Excel ↔ PDF, HEIC → JPG — ze zitten er allemaal in.

Hij geeft antwoord wanneer er iets mis is

De meeste converters vallen om met een cryptische code; deze is gebouwd om zichzelf uit te leggen via je agent — want de agent is degene die het antwoord daadwerkelijk leest.

Raak je tegen de grenzen van het gratis tier aan, dan krijg je geen kale 402. Je krijgt een zin die je assistent doorgeeft: je hebt de gratis limiet bereikt (2 conversies per minuut, 10 per dag), morgen wordt die gereset, en hier is een link als je liever niet wilt wachten. Geef je een tool het verkeerde formaat, of een bestand dat te groot is, dan vertelt hij je precies dat — in woorden, niet als een foutnummer. Je hoeft nooit het gesprek te verlaten om uit te zoeken wat er gebeurd is.

Dat idee van "leg het uit via de agent" is ook waarom we zo precies zijn op de formulering. Een foutmelding die een mens nooit leest, moet nog steeds te begrijpen zijn voor het model dat hem doorgeeft.

Wat er onder de motorkap zit

• 126 tools, 100+ formaten. PDF, Word, Excel, PowerPoint, afbeeldingen, e-books, zelfs video — dezelfde engine als de website.
• Een echt gratis tier. Elk account krijgt dagelijkse credits. Er bestaan betaalde abonnementen en creditbundels voor zwaarder gebruik, en je agent wijst je daarop wanneer het echt zinvol is, niet eerder.
• Bestanden blijven niet hangen. Alles gaat over HTTPS en wordt binnen een uur verwijderd. De MCP schrijft het resultaat naar je schijf; de kopie aan onze kant is kort daarna weg.
• Open source. De server is MIT-gelicentieerd, gepubliceerd op npm en vermeld in het officiële MCP-register, dus je kunt elke regel lezen voordat je hem draait.

Haal het binnen

Als je je dag doorbrengt in Claude of Cursor en steeds weer naar een of andere converterwebsite springt, dan haalt dit die omweg weg.

• Installeren: npx gurupdf-mcp
• Pakket: npmjs.com/package/gurupdf-mcp
• Register: zoek op "GuruPDF" in het officiële MCP-register
• API-sleutel: gurupdf.com/profile

Voeg het één keer toe en vergeet dat het er is — tot de volgende keer dat je een browsertabblad had geopend om een bestand te converteren, en je agent het gewoon zelf doet.