Ein KI‑Agent sollte auswählen, welche Datei konvertiert werden soll und in welches Format sie konvertiert werden soll, und eine Konvertierungs‑Engine sollte die eigentliche Umwandlung durchführen. Mit dem GroupDocs.Conversion.Mcp‑Server rufen Claude, Cursor oder GitHub Copilot diese Engine lokal auf Ihrem Rechner mit einem einzigen Satz auf:

Convert contract.docx to PDF

Die schrittweise Version mit Konfiguration und Fehlersuche finden Sie in der Dokumentation: How to convert documents with AI agents using MCP. Dieser Beitrag erklärt, warum die Aufteilung wichtig ist und wo der Agent sich zurückhalten sollte.

Was schiefgeht, wenn ein Agent selbst eine Datei konvertiert?

Ein Sprachmodell, das ein PDF zu Word „konvertiert“, konvertiert überhaupt nichts. Es liest den ihm übergebenen Inhalt und schreibt neuen Inhalt im Zielformat. Was das Modell nicht gesehen hat, kann es nicht reproduzieren: die exakte Schriftart, die Spaltengeometrie, den Seitenumbruch vor einer Tabelle, die Stilnamen, von denen eine Word‑Vorlage abhängt. Das zurückgelieferte Ergebnis sieht zwar nach einer Konvertierung aus, ist jedoch ein Neutippen.

Genau das ist der Fehlermodus, um den es in diesem Beitrag geht. Er ist still: Die Ausgabe lässt sich ohne Fehlermeldungen öffnen, sodass niemand nachprüft, bis sich etwa eine Tabelle verschoben hat oder eine Überschrift ihren Stil verloren hat. Rendering‑Treue ist deterministische Engine‑Arbeit, keine Generierungs‑Arbeit.

Was sollte der Agent entscheiden und was sollte die Engine tun?

Teilen Sie die Aufgabe entlang der Grenze zwischen Urteil und Ausführung.

Frage Der Agent entscheidet Die Engine erledigt
Welche Dateien sind im Geltungsbereich? Liest Ihre Eingabeaufforderung und den Speicherordner Nichts
Welches Zielformat? Ordnet „mach es editierbar“ zu DOCX, „archiviere es“ zu PDF Nichts
Ist die Datei überhaupt konvertierbar? Ruft get_supported_formats auf und liest die Antwort Gibt die gültigen Zielformate zurück
Wie groß ist die Datei? Ruft get_document_info auf und liest die Seitenzahl Liest Typ, Seitenzahl, Eigenschaften
Die eigentliche Konvertierung Ruft convert auf Rendert die Ausgabe mit der GroupDocs.Conversion‑Engine
Was bei einem Fehler zu tun ist Wiederholt, fragt Sie oder überspringt die Datei Gibt den Grund als Text zurück

Der Agent berührt niemals die Bytes Ihres Dokuments. Er übergibt einen Dateinamen und ein Format, und die Engine liefert eine Datei zurück.

Wie verbindet man einen Agenten lokal mit der Engine?

Registrieren Sie den Server einmal in Ihrem Client. Claude Desktop verwendet claude_desktop_config.json, Claude Code nutzt claude mcp add, VS Code mit GitHub Copilot verwendet mcp.json und Cursor nutzt ~/.cursor/mcp.json. Der Server unterstützt außerdem Visual Studio 2022, Windsurf, Cline, Codex CLI und JetBrains Rider. Ein Claude Desktop‑Eintrag sieht so aus:

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

dnx benötigt das .NET 10‑SDK. Wenn Sie Docker bevorzugen, lautet das eigenständige Image ghcr.io/groupdocs-conversion/conversion-net-mcp:latest; starten Sie es mit docker run --rm -i -v $(pwd)/documents:/data davor. Der Client kommuniziert über stdio mit dem Server: Der Pfad ist Agent → lokaler Server → lokales Dateisystem. Starten Sie den Client nach der Registrierung neu.

Welches Werkzeug wird durch jede Anforderung ausgelöst?

Der Server stellt vier Werkzeuge bereit. Ihre Namen sind wörtlich; Agenten suchen nach ihnen, wenn etwas nicht funktioniert.

  • convert konvertiert ein Dokument in ein anderes Format und speichert das Ergebnis in Ihrem Speicher‑ oder Ausgabeverzeichnis. Es erwartet file, format (z. B. pdf, docx, xlsx, pptx, html, png, jpg, csv, txt, rtf, md) und optional password.
  • get_supported_formats listet die Zielformate auf, in die eine gegebene Quelldatei umgewandelt werden kann.
  • get_document_info liefert Dateityp, Seitenzahl und grundlegende Eigenschaften, ohne zu konvertieren.
  • get_license_status gibt an, ob der Server im Evaluations‑, Lizenz‑Datei‑ oder Metered‑Modus läuft.

Offene Eingabeaufforderungen funktionieren, weil der Agent sie verkettet:

Welche Formate kann ich aus dieser Visio‑Datei machen? Dann konvertiere sie zu PDF.

Prüfe zuerst die Seitenzahl von whitepaper.pdf, dann konvertiere sie zu DOCX.

Bestehende Dateien werden niemals überschrieben. Eine zweite Konvertierung derselben Datei erhält einen eigenen Namen, z. B. report (1).pdf.

Beispielsession

Dies ist eine gekürzte, illustrative Session, die aus den Werkzeugbeschreibungen in der Dokumentation zusammengestellt wurde, kein Screenshot.

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.

Für den vollständigen Ablauf zeigt das n8n‑Walkthrough dieselbe Engine, die von einem Workflow statt einem Chat gesteuert wird, und die Ankündigung behandelt den Server im Allgemeinen.

Was sind die Grenzen?

  • Evaluationsmodus. Ohne Lizenz fügt der Server ein Evaluations‑Wasserzeichen zum konvertierten Ergebnis hinzu und begrenzt jeden Server‑Prozess auf 15 geöffnete Dokumente; ein Neustart des Servers setzt den Zähler zurück. Fragen Sie Ihren Agenten zuerst „Wie ist der Lizenzstatus des Konvertierungs‑Servers?“, get_license_status liefert die Antwort, ohne ein Dokument zu verarbeiten.
  • Kein OCR. Der Server konvertiert Dokumente, die eine Textebene besitzen. Ein Scan, der nur als Bild‑PDF gespeichert ist, wird nicht als editierbarer Text ausgegeben.
  • Konvertierung, nicht Extraktion. Dieser Server wandelt ganze Dokumente um. Für feldbasierte Datenauszüge ist der begleitende GroupDocs.Parser.Mcp‑Server (nur als Docker‑Image verfügbar) besser geeignet, und viele Pipelines nutzen beide.

FAQ

Kann Claude ein DOCX zu PDF konvertieren?
Ja, mit einem angeschlossenen Konvertierungs‑Server. Claude ruft convert mit format: "pdf" auf, und die GroupDocs‑Engine erzeugt die Datei auf Ihrem Rechner.

Werden meine Dateien hochgeladen, wenn ein Agent sie konvertiert?
Nicht mit diesem Server. Er läuft lokal über stdio, und die Dokumente verbleiben in Ihrem Speicherordner. Ihre Lizenzdatei wird ebenfalls von der lokalen Festplatte gelesen.

Welche Formate kann der Server konvertieren?
Über 100 Dokument‑, Tabellen‑, Präsentations‑, Bild‑, E‑Mail‑, CAD‑ und Web‑Formate, dieselbe Menge wie die GroupDocs.Conversion .NET‑Bibliothek. Fragen Sie get_supported_formats nach der genauen Liste für eine gegebene Datei.

Tiefer einsteigen