You can compare two versions of a document with an AI agent and get a short answer, a marked-up file, or both, while the files stay on your machine. Install the GroupDocs.Comparison.Mcp server, put both versions in one folder, and ask Claude Desktop, Claude Code, Cursor or GitHub Copilot locally:

Compare contract-v1.docx with contract-v2.docx. Summarize what changed, then give me a marked-up copy.

The step-by-step version with config and troubleshooting is in the documentation: How to compare documents with AI agents using MCP.

Dlaczego agent AI nie powinien porównywać dokumentów, czytając je?

Model językowy, który „porównuje” dwa dokumenty, czytając ich tekst, tworzy opis różnic, a nie ich pomiar. Może zgłosić zmianę, której nie ma, i pominąć tę, która istnieje. Serwer MCP przenosi to zadanie do silnika porównującego. Agent wciąż robi to, w czym jest dobry: rozumie Twoje pytanie i wyjaśnia wynik. Silnik wykonuje porównanie świadome formatu i zwraca każdą zmianę jako dane: typ, stronę, komponent, zmieniony fragment, otaczający tekst oraz komórkę tabeli, gdy zmiana znajduje się w tabeli. Zmiany stylu, takie jak klauzula przechodząca z normalnej czcionki na pogrubioną, są zgłaszane jako zmiany.

To, którego z trzech poniższych sposobów użyjesz, zależy od jednego pytania: czy chcesz otrzymać odpowiedź, czy dokument?

Sposób 1: Poproś o odpowiedź i otrzymaj analyze_changes

Gdy pytanie zaczyna się od „what”, „did” lub „how many”, agent wywołuje analyze_changes. Narzędzie zwraca różnice jako ustrukturyzowane dane i nie zapisuje żadnego pliku.

What changed between proposal-draft.docx and proposal-final.docx? Keep it short.

Odpowiedź zaczyna się od <N> change(s) detected (lub No changes detected) i zawiera tablicę JSON. Agent filtruje i podsumowuje tę tablicę, więc dalsze pytania typu „tylko usunięcia” lub „czy jakaś liczba się zmieniła?” nie dotykają plików ponownie. Używaj tego sposobu domyślnie: pomija renderowanie, więc jest szybszy i tańszy niż alternatywa.

Sposób 2: Poproś o dokument i otrzymaj compare

Gdy żądanie brzmi „give me a file”, agent wywołuje compare. Narzędzie renderuje oznaczony dokument wynikowy i zapisuje go w folderze wyjściowym jako <source-stem>_compared<ext>, na przykład contract-v1_compared.docx. Istniejący plik nigdy nie jest nadpisywany; zamiast tego używana jest nowa nazwa.

Give me a marked-up copy of contract-v1.docx and contract-v2.docx that I can send to legal.

Twoi recenzenci otwierają wynik w Wordzie lub innym przeglądarce. Nie potrzebują klienta MCP ani narzędzia AI. Ta sama lista zmian jest zwracana agentowi, więc nadal możesz zadawać o nią pytania.

Sposób 3: Poproś o oba i pozwól agentowi połączyć wywołania

Sprawny agent wykonuje dwa wywołania z jednego polecenia: analyze_changes dla podsumowania i compare dla pliku. To jest polecenie z początku tego wpisu. Użyj go, gdy chcesz najpierw otrzymać krótkie podsumowanie, a potem przekazać plik komuś innemu.

Przed porównaniem możesz także poprosić agenta o zbadanie pliku:

How many pages is contract-v2.docx?

To wywołuje get_document_info, które zwraca typ pliku, liczbę stron, rozmiar oraz wymiary każdej strony, bez porównywania czegokolwiek.

Jak to skonfigurować?

Run dnx GroupDocs.Comparison.Mcp --yes (with the .NET 10 SDK) or the Docker image ghcr.io/groupdocs-comparison/comparison-net-mcp, register the server in your client, and set GROUPDOCS_MCP_STORAGE_PATH to the folder that holds both versions.

Jak to wygląda w kliencie?

Example session (abridged and illustrative; the real wording depends on your client and model):

You:    Compare contract-v1.docx with contract-v2.docx. Summarize
        what changed, then give me a marked-up copy.

Agent:  [calls analyze_changes: contract-v1.docx, contract-v2.docx]
        [calls compare: contract-v1.docx, contract-v2.docx]

        The engine detected changes, including the payment schedule
        in a table on page 4 and a clause that changed from regular
        to bold. The marked-up copy is saved as
        contract-v1_compared.docx in your output folder.

Jakie są ograniczenia?

  • Evaluation cap. Without a license the server runs in evaluation mode: only the first 2 pages are compared, and the result carries a watermark. On a long document that gives a short, reassuring change list. Ask “what is the license status of the comparison server?” first; the agent calls get_license_status, and "mode": "evaluation" means the cap applies.
  • Same format on both sides. Compare like with like; convert first if the two files differ in format.

FAQ

Czy Claude może porównać dwa pliki PDF bez ich przesyłania?
Tak, przy użyciu serwera MCP porównanie odbywa się w lokalnym procesie na plikach w wybranym przez Ciebie folderze. Twoje zapytanie i wszelkie fragmenty, które agent cytuje, nadal trafiają do modelu używanego przez Twojego klienta.

Jaka jest różnica między analyze_changes a compare?
Oba wykrywają te same zmiany. analyze_changes zwraca je jako dane i nie zapisuje pliku; compare dodatkowo renderuje oznaczony dokument.

Czy działa to tylko z plikami Word?
Nie. Narzędzia akceptują PDF, DOCX, XLSX, PPTX, ODT, RTF, TXT, HTML oraz ponad 30 innych formatów.

Zagłęb się