An AI agent by měl vybrat, který soubor převést a do jakého formátu, a konverzní engine by měl provést samotnou konverzi. S GroupDocs.Conversion.Mcp serverem Claude, Cursor nebo GitHub Copilot volají tento engine lokálně, na vašem počítači, z jedné věty:

Convert contract.docx to PDF

Krok‑za‑krokem verze s konfigurací a řešením problémů je v dokumentaci: How to convert documents with AI agents using MCP. Tento příspěvek vysvětluje, proč je rozdělení důležité a kde by se agent měl nechat stranou.

Co se pokazí, když agent sám převádí soubor?

Model jazyka, který „převádí“ PDF do Wordu, ve skutečnosti nic nepřevádí. Přečte obsah, který mu byl předán, a zapíše nový obsah v cílovém formátu. Co model neviděl, nemůže reprodukovat: přesné písmo, geometrii sloupců, zalomení stránky před tabulkou, názvy stylů, na které se šablona Wordu spoléhá. Výsledek vypadá jako konverze, ale jde o přepis.

To je selhání, o kterém tento příspěvek pojednává. Je tiché: výstup se otevře bez chyb, takže si ho nikdo nekontroluje, dokud se například nepřesune tabulka nebo nadpis neztratí svůj styl. Věrnost vykreslení je deterministická práce engine, ne generování.

Co by měl agent rozhodnout a co by měl engine udělat?

Rozdělte úkol na část rozhodování a část vykonání.

Otázka Agent rozhoduje Engine provádí
Které soubory jsou v rozsahu? Čte váš prompt a složku úložiště Nic
Jaký cílový formát? Mapuje „udělej to editovatelné“ na DOCX, „archivuj“ na PDF Nic
Je soubor vůbec převoditelný? Volá get_supported_formats a čte odpověď Vrací platné cílové formáty
Jak velký je soubor? Volá get_document_info a čte počet stránek Čte typ, počet stránek, vlastnosti
Samotná konverze Volá convert Vykreslí výstup pomocí engine GroupDocs.Conversion
Co dělat při selhání Opakuje, ptá se vás nebo soubor přeskočí Vrací důvod jako text

Agent se nikdy nedotýká bajtů vašeho dokumentu. Předá jen název souboru a formát a engine vrátí soubor.

Jak připojit agenta k engine lokálně?

Server zaregistrujte jednou ve svém klientovi. Claude Desktop používá claude_desktop_config.json, Claude Code používá claude mcp add, VS Code s GitHub Copilot používá mcp.json a Cursor používá ~/.cursor/mcp.json. Server také podporuje Visual Studio 2022, Windsurf, Cline, Codex CLI a JetBrains Rider. Vstup pro Claude Desktop vypadá takto:

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

dnx potřebuje .NET 10 SDK. Pokud dáváte přednost Dockeru, samostatný obraz je ghcr.io/groupdocs-conversion/conversion-net-mcp:latest, spustíte ho pomocí docker run --rm -i -v $(pwd)/documents:/data. Klient komunikuje se serverem přes stdio: cesta je agent → lokální server → lokální souborový systém. Po registraci klienta jej restartujte.

Který nástroj spouští každé volání?

Server vystavuje čtyři nástroje. Jejich názvy jsou doslovné; agenti je hledají, když něco selže.

  • convert převádí dokument do jiného formátu a uloží výsledek do vašeho úložiště nebo výstupní složky. Přijímá file, format (např. pdf, docx, xlsx, pptx, html, png, jpg, csv, txt, rtf, md) a volitelně password.
  • get_supported_formats vypisuje cílové formáty, do kterých může daný zdrojový soubor být převeden.
  • get_document_info vrací typ souboru, počet stránek a základní vlastnosti bez konverze.
  • get_license_status oznamuje, zda server běží v režimu hodnocení, s licenčním souborem nebo v měřeném režimu.

Otevřené výzvy fungují, protože je agent řetězí:

What formats can I turn this Visio file into? Then convert it to PDF.

Check the page count of whitepaper.pdf first, then convert it to DOCX.

Existující soubory se nikdy nepřepisují. Druhá konverze stejného souboru získá odlišný název, např. report (1).pdf.

Příklad relace

Jedná se o zkrácenou, ilustrační relaci vytvořenou z popisů nástrojů v dokumentaci, ne o snímek obrazovky.

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.

Pro kompletní smyčku ukazuje návod n8n stejný engine řízený workflow místo chatu a oznámení popisuje server obecně.

Jaké jsou limity?

  • Režim hodnocení. Bez licence server přidá do převodovaného výstupu vodoznak „evaluation“ a omezí každý proces serveru na 15 otevřených dokumentů; restart serveru počítadlo vynuluje. Nejprve se zeptejte agenta „jaký je stav licence konverzního serveru?“, get_license_status odpoví bez zpracování dokumentu.
  • Žádné OCR. Server převádí dokumenty, které mají textovou vrstvu. Sken uložený jako PDF jen s obrázky se neobjeví jako editovatelný text.
  • Konverze, ne extrakce. Tento server transformuje celé dokumenty. Pro extrakci dat na úrovni polí je vhodnější doprovodný server GroupDocs.Parser.Mcp (dostupný jen jako Docker image) a mnoho pipeline používá oba.

Často kladené otázky

Může Claude převést docx na pdf?
Ano, pokud je připojen konverzní server. Claude zavolá convert s format: "pdf" a engine GroupDocs vytvoří soubor na vašem počítači.

Nahrávají se moje soubory, když je agent převádí?
Ne s tímto serverem. Běží lokálně přes stdio a dokumenty zůstávají ve vaší složce úložiště. Váš licenční soubor je také čten z lokálního disku.

Do jakých formátů může server převádět?
Více než 100 formátů dokumentů, tabulek, prezentací, obrázků, e‑mailů, CAD a webových formátů – stejná sada jako knihovna GroupDocs.Conversion pro .NET. Pro přesný seznam pro konkrétní soubor se zeptejte get_supported_formats.

Ponořte se hlouběji