You can have an AI agent put its review comments inside the document instead of in the chat. The GroupDocs.Annotation.Mcp server lets an LLM in Claude, Cursor or GitHub Copilot add highlights, notes and strikeouts to a PDF, Word, Excel or PowerPoint file, and it writes them locally on your machine:

Highlight the payment clause on page 2 and add a note asking legal to confirm.

Proč se zpětná vazba AI v okně chatu ztrácí?

Požádejte asistenta, aby zkontroloval smlouvu, a získáte seznam: „Klauzule 4 přesouvá odpovědnost, klauzule 7 má otevřené datum.“ Seznam žije v konverzaci. Kolega, který otevře smlouvu příští týden, nic nevidí a vy musíte každou položku ručně přenést zpět do správného odstavce.

Problém není v agentovi. Postrádá způsob, jak zapisovat do souboru. Recenze je užitečná jen tehdy, když ji čtenář potká vedle textu, na který se odkazuje.

Jak vypadá špatný přístup?

Běžná obcházející metoda je vložit text dokumentu do chatu a požádat o komentáře. Tři věci se pokazí a můžete si je ověřit na vlastním dokumentu:

  • Komentáře nemají žádnou pozici. „Strana 2, druhý odstavec“ je popis, který musíte vyřešit sami.
  • Výsledek je přepis, ne výstupní produkt. K dalšímu recenzentovi můžete poslat jen snímek obrazovky nebo vložený blok.
  • Dokument zůstane nezměněn, takže recenzi nelze filtrovat, spočítat ani přenést do další verze.

Jaký je správný přístup: anotovat dokumenty pomocí AI agenta?

Rozdělte práci podle toho, v čem je každá strana dobrá. Agent rozumí instrukci „označ vše, co přesouvá riziko na nás“. Engine zapíše skutečnou anotaci do skutečného souboru. Nástroj, který zápis provádí, je add_annotation. Přijímá sedm typů anotací: textfield, area, point, arrow, highlight, underline a strikeout. Jeho argumenty jsou soubor, typ, text, číslo stránky (číslování od 1) a souřadnice dokumentu x/y.

Výsledek je uložen jako <name>_annotated.<ext> vedle vašeho originálu. Originál není nikdy upraven. Stejné volání funguje napříč více než 50 formáty, které engine podporuje, takže Wordový koncept a PDF jsou označeny stejným způsobem.

Které nástroje zajišťují správné umístění?

Souřadnice jsou slabým místem každého agenta, který nevidí stránku, a dokumentace to říká naprosto jasně. Tři nástroje snižují hádání:

  • get_document_info vrací typ souboru, počet stran a velikost, plus šířku a výšku každé stránky, pokud je engine hlásí, což agentovi poskytuje „page box“ pro úvahy.
  • get_annotations vrací existující anotace s jejich ohraničujícími rámečky, které může agent použít jako kotvy.
  • generate_pages_preview vykreslí stránku jako obrázek, takže model s vizuální schopností může před anotací najít text. V současnosti selhává u PDF souborů na Linuxu; viz omezení níže.

Jaká je jedna past při řetězení anotací?

Každý nástroj pro zápis uloží nový soubor. Druhá anotace musí být aplikována na soubor, který vytvořilo první volání, ne na originál, jinak první anotace zůstane v souboru, který už nikdo neotevře. Řekněte to v promptu:

Highlight the payment clause, then on the resulting file strike out the old delivery date.

Příklad relace (zkrácený)

Jedná se o ilustraci založenou na dokumentovaném chování nástrojů, ne o zachycený screenshot.

You:   Highlight the payment clause on page 2 of contract.pdf and add a note
       asking legal to confirm.

Agent: [calls get_document_info on contract.pdf]
       contract.pdf is a PDF with 6 pages.
       [calls add_annotation: type=highlight, page=2, x=100, y=250,
        text="Legal to confirm these payment terms"]
       Added highlight annotation to contract.pdf on page 2.
       The annotated copy is contract_annotated.pdf. Your original is unchanged.

Jak spustím anotační server v mém AI klientovi?

Pro běh v kontejneru připojte složku s vašimi dokumenty na /data:

docker run --rm -i -v $(pwd)/documents:/data \
  -e GROUPDOCS_MCP_OUTPUT_PATH=/data/output \
  ghcr.io/groupdocs-annotation/annotation-net-mcp:latest

Pokud raději nepoužíváte kontejner, nainstalujte .NET 10 SDK a spusťte dnx GroupDocs.Annotation.Mcp --yes; na Windows je to také kanál pro náhledy PDF stránek. Hub stránka obsahuje připravené registrační úryvky pro Claude Desktop, Claude Code, VS Code s GitHub Copilot, Cursor, Windsurf a další klienty. Nastavte GROUPDOCS_MCP_OUTPUT_PATH na složku jinou než úložnou složku před řetězením úprav na vytvořeném souboru. S výchozím nastavením (výstupy končí v úložné složce) druhý zápis selže s chybou being used by another process; s oddělenou výstupní složkou add_reply, update_annotation a remove_annotations na vytvořeném souboru všechny uspějí. S Docker image předávejte -e GROUPDOCS_MCP_OUTPUT_PATH=/data/output. Po registraci klient spustí server sám a komunikuje s ním přes stdio, takže nic neposlouchá na síťovém portu a server neposílá žádný obsah dokumentu do cloudové služby.

Upřímná omezení

  • Režim hodnocení. Bez licence je na vršku každé stránky nalepena zkušební značka, takže anotovaný výstup není distribuovatelný. Nejprve se zeptejte „What is the license status of the annotation server?“, agent zavolá get_license_status.
  • Umístění je přibližné bez pomoci. Agent, který hádá x/y z promptu, umístí anotaci typu area nebo point přibližně. Pro přesné umístění si nejprve přečtěte nebo vykreslete.
  • Náhled na Linuxu. generate_pages_preview v současnosti selhává u PDF souborů na Linuxu, včetně Docker image (TypeInitializationException pro Gdip: System.Drawing.Common není podporován na ne‑Windows platformách); Word a další Office dokumenty se vykreslují, a na Windows s dnx se vykreslí každý formát. Ostatních deset nástrojů není ovlivněno.

Často kladené otázky

Může Claude přidávat komentáře do PDF? Ano, přes MCP server, který vystavuje nástroj pro anotaci. S GroupDocs.Annotation.Mcp agent volá add_annotation a komentář je zapsán do <name>_annotated.pdf.

Musí AI nahrávat můj dokument, aby jej mohla anotovat? Ne, ne přes server: otevře soubor ve vašem připojeném adresáři a uloží anotovanou kopii vedle něj. Pouze to, co model sám vidí – například text, který vložíte, nebo obrázky stránek, které agent zobrazí – jde k poskytovateli modelu.

Funguje to i pro Word a Excel, ne jen pro PDF? Ano. Stejné typy anotací fungují napříč PDF, DOCX, XLSX, PPTX a obrázky, s více než 50 formáty uvedenými v dokumentaci.

Ponořte se hlouběji