Een AI‑agent moet kiezen welk bestand moet worden geconverteerd en naar welk formaat, en een conversie‑engine moet de daadwerkelijke conversie uitvoeren. Met de GroupDocs.Conversion.Mcp‑server kunnen Claude, Cursor of GitHub Copilot die engine lokaal, op uw machine, aanroepen vanuit één zin:

Convert contract.docx to PDF

De stap‑voor‑stap‑versie met configuratie en probleemoplossing staat in de documentatie: Hoe documenten te converteren met AI‑agents via MCP. Deze post legt uit waarom de splitsing belangrijk is en waar de agent zich moet terughouden.

Wat gaat er mis wanneer een agent zelf een bestand converteert?

Een taalmodel dat een PDF “converteert” naar Word converteert niets. Het leest de inhoud die het krijgt en schrijft nieuwe inhoud in het doelformaat. Wat het model niet heeft gezien, kan het niet reproduceren: het exacte lettertype, de kolomgeometrie, de pagina‑breuk vóór een tabel, de stijlnamen waar een Word‑sjabloon van afhankelijk is. Wat terugkomt, ziet eruit als een conversie, maar is eigenlijk opnieuw typen.

Dat is de foutmodus waar deze post over gaat. Het is stil: de output opent zonder fouten, dus niemand controleert het totdat een tabel is verschoven of een koptekst zijn stijl heeft verloren. Render‑fidelity is deterministisch engine‑werk, geen generatie‑werk.

Wat moet de agent beslissen, en wat moet de engine doen?

Splits de taak langs de lijn tussen oordeel en uitvoering.

Vraag De agent beslist De engine doet
Welke bestanden vallen binnen de scope? Leest uw prompt en de opslagmap Niets
Welk doelformaat? Zet “maak bewerkbaar” om naar DOCX, “archiveer” naar PDF Niets
Is het bestand überhaupt converteerbaar? Roept get_supported_formats aan en leest het antwoord Rapporteert de geldige doelformaten
Hoe groot is het bestand? Roept get_document_info aan en leest het paginatelling Leest type, paginatelling, eigenschappen
De conversie zelf Roept convert aan Rendert de output met de GroupDocs.Conversion‑engine
Wat te doen bij falen Probeert opnieuw, vraagt u, of slaat het bestand over Retourneert de reden als tekst

De agent raakt nooit de bytes van uw document. Hij geeft een bestandsnaam en een formaat door, en de engine levert een bestand terug.

Hoe verbind je een agent lokaal met de engine?

Registreer de server één keer in uw client. Claude Desktop gebruikt claude_desktop_config.json, Claude Code gebruikt claude mcp add, VS Code met GitHub Copilot gebruikt mcp.json, en Cursor gebruikt ~/.cursor/mcp.json. De server ondersteunt ook Visual Studio 2022, Windsurf, Cline, Codex CLI en JetBrains Rider. Een Claude‑Desktop‑vermelding ziet er zo uit:

{
  "mcpServers": {
    "groupdocs-conversion": {
      "type": "stdio",
      "command": "dnx",
      "args": ["GroupDocs.Conversion.Mcp", "--yes"],
      "env": { "GROUPDOCS_MCP_STORAGE_PATH": "/path/to/documents" }
    }
  }
}

dnx heeft de .NET 10 SDK nodig. Als u Docker verkiest, is het zelfstandige image ghcr.io/groupdocs-conversion/conversion-net-mcp:latest, te starten met docker run --rm -i -v $(pwd)/documents:/data. De client communiceert met de server via stdio: het pad is agent, lokale server, lokaal bestandssysteem. Herstart de client na registratie.

Welk hulpmiddel wordt door elk verzoek geactiveerd?

De server biedt vier tools. Hun namen zijn letterlijk; agents zoeken ernaar wanneer er iets misgaat.

  • convert converteert een document naar een ander formaat en slaat het resultaat op in uw opslag‑ of output‑map. Het neemt file, format (bijvoorbeeld pdf, docx, xlsx, pptx, html, png, jpg, csv, txt, rtf, md) en een optioneel password.
  • get_supported_formats geeft een lijst van de doelformaten waarin een gegeven bronbestand kan worden omgezet.
  • get_document_info retourneert bestandstype, paginatelling en basis‑eigenschappen zonder te converteren.
  • get_license_status meldt of de server in evaluatiemodus, licentiebestand‑ of meter‑modus draait.

Open‑ended prompts werken omdat de agent ze aaneen ketent:

Welke formaten kan ik van dit Visio‑bestand maken? Converteer het daarna naar PDF.

Controleer eerst het paginacontrole van whitepaper.pdf, en converteer het daarna naar DOCX.

Bestaande bestanden worden nooit overschreven. Een tweede conversie van hetzelfde bestand krijgt een andere naam, bijvoorbeeld report (1).pdf.

Voorbeeldsessie

Dit is een ingekorte, illustratieve sessie opgebouwd uit de tool‑beschrijvingen in de documentatie, geen screenshot.

You:    Convert contract-draft.pdf to DOCX so I can edit it.
Agent:  [calls convert with file.filePath = "contract-draft.pdf", format = "docx"]
Agent:  Done. The converted file is saved as contract-draft.docx in your output folder.

Voor de volledige cyclus toont de n8n‑walkthrough dezelfde engine aangestuurd door een workflow in plaats van een chat, en de aankondiging behandelt de server in het algemeen.

Wat zijn de beperkingen?

  • Evaluatiemodus. Zonder licentie voegt de server een evaluatiewatermerk toe aan de geconverteerde output en beperkt elk serverproces tot 15 geopende documenten; het herstarten van de server reset de teller. Vraag uw agent eerst “wat is de licentiestatus van de conversieserver?”; get_license_status beantwoordt zonder een document te verwerken.
  • Geen OCR. De server converteert documenten die een tekstlaag hebben. Een scan die is opgeslagen als een alleen‑afbeelding‑PDF zal niet als bewerkbare tekst verschijnen.
  • Conversie, geen extractie. Deze server transformeert volledige documenten. Voor veld‑niveau data‑extractie is de bijbehorende GroupDocs.Parser.Mcp server (alleen als Docker‑image beschikbaar) beter geschikt, en veel pipelines gebruiken beide.

Veelgestelde vragen

Kan Claude een docx naar pdf converteren?
Ja, met een gekoppelde conversieserver. Claude roept convert aan met format: "pdf", en de GroupDocs‑engine maakt het bestand op uw machine.

Worden mijn bestanden geüpload wanneer een agent ze converteert?
Niet met deze server. Hij draait lokaal via stdio, en de documenten blijven in uw opslagmap. Uw licentiebestand wordt ook van de lokale schijf gelezen.

Welke formaten kan de server converteren?
Meer dan 100 document‑, spreadsheet‑, presentatie‑, afbeelding‑, e‑mail‑, CAD‑ en web‑formaten, dezelfde set als de GroupDocs.Conversion .NET‑bibliotheek. Vraag get_supported_formats voor de exacte lijst voor een specifiek bestand.

Dieper duiken