Aan de slag met pdfmcp

Drie lokale manieren om pdfmcp te gebruiken: gratis webtools op je apparaat, de lokale MCP-server voor AI-agenten en de lokale API vanuit je eigen code, elk in ongeveer een minuut klaar.

Drie manieren om pdfmcp te gebruiken, allemaal lokaal

pdfmcp is een gereedschapskist met drie deuren, en alle drie staan aan jouw kant. De webtools van deze site draaien in je browser, op je apparaat: je bestand wordt nooit geüpload en je hoeft je nergens voor aan te melden. De lokale MCP-server stelt dezelfde bewerkingen bloot als getypeerde tools die AI-agenten zoals Claude en Cursor rechtstreeks kunnen aanroepen, draaiend op je machine. En de lokale API laat je dezelfde bewerkingen aanroepen vanuit je eigen code, ook op je machine.

Alle drie zijn voor altijd gratis. Geen betaald niveau, geen watermerk, geen proefklok, geen account, geen sleutel en geen dagquotum: je apparaat doet het werk, dus je apparaat is de enige praktische grens.

Manier 1: Gebruik een webtool (geen aanmelding)

Open de toolindex en kies wat je nodig hebt: samenvoegen, splitsen, comprimeren, converteren, OCR, ondertekenen, redigeren en meer. Tools gemarkeerd als «Op je apparaat» verwerken je bestand volledig in dit browsertabblad: leg het bestand neer, pas de opties aan en download het resultaat. Er wordt niets naar ons verzonden, dus er is niets op te slaan, te loggen of te lekken.

Sommige bewerkingen hebben zware machinerie nodig (volledige OCR, Office-conversie, cryptografie). Die pagina's zijn gemarkeerd als «Lokaal · MCP» en leggen uit hoe je het werk lokaal met het pakket op je machine uitvoert, met dezelfde privacy.

Manier 2: Installeer het lokale pakket

Het pakket wordt eenmalig geïnstalleerd met het installatiecommando op de MCP-pagina. Daarna draait het volledig op je machine: geen account om te maken, geen sleutel om te kopiëren en niets dat verloopt.

De zware engines (qpdf, OCR-taalgegevens) worden eenmalig bij het eerste gebruik met SHA-256-controle gedownload en blijven voor de volgende keren op je machine.

Manier 3: Verbind de lokale MCP-server met je AI-agent

De MCP-server draait lokaal (stdio) op dezelfde machine als je agent. De meeste clients accepteren deze configuratievorm, waarbij de client het pakket voor je start:

{"mcpServers": {"pdfmcp": {"command": "uvx", "args": ["--from", "https://pdfmcp.org/downloads/pdfmcp-4.2.1-py3-none-any.whl", "pdfmcp"]}}}

Herstart je client nadat je zijn configuratie hebt bewerkt; de pdfmcp-tools verschijnen in zijn lijst. Stapsgewijze gidsen voor 13 clients (Claude Desktop, Claude Code, ChatGPT, Cursor, VS Code, Windsurf, Codex, Gemini CLI, Zed, Cline, Continue, JetBrains en elke andere MCP-client) zijn gelinkt vanaf de MCP-pagina. ChatGPT kan geen lokale processen starten, dus binnen ChatGPT is er geen lokale deur: gebruik in plaats daarvan een van de lokale clients.

Je eerste lokale aanroep

Vanuit je eigen code of je terminal is de stroom dezelfde als altijd, maar zonder externe server: installeer het pakket, kies een bewerking en voer hem uit op een bestand op je machine. De bewerking leest het bestand lokaal en schrijft het resultaat lokaal.

De bewerkingscatalogus van deze website (elke bewerking, haar parameters en schema's) beschrijft ook het lokale pakket, omdat het dezelfde catalogus is: wat je op de toolpagina's ziet, is wat je agent en je code kunnen aanroepen.

Limieten en privacy, serieus

De enige limieten zijn die van je apparaat: geheugen, snelheid en, in de browser, bestanden tot ongeveer 100 MB en 500 pagina's. Er is geen quotum om op te maken en geen wachtrij om op te wachten.

Privacy is architectonisch. Alles draait lokaal, dus je bestanden verlaten je machine nooit, worden nooit op een server opgeslagen en worden nooit gebruikt om AI te trainen. Het enige dat deze site verzamelt, is pagina-analyse (weergaven en geaggregeerd Google Analytics), die je documenten nooit raakt.

Verbind je AI-agent — gratis lokale MCP-server

Veelgestelde vragen

Is pdfmcp echt gratis?

Ja, voor altijd gratis. Alle tools draaien lokaal, zonder account en zonder watermerk. Er is geen betaald niveau: een optionele donatiebox (momenteel uitgeschakeld) is het hele verdienmodel.

Heb ik een account nodig?

Nee. Er zijn geen accounts in pdfmcp: niet voor de webtools, niet voor de lokale MCP-server en niet voor de lokale API.

Waar gaan mijn bestanden heen?

Nergens heen: de verwerking gebeurt op je apparaat of je machine, en je bestanden worden nooit geüpload en nooit gebruikt om AI te trainen.

Hoe roept mijn agent de lokale MCP-server aan?

Je client start het pdfmcp-pakket als een lokaal proces (stdio) met de configuratie uit de gidsen. Er is geen geheime header om te configureren, omdat er geen externe server is.

Is er een daglimiet?

Nee. Geen dagquotum, geen uurtempo en geen teller: je apparaat is de enige praktische grens.

Kan ik pdfmcp offline gebruiken?

Grotendeels ja: zodra de pagina en haar bibliotheken zijn geladen, werken de webtools in je browser, en het lokale pakket werkt op je machine. Alleen enginedownloads bij het eerste gebruik hebben een verbinding nodig.

Oorspronkelijk gepubliceerd op https://pdfmcp.org/guides/getting-started/