Dateien in Claude und Cursor konvertieren mit dem GuruPDF MCP

Ihr Coding-Agent kann eine App scaffolden, einen Stacktrace entwirren und mit Ihnen über Tabs versus Spaces streiten. Geben Sie ihm aber ein PDF und bitten Sie um ein bearbeitbares Word-Dokument, und er kommt ins Stocken. Die Dateien liegen auf Ihrer Festplatte; das Modell lebt im Chat. Nichts verbindet die beiden.

Genau diese Lücke ist der Grund, warum wir das GuruPDF MCP gebaut haben — ein kleiner MCP-Server, der Claude, Cursor und jedem anderen MCP-Client eine Möglichkeit gibt, Dateien wirklich zu konvertieren. Packen Sie einen Pfad in Ihren Prompt, sagen Sie, was Sie wollen, und einen Moment später landet die konvertierte Datei wieder auf Ihrer Festplatte. Kein Upload-Fenster, kein „laden Sie sie herunter und dann woanders wieder hoch“. Einfach „konvertiere ~/contracts/lease.pdf nach Word.“

Was ein File-Conversion-MCP eigentlich ist

MCP — das Model Context Protocol — ist der Stecker, mit dem ein KI-Agent Tools außerhalb seines eigenen Kopfes nutzen kann. Ein Server stellt ein paar Aktionen bereit; der Agent ruft sie auf, wenn Ihr Prompt sie braucht. Es gibt MCP-Server für Datenbanken, Browser, GitHub.

Für Dateien gab es keinen guten. Ein PDF MCP — eigentlich ein File-Conversion-MCP, denn es reicht weit über PDF hinaus — ist also einfach ein Server, der eine Datei in einem Format entgegennimmt und ein anderes zurückgibt. PDF zu Word. Ein Ordner voller Bilder zu einem PDF. Eine gescannte Seite zu durchsuchbarem Text. Der Agent fragt; GuruPDF konvertiert.

Unter der Haube steckt dieselbe Engine wie hinter gurupdf.com: 126 Tools, 100+ Formate, jetzt direkt aus Ihrem Editor erreichbar.

In rund zwei Minuten eingerichtet

Sie brauchen zwei Dinge: Node (für npx) und einen kostenlosen GuruPDF-API-Key. Holen Sie sich einen Key unter gurupdf.com/profile — kostenlose Accounts kommen mit täglichen Credits, Sie können also sofort loslegen.

Der Server installiert und startet sich selbst über npx; es gibt nichts zu klonen:

npx gurupdf-mcp

Sie führen das allerdings nicht von Hand aus — Sie richten Ihren MCP-Client darauf aus. Für Cursor, Claude Desktop, VS Code oder Windsurf packen Sie das hier in Ihre MCP-Konfiguration:

{
  "mcpServers": {
    "gurupdf": {
      "command": "npx",
      "args": ["-y", "gurupdf-mcp"],
      "env": { "GURUPDF_API_KEY": "your-token-here" }
    }
  }
}

Starten Sie den Client neu, und Ihr Agent bekommt ganz nebenbei vier Tools dazu: eine Datei konvertieren, einen Job prüfen, auflisten, was unterstützt wird, und Ihren Credit-Stand checken. Das ist das ganze Setup.

Was Sie damit wirklich anstellen können

Das ist der spaßige Teil. Sobald alles verdrahtet ist, sind das echte Prompts, die einfach funktionieren:

• „Konvertiere ~/Downloads/invoice.pdf nach Word, damit ich die Summen bearbeiten kann.“ — eine bearbeitbare .docx taucht neben dem Original auf.
• „Mach aus jedem Screenshot in ~/shots ein einziges PDF.“ — Bilder, der Reihe nach, zu einer einzigen Datei zusammengeführt.
• „Dieser Scan ist nur ein Bild. Mach OCR drauf und gib mir den Text.“ — echter Text, aus den Pixeln zurückgeholt.
• „Komprimier report.pdf, die ist 40 MB und ich muss sie per Mail verschicken.“ — eine kleinere Datei, die trotzdem lesbar ist.
• „Mach ein PDF von https://example.com/pricing.“ — die Live-Seite, gerendert als PDF.

Sie müssen sich nie Tool-Namen oder Formate merken. Sagen Sie das Ziel in klarer Sprache, und der Server wählt aus, welches der 126 Tools passt, führt es aus und schreibt das Ergebnis auf die Festplatte. Zusammenführen, splitten, drehen, mit Passwort schützen, mit Wasserzeichen versehen, Excel ↔ PDF, HEIC → JPG — alles mit dabei.

Es meldet sich zurück, wenn etwas nicht stimmt

Die meisten Konverter scheitern mit einem kryptischen Code — dieser hier ist dafür gebaut, sich über Ihren Agenten selbst zu erklären, weil der Agent das ist, was die Antwort tatsächlich liest.

Wenn Ihnen im kostenlosen Tarif die Credits ausgehen, bekommen Sie kein blankes 402. Sie bekommen einen Satz, den Ihr Assistent weiterreicht: Sie haben das kostenlose Limit erreicht (2 Konvertierungen pro Minute, 10 pro Tag), morgen wird es zurückgesetzt, und hier ist ein Link, falls Sie nicht warten wollen. Geben Sie einem Tool das falsche Format oder eine zu große Datei, sagt es Ihnen genau das — in Worten, nicht als Fehlernummer. Sie müssen die Unterhaltung nie verlassen, um herauszufinden, was passiert ist.

Diese Idee, „es über den Agenten zu erklären“, ist auch der Grund, warum wir uns so viel Mühe mit der Formulierung geben. Eine Fehlermeldung, die ein Mensch nie liest, muss trotzdem für das Modell Sinn ergeben, das sie weiterreicht.

Was unter der Haube steckt

• 126 Tools, 100+ Formate. PDF, Word, Excel, PowerPoint, Bilder, E-Books, sogar Video — dieselbe Engine wie die Website.
• Ein echter kostenloser Tarif. Jeder Account bekommt tägliche Credits. Für intensivere Nutzung gibt es Bezahlpläne und Credit-Pakete, und Ihr Agent weist Sie darauf hin, wenn es wirklich Sinn ergibt — nicht vorher.
• Dateien bleiben nicht liegen. Alles läuft über HTTPS und wird innerhalb einer Stunde gelöscht. Das MCP schreibt das Ergebnis auf Ihre Festplatte; die Kopie auf unserer Seite ist kurz danach weg.
• Open Source. Der Server ist MIT-lizenziert, auf npm veröffentlicht und im offiziellen MCP-Registry gelistet, Sie können also jede Zeile lesen, bevor Sie ihn ausführen.

Holen Sie es sich

Wenn Sie Ihren Tag in Claude oder Cursor verbringen und ständig auf irgendeine Konverter-Website wechseln, spart Ihnen das den Umweg.

• Installation: npx gurupdf-mcp
• Paket: npmjs.com/package/gurupdf-mcp
• Registry: suchen Sie nach „GuruPDF“ im offiziellen MCP-Registry
• API-Key: gurupdf.com/profile

Fügen Sie es einmal hinzu und vergessen Sie, dass es da ist — bis zu dem Moment, in dem Sie sonst einen Browser-Tab geöffnet hättest, um eine Datei zu konvertieren, und Ihr Agent es stattdessen einfach erledigt.