Możesz poprosić agenta AI, takiego jak Claude, Cursor lub GitHub Copilot, o podpisanie dokumentu i wykonać to lokalnie, na własnym komputerze, przy czym plik i certyfikat nigdy go nie opuszczają. Agent decyduje, co podpisać i w jaki sposób; serwer GroupDocs.Signature.Mcp stosuje podpis za pomocą narzędzia sign. Wszystko poniżej zaczyna się od promptów takich jak ten:

Podpisz contract.pdf cyfrowo przy użyciu signing-cert.pfx.

Wersja krok po kroku z konfiguracją i rozwiązywaniem problemów znajduje się w dokumentacji: How to sign documents with AI agents using MCP.

Co oznacza „sign”, kiedy prosisz agenta AI?

Może to oznaczać znak wizualny lub podpis kryptograficzny, a różnica ma znaczenie, zanim cokolwiek zostanie zautomatyzowane. Narzędzie sign przyjmuje cztery wartości dla type: text, qrcode, barcode i digital. Pierwsze trzy umieszczają znak wizualny na stronie. Tylko digital stosuje podpis kryptograficzny oparty na certyfikacie, który rejestruje, kto podpisał i pozwala każdemu wykryć późniejsze zmiany w pliku.

Modele językowe nie rozróżniają tego samodzielnie. Jeśli prompt mówi jedynie „sign this”, agent musi zgadnąć, o który rodzaj chodzi, więc podaj typ. Trzy poniższe sposoby są uporządkowane od najlżejszego znaku do najsilniejszego.

Sposób 1: Oznacz stronę podpisem tekstowym

Użyj podpisu tekstowego, gdy osoba lub proces potrzebuje jedynie zobaczyć, że dokument został obsłużony: imię, data, etykieta zatwierdzenia.

Dodaj podpis tekstowy z moim imieniem i dzisiejszą datą do report.docx.

Agent wywołuje sign z type: "text" i podanym tekstem. Serwer zapisuje podpisaną kopię w folderze wyjściowym, pozostawiając oryginał nietknięty. To jest znak, a nie dowód: wyświetla etykietę na stronie i nie mówi nic o tym, kto ją umieścił ani czy plik został później zmieniony.

Sposób 2: Dodaj kod QR lub kod kreskowy, który zawiera odwołanie

Użyj kodu, gdy później odczyta go maszyna, a nie człowiek. Kod QR może przechowywać tekst strukturalny, a kod kreskowy (rodziny Code39, Code128 i EAN) pasuje do przepływów pracy opartych na skanowaniu linii.

Podpisz contract.pdf kodem QR zawierającym ORDER-2026-0418.

Agent wywołuje sign z type: "qrcode" i text: "ORDER-2026-0418". Podawaj tekst wyraźnie w każdym promptcie, który żąda kodu, i odczytuj wartość za pomocą search_qr_codes, zanim na niej polegasz. Podobnie jak znak tekstowy, kod jest znakiem wizualnym: potwierdza, że znak jest obecny, ale nie kto go zastosował.

Sposób 3: Zastosuj cyfrowy podpis oparty na certyfikacie

Użyj podpisu cyfrowego, gdy musisz wykazać, kto podpisał i że plik nie został zmieniony od tego czasu. Agent przekazuje plik certyfikatu i jego hasło do sign:

Podpisz contract.pdf cyfrowo przy użyciu signing-cert.pfx.

Wywołanie używa type: "digital", certificate i certificatePassword. Oba są odczytywane z lokalnego dysku przez proces serwera lokalnego, a podpis odbywa się w tym samym procesie. Nie ma zaangażowanej usługi podpisującej, więc ani klucz, ani hasło nie są transmitowane. Przechowuj hasło w zmiennej środowiskowej, a nie w zatwierdzonej konfiguracji klienta.

Kolejność ma znaczenie. Znaki wizualne przepisują plik, więc każdy znak tekstowy lub kod dodany po podpisie cyfrowym unieważnia go. Najpierw zastosuj wszystkie znaki wizualne, a na końcu podpis cyfrowy, i zaznacz to w promptcie, gdy agent łączy wiele podpisów.

Przykładowa sesja (skrócona)

You:    Sign contract.pdf with a QR code containing ORDER-2026-0418.

Agent:  [sign] file=contract.pdf, type=qrcode, text="ORDER-2026-0418"
        -> Signed contract.pdf with qrcode signature
        The signed copy was saved to the output folder.
        The original contract.pdf was not modified.

Ilustrujące wyjście: nazwa pliku i wartość QR są wymyślone. Narzędzie zwraca pola opisane powyżej.

Czego agent AI nie może dla Ciebie podpisać?

Agent może zastosować podpis; nie może uczynić go prawnie wiążącym. Ten serwer nie jest hostowaną usługą e‑podpisu ani kwalifikowanym dostawcą usług zaufania. Stosuje podpis przy użyciu dostarczonego certyfikatu, na jednej maszynie, dla jednego procesu klienta.

Czy wynik spełnia dany reżim prawny, np. kwalifikowany podpis eIDAS, zależy od certyfikatu i procesu wokół niego, a nie od tego serwera. Jeśli istnieje ryzyko sporu, zapytaj, który certyfikat i który proces mają zastosowanie, zanim zautomatyzujesz.

Ograniczenia wersji ewaluacyjnej, o których powinieneś wiedzieć

Bez licencji serwer działa w trybie ewaluacyjnym: przetwarzane są tylko pierwsze 2 strony, a na każdej stronie znajduje się znaczek wersji próbnej. Podpis przeznaczony na stronę 5 umowy nie zostanie umieszczony i nie pojawi się żaden błąd informujący o tym. Przed jakimkolwiek istotnym uruchomieniem podpisu zapytaj:

Jaki jest status licencji serwera podpisu?

Agent wywołuje get_license_status, które zgłasza tryb (ewaluacyjny, licencjonowany lub rozliczany) bez dotykania dokumentu.

FAQ

Czy AI może podpisywać dokumenty za mnie?
Agent może zastosować podpis tekstowy, kod QR, kod kreskowy lub podpis oparty na certyfikacie do dokumentu za pomocą narzędzia sign, lokalnie. Czy podpis ma wagę prawną, zależy od certyfikatu i Twojej jurysdykcji, nie od agenta.

Czy Claude może podpisać PDF bez przesyłania go gdziekolwiek?
Tak. Serwer MCP działa jako proces potomny klienta przez stdio, bez portów przychodzących, zewnętrznych punktów końcowych i telemetryki. Ścieżka to: agent → serwer lokalny → lokalny system plików.

Z jakimi klientami to działa?
Claude Desktop, Claude Code, VS Code z GitHub Copilot, Visual Studio 2022 (17.14+), Cursor, Windsurf, Cline, Codex CLI oraz JetBrains Rider. Instaluj za pomocą dnx GroupDocs.Signature.Mcp --yes lub obrazu Docker ghcr.io/groupdocs-signature/signature-net-mcp.

Dowiedz się więcej