Du kannst einen KI‑Agenten seine Prüfkommentare direkt im Dokument hinterlassen lassen, anstatt im Chat. Der GroupDocs.Annotation.Mcp‑Server ermöglicht es einem LLM in Claude, Cursor oder GitHub Copilot, Hervorhebungen, Notizen und Durchstreichungen zu einer PDF‑, Word‑, Excel‑ oder PowerPoint‑Datei hinzuzufügen und sie lokal auf deinem Rechner zu speichern:

Hervorhebe die Zahlungsklausel auf Seite 2 und füge eine Notiz hinzu, in der die Rechtsabteilung um Bestätigung gebeten wird.

Warum geht KI‑Feedback in einem Chat‑Fenster verloren?

Bitte einen Assistenten, einen Vertrag zu prüfen, und du erhältst eine Liste: „Klausel 4 verlagert die Haftung, Klausel 7 hat ein offenes Datum.“ Die Liste bleibt in einer Unterhaltung. Der Kollege, der den Vertrag nächste Woche öffnet, sieht nichts davon, und du musst jeden Punkt von Hand zum richtigen Absatz zurückkopieren.

Der Agent ist nicht das Problem. Er hat keine Möglichkeit, in die Datei zu schreiben. Eine Prüfung ist nur dann nützlich, wo der Leser sie findet – also direkt neben dem Text, auf den sie sich bezieht.

Wie sieht der falsche Ansatz aus?

Der gängige Work‑Around besteht darin, den Dokumententext in einen Chat zu kopieren und um Kommentare zu bitten. Drei Dinge gehen dabei schief, und du kannst jedes an einem eigenen Dokument überprüfen:

  • Die Kommentare haben keine Position. „Seite 2, zweiter Absatz“ ist eine Beschreibung, die du selbst auflösen musst.
  • Das Ergebnis ist ein Transkript, kein Liefergegenstand. Außer einem Screenshot oder einem eingefügten Block kann nichts an den nächsten Prüfer gesendet werden.
  • Das Dokument bleibt unverändert, sodass die Prüfung nicht gefiltert, gezählt oder in den nächsten Entwurf übernommen werden kann.

Was ist der richtige Ansatz: Dokumente mit einem KI‑Agenten annotieren?

Teile die Arbeit nach den Stärken beider Seiten auf. Der Agent versteht die Anweisung „markiere alles, was das Risiko auf uns verlagert“. Die Engine schreibt eine echte Annotation in die echte Datei. Das Werkzeug, das das Schreiben übernimmt, ist add_annotation. Es akzeptiert sieben Annotationsarten: textfield, area, point, arrow, highlight, underline und strikeout. Seine Argumente sind die Datei, der Typ, der Text, eine 1‑basierte Seitenzahl und die Dokumentkoordinaten x/y.

Das Ergebnis wird als <name>_annotated.<ext> neben deiner Originaldatei gespeichert. Das Original wird nie verändert. Der gleiche Aufruf funktioniert über die 50 + Formate hinweg, die die Engine unterstützt, sodass ein Word‑Entwurf und eine PDF‑Datei auf dieselbe Weise markiert werden.

Welche Werkzeuge sorgen für die korrekte Platzierung?

Koordinaten sind der Schwachpunkt jedes Agenten, der die Seite nicht sehen kann, und die Dokumentation sagt das klar. Drei Werkzeuge reduzieren das Rätselraten:

  • get_document_info liefert den Dateityp, die Seitenzahl und die Größe sowie pro Seite Breite und Höhe, wenn die Engine sie meldet, was dem Agenten ein Seiten‑Bounding‑Box zum Denken gibt.
  • get_annotations gibt vorhandene Anmerkungen mit ihren Begrenzungsrahmen zurück, die der Agent als Anker nutzen kann.
  • generate_pages_preview rendert eine Seite als Bild, sodass ein vision‑fähiges Modell den Text lokalisieren kann, bevor es annotiert. Derzeit schlägt dies bei PDF‑Dateien unter Linux fehl; siehe die Einschränkungen weiter unten.

Was ist die eine Falle bei verketteten Anmerkungen?

Jedes Schreibwerkzeug speichert eine neue Datei. Eine zweite Annotation muss auf die Datei angewendet werden, die der erste Aufruf erzeugt hat, nicht auf das Original, sonst bleibt die erste Annotation in einer Datei zurück, die niemand mehr öffnet. Formuliere das im Prompt:

Hervorhebe die Zahlungsklausel und streiche dann im resultierenden Dokument das alte Lieferdatum durch.

Beispiel‑Sitzung (gekürzt)

Dies ist eine Illustration, die aus dem dokumentierten Verhalten der Werkzeuge gebaut wurde, kein aufgezeichnetes Bildschirmfoto.

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.

Wie starte ich den Annotation‑Server in meinem KI‑Client?

Um ihn als Container auszuführen, mounte den Ordner mit deinen Dokumenten nach /data:

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

Wenn du lieber keinen Container verwenden möchtest, installiere das .NET 10 SDK und starte dnx GroupDocs.Annotation.Mcp --yes; unter Windows ist dies zudem der Kanal für PDF‑Seiten‑Vorschauen. Die Hub‑Seite enthält fertige Registrierungs‑Snippets für Claude Desktop, Claude Code, VS Code mit GitHub Copilot, Cursor, Windsurf und andere Clients. Setze GROUPDOCS_MCP_OUTPUT_PATH auf einen anderen Ordner als den Speicher‑Ordner, bevor du Bearbeitungen an einer erzeugten Datei verkettst. Mit der Standardeinstellung (Ausgaben landen im Speicher‑Ordner) schlägt der zweite Schreibvorgang mit being used by another process fehl; mit einem separaten Ausgabe‑Ordner funktionieren add_reply, update_annotation und remove_annotations auf der erzeugten Datei. Beim Docker‑Image übergib -e GROUPDOCS_MCP_OUTPUT_PATH=/data/output. Nach der Registrierung startet der Client den Server selbst und kommuniziert über stdio, sodass nichts an einem Netzwerk‑Port lauscht und der Server keinen Dokumentinhalt an einen Cloud‑Dienst sendet.

Ehrliche Grenzen

  • Evaluierungs‑Modus. Ohne Lizenz wird auf jeder Seite ein Prüf‑Badge oben angebracht, sodass die annotierte Ausgabe nicht verbreitet werden darf. Frage zuerst „What is the license status of the annotation server?“, der Agent ruft get_license_status auf.
  • Platzierung ist ohne Hilfe nur approximativ. Ein Agent, der x/y aus einem Prompt rät, platziert eine area‑ oder point‑Annotation nur ungefähr. Lies zuerst oder rendere zuerst für präzise Platzierung.
  • Vorschau unter Linux. generate_pages_preview schlägt derzeit bei PDF‑Dateien unter Linux fehl, einschließlich des Docker‑Images (TypeInitializationException für Gdip: System.Drawing.Common wird auf Nicht‑Windows‑Plattformen nicht unterstützt); Word‑ und andere Office‑Dokumente rendern, und unter Windows mit dnx rendert jedes Format. Die anderen zehn Werkzeuge sind davon unbeeinflusst.

FAQ

Kann Claude Kommentare zu einer PDF hinzufügen? Ja, über einen MCP‑Server, der ein Annotations‑Tool bereitstellt. Mit GroupDocs.Annotation.Mcp ruft der Agent add_annotation auf und der Kommentar wird in <name>_annotated.pdf geschrieben.

Muss die KI mein Dokument hochladen, um es zu annotieren? Nein, nicht über den Server: Sie öffnet die Datei in deinem gemounteten Ordner und speichert die annotierte Kopie daneben. Nur das, was das Modell selbst sieht – etwa Text, den du einfügst, oder Seiten‑Bilder, die der Agent betrachtet – wird an deinen Modell‑Anbieter gesendet.

Funktioniert das auch mit Word und Excel, nicht nur mit PDF? Ja. Die gleichen Annotationsarten funktionieren über PDF, DOCX, XLSX, PPTX und Bilder hinweg, mit den 50 + Formaten, die in der Dokumentation aufgelistet sind.

Weiterführende Informationen