AI-assistent (MCP)

Welke variant moet ik kiezen?

Situatie	Aanbevolen variant
Bestanden staan online (URL's) of zijn klein (<5 MB)	HTTP-variant — geen installatie nodig
Je gebruikt Claude Desktop en converteert grote lokale bestanden (>5 MB)	Stdio-variant — eenmalig installeren, altijd beschikbaar
Weet ik niet	Begin met de HTTP-variant

HTTP-variant (Aanbevolen)

Geen installatie. Werkt in Claude.ai web, Claude Desktop en Claude op mobiel.

Nog geen PDFen-account? Geen probleem — je kunt je registreren tijdens de koppeling. Wanneer je de MCP-server toevoegt, opent een browser waar je een nieuw account kunt aanmaken. Na e-mailbevestiging gaat de koppeling automatisch verder.

Stap 1 — Maak een API-token aan

Ga naar Profiel → API-tokens en maak een nieuw token aan. Kopieer het direct — je ziet het maar één keer.

Stap 2 — Voeg toe aan je AI-assistent

Kies hieronder je AI-assistent voor de exacte installatiestappen:

1

Open het configuratiebestand van Claude Desktop

Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

2

Voeg PDFengine toe aan de configuratie

{
  "mcpServers": {
    "pdfen": {
      "url": "https://pdfen.com/mcp/sse",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

Vervang <code class="bg-gray-100 px-1 rounded">YOUR_TOKEN_HERE</code> door het token dat je zojuist hebt aangemaakt.

Herstart Claude Desktop. PDFengine verschijnt in de lijst met MCP-servers.

1

Ga in Claude.ai naar de instellingen
Instellingen → Integraties → MCP-server toevoegen
2

Vul de servergegevens in

URL: https://pdfen.com/mcp/sse

Auth-header: Authorization: Bearer YOUR_TOKEN_HERE
Klik op "Verbinden". PDFengine opent een autorisatiepagina om toestemming te vragen.

ChatGPT MCP-ondersteuning is beschikbaar voor Business, Enterprise en Edu accounts in Developer Mode.

1

Ga in ChatGPT naar verbindingen
Instellingen → Verbindingen → MCP-server toevoegen
2

Vul de server-URL in

URL: https://pdfen.com/mcp/sse

ChatGPT detecteert automatisch de OAuth-configuratie en leidt je door het autorisatieproces.
Klik op "Toestaan". De verbinding is actief.

1

Open het Gemini CLI-configuratiebestand
~/.gemini/settings.json

2

Voeg PDFengine toe

{
  "mcpServers": {
    "pdfen": {
      "url": "https://pdfen.com/mcp/sse"
    }
  }
}

Start <code class="bg-gray-100 px-1 rounded">gemini</code>. Gemini CLI detecteert automatisch de OAuth-server en vraagt om autorisatie.

Bestandsgroottelimieten (HTTP-variant)

Modus	Max. grootte	Wanneer gebruiken
`file_url`	Tot je licentielimiet (25–200 MB)	Bestand heeft een publieke HTTPS-URL
`file_base64`	5 MB	Klein bestand inline meesturen
`file_path`	Niet beschikbaar	Gebruik de stdio-variant

Stdio-variant (Lokaal, voor grote bestanden) Binnenkort beschikbaar

De stdio-variant voegt ondersteuning toe voor grote lokale bestanden rechtstreeks van schijf — geen uploadlimiet.

Nog niet publiek beschikbaar

Het npm-pakket @pdfen/mcp is momenteel in ontwikkeling. De HTTP-variant is nu al live en dekt de meeste gebruikssituaties. Voor vroeg toegang tot ondersteuning voor lokale bestanden, neem contact op:

hello@pdfen.com

Toekomstige installatie (preview)

Zodra gepubliceerd, wordt de stdio-variant als volgt ingesteld:

Stap 1 — Controleer Node.js

node --version  # Moet 18 of hoger zijn

Node.js nog niet? Download via nodejs.org.

Stap 2 — Toevoegen in Claude Desktop-configuratie

{
  "mcpServers": {
    "pdfen-lokaal": {
      "command": "npx",
      "args": ["-y", "@pdfen/mcp"],
      "env": {
        "PDFEN_API_TOKEN": "JOUW_TOKEN_HIER"
      }
    }
  }
}

Het commando npx -y haalt automatisch de nieuwste versie op — geen handmatige installatie nodig.

Bestandsgroottelimieten (stdio-variant)

Modus	Max. grootte	Wanneer gebruiken
`file_url`	Tot je licentielimiet	Bestand heeft een publieke HTTPS-URL
`file_base64`	5 MB	Klein bestand inline
`file_path`	Tot je licentielimiet	Lokaal bestand op schijf

Beschikbare tools

Zodra je verbonden bent, kan Claude deze tools automatisch inzetten. Je hoeft ze niet bij naam te noemen — beschrijf gewoon wat je wilt in gewone taal.

Tool	Wat het doet
`list_workflows`	Toont alle beschikbare PDF-conversie-workflows
`get_workflow_options`	Toont instelbare opties per workflow (OCR, compressie, paginabereik…)
`start_conversion`	Start een PDF-conversie (asynchroon). Retourneert direct een `execution_id`.
`get_execution_status`	Peilt de status: `pending`, `processing`, `done`, of `error`
`get_download_url`	Genereert een ondertekende downloadlink (1 uur geldig) zodra de conversie klaar is
`get_user`	Toont je accountgegevens en abonnementstype
`get_credits`	Toont je creditssaldo (persoonlijk + organisatie)
`get_upload_capabilities`	Toont welke bestandsinvoermodi beschikbaar zijn in deze variant

Conversiestroom

Elke conversie volgt deze volgorde — Claude handelt dit automatisch af zodra je beschrijft wat je wilt:

1.list_workflows — bekijk beschikbare workflows en vind het workflow_id (een geheel getal) voor het gewenste conversietype.
2.get_workflow_options (optioneel) — bekijk instelbare opties zoals OCR-taal, PDF/A-type of compressieniveau.
3.start_conversion — stuur het workflow_id, je bestanden en eventuele opties mee. Retourneert direct een execution_id; de verwerking loopt op de achtergrond.
4.get_execution_status — peil elke paar seconden totdat de status done of error is. Conversies duren typisch 5–30 seconden.
5.get_download_url — haal een ondertekende downloadlink op die 1 uur geldig is. Download het bestand voordat de link verloopt.

Voorbeeldprompts

Kopieer en plak deze direct in Claude:

Converteer dit Word-document naar PDF: [voeg bestand bij of plak URL]

Welke PDF-workflows heb ik beschikbaar?

Converteer https://voorbeeld.nl/rapport.docx naar PDF en geef me de downloadlink.

Controleer mijn creditssaldo voordat je deze 5 bestanden converteert.

Comprimeer deze PDF en stuur me het resultaat.

Voeg deze 3 PDFs samen tot één document.

Probleemoplossing

Foutmelding "Ongeldig token"

Je token is mogelijk verlopen of ingetrokken. Maak een nieuw token aan via Profiel → API-tokens.

Controleer of je het volledige token hebt gekopieerd zonder spaties aan het einde.

"Bestand te groot voor base64"

De HTTP-variant heeft een limiet van 5 MB voor inline bestanden. Opties:

Gebruik file_url als het bestand een publieke URL heeft
Installeer de stdio-variant (@pdfen/mcp) voor lokale bestanden zonder groottelimiet

"file_path niet beschikbaar op remote"

Je gebruikt de HTTP-variant die geen toegang heeft tot je lokale bestandssysteem. Installeer de stdio-variant:

npx -y @pdfen/mcp

Node niet gevonden (stdio-variant)

Installeer Node.js via nodejs.org (LTS-versie). Op Mac: brew install node.

Herstart na installatie je terminal én Claude Desktop.

Locatie Claude Desktop-configuratiebestand

Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

FAQ

Kosten MCP-conversies credits?

Ja — hetzelfde tarief als de API. Standaard 1 credit per document. Nieuwe accounts krijgen 15 gratis credits. Meer kopen kan via pdfen.com/pricing.

Welke foutcodes kan ik krijgen?

Fouten worden teruggegeven als {"isError": true, "code": "...", "message": "...", "user_instructions": "..."}. Veelvoorkomende codes:

Code	Betekenis
`insufficient_credits`	Niet genoeg credits — koop meer via pdfen.com/pricing
`workflow_not_found`	Ongeldig `workflow_id` — gebruik `list_workflows` voor een geldig ID
`workflow_access_denied`	Die workflow is van een andere gebruiker
`file_too_large_for_license`	Bestand overschrijdt de bestandsgroottelimiet van je plan
`not_completed`	`get_download_url` aangeroepen vóór het einde — peil eerst de status
`access_denied`	Deze execution is van een andere gebruiker
`not_found`	Execution ID bestaat niet
`server_error`	Onverwachte serverfout — probeer opnieuw of neem contact op met support

Zijn mijn bestanden veilig?

Bestanden worden verwerkt op PDFen-servers en na de conversie verwijderd — net als via de web-app.

Kan ik HTTP en stdio tegelijk gebruiken?

Ja — geef ze verschillende namen in de configuratie (pdfen en pdfen-lokaal).

Zijn er kostenverschillen tussen HTTP en stdio?

Nee — credits zijn gebaseerd op het aantal conversies, niet op het transporttype.

Welke bestandsformaten worden ondersteund?

Gebruik list_workflows in Claude om alle beschikbare conversies voor jouw account te zien.

Organize

Optimize

To PDF

From PDF

Merge

Other

On This Page

All Guides

PDFen × AI (MCP)