Dokumentation

Model Context Protocol

MCP Server

Bringen Sie KI-gestützte Dateiumbenennung, Organisation und PDF-Aufteilung in Claude Code, Claude Desktop, Cursor, Windsurf und jeden MCP-kompatiblen Client. Beschreiben Sie der KI in normalem Deutsch, wie Sie Ihre Dateien benennen möchten — sie liest den tatsächlichen Dokumentinhalt und folgt Ihren Anweisungen.

Funktionen

Natürlichsprachliche Prompts — Beschreiben Sie Ihre Benennungsregeln in normalem Deutsch (Regeln pro Dokumenttyp, bedingte Logik, Lokalisierung)
KI-Inhaltsanalyse — OCR und NLP extrahieren Daten, Lieferanten, Beträge, Dokumenttypen und Referenznummern aus Dateiinhalten
PDF-Aufteilung — PDFs nach Inhalt/Thema (KI), Lesezeichen oder Seitenbereichen aufteilen
Organisationsstrategien — Automatische Sortierung in Ordner nach Jahr, Firma, Dokumenttyp oder Kombinationen
Probelauf-Modus — Vorschau der Umbenennungen vor der Ausführung

Schnellstart

Mit einem einzigen Befehl zu Claude Code hinzufügen:

Terminal

$ claude mcp add renamed-to -- npx -y @renamed-to/mcp

API-Schlüssel setzen und los geht es:

$ export RENAMED_API_KEY="rt_..."

Claude Desktop, Cursor oder Windsurf nutzen? Zur MCP-Konfigurationsdatei hinzufügen:

claude_desktop_config.json

{
  "mcpServers": {
    "renamed-to": {
      "command": "npx",
      "args": ["-y", "@renamed-to/mcp"],
      "env": {
        "RENAMED_API_KEY": "rt_your_key_here"
      }
    }
  }
}

Authentifizierung

Registrieren für ein renamed.to Konto
Einstellungen → API-Schlüssel und einen Schlüssel erstellen
Umgebungsvariable in Ihrer MCP-Konfiguration setzen

Der Server akzeptiert auch RENAMED_TOKEN als Fallback. Verwenden Sie das status-Tool, um Ihre Verbindung zu überprüfen.

Tools

rename

KI-gestützte Dateiumbenennung mit natürlichsprachlichen Prompts

filePathsoutputDir?format?dryRun?

pdf_split

PDFs nach Inhalt, Lesezeichen oder Seitenbereichen aufteilen

filePathstrategy?outputDir?

watch

Verzeichnis auf neue Dateien überwachen (delegiert an CLI)

directoryoutputDir?

status

Authentifizierung und API-Verbindung prüfen

Rename

Sendet Dateien an die renamed.to API, die den tatsächlichen Dokumentinhalt liest — OCR für Scans, NLP für Text — Metadaten extrahiert (Daten, Lieferanten, Beträge, Referenznummern) und Dateinamen basierend auf Ihren Anweisungen generiert.

filePathsrequired

Absolute oder relative Pfade zu den umzubenennenden Dateien.

outputDir

Verzeichnis, in das umbenannte Dateien geschrieben werden. Standardmäßig das Quellverzeichnis.

format

Natürlichsprachlicher Prompt, der beschreibt, wie Dateinamen formatiert werden sollen. Wenn nicht angegeben, wählt die KI automatisch das beste Benennungsmuster für jedes Dokument.

dryRun

Vorschau der Umbenennung ohne Dateien zu schreiben.

Prompt-Beispiele

Der format-Parameter akzeptiert Anweisungen in normalem Deutsch. Die KI interpretiert sie und wendet sie basierend auf dem Inhalt auf jede Datei an:

Rechnungen: {Datum} - {Lieferant} - Rechnung Nr. {Nummer} - {Betrag}€
Verträge: {Lieferant} - {Typ} - {Datum}
Quittungen: {Datum} - {Lieferant} - Quittung

Sie können Regeln pro Dokumenttyp, bedingte Logik, Lokalisierung und mehr angeben:

Abteilungspräfixe — "HR_ Präfix für Personaldokumente, FIN_ für Finanzdokumente hinzufügen"
Lokalisierung — "Deutsches Datumsformat TT.MM.JJJJ verwenden, Dokumenttypen auf Deutsch übersetzen"
Bedingte Logik — "Wenn Rechnungsbetrag > 1000€, GROSS_ Präfix hinzufügen"
Branchenformate — "Aktennummer für Rechtsdokumente, Mandantencode für Buchhaltung einfügen"

PDF Split

Die KI liest das gesamte Dokument, identifiziert logische Abschnitte und Themengrenzen und erstellt einzeln benannte PDFs für jeden Abschnitt.

filePathrequired

Pfad zur aufzuteilenden PDF-Datei.

strategy

Aufteilungsstrategie: ai (analysiert Inhalt und teilt nach Thema), bookmarks (teilt an PDF-Lesezeichengrenzen) oder pages (teilt nach Seitenbereichen). Standardmäßig ai.. Standardmäßig ai.

outputDir

Verzeichnis, in das die aufgeteilten PDF-Dateien geschrieben werden. Standardmäßig das Quellverzeichnis.

Tool-Annotationen

Tool	Nur-Lesen	Destruktiv	Idempotent
`rename`	Nein	Ja (benennt Dateien direkt um)	Nein
`pdf_split`	Nein	Nein (erstellt neue Dateien)	Ja
`watch`	Ja (informativ)	Nein	Ja
`status`	Ja	Nein	Ja

Beispiele

"Benenne alle PDFs in meinem Downloads-Ordner basierend auf ihrem Inhalt um"

Die KI liest jede Datei — auch gescannte Bilder via OCR — extrahiert Daten, Lieferanten, Dokumenttypen und generiert beschreibende Namen.

"Benenne diese Dateien um. Für Rechnungen verwende '{Datum} - {Lieferant} - Rechnung Nr. {Nummer}', für Verträge verwende '{Lieferant} - {Typ} - {Datum}' und füge ein GROSS_ Präfix hinzu, wenn der Betrag über 1000€ liegt"

Wendet verschiedene Benennungsregeln pro Dokumenttyp mit bedingter Logik an, alles aus einem einzigen deutschsprachigen Prompt.

"Teile diesen 50-seitigen Jahresbericht in separate Dokumente nach Thema auf"

Analysiert Inhaltsgrenzen und erstellt einzeln benannte PDFs für jeden logischen Abschnitt — keine Lesezeichen erforderlich.

"Mache einen Probelauf der Umbenennung dieser Rechnungen mit deutschem Datumsformat TT.MM.JJJJ und übersetze Dokumenttypen ins Deutsche"

Zeigt, wie die neuen Dateinamen aussehen würden, ohne Dateien zu verschieben. Die KI übernimmt Lokalisierung und Übersetzung bei der Benennung.

Konfiguration

Claude Code

$ claude mcp add renamed-to -- npx -y @renamed-to/mcp

Claude Desktop

Zu claude_desktop_config.json hinzufügen:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Cursor

Zu Ihrer MCP-Konfiguration hinzufügen (Einstellungen → MCP Server) im gleichen JSON-Format.

Windsurf

Zu Ihrer MCP-Konfiguration im gleichen JSON-Format hinzufügen.

Fehlerbehandlung

Fehler	Ursache	Lösung
Nicht konfiguriert	`RENAMED_API_KEY` nicht gesetzt	API-Schlüssel zur Umgebung hinzufügen (hier erhalten)
Authentifizierung fehlgeschlagen	Ungültiger oder abgelaufener API-Schlüssel	Neuen Schlüssel generieren unter (Einstellungen → API-Schlüssel)
Unzureichende Credits	Konto-Credits aufgebraucht	Aufladen unter (Einstellungen → Abrechnung)
Rate-Limit überschritten	Zu viele Anfragen	Warten und erneut versuchen
Netzwerkfehler	API nicht erreichbar	Internetverbindung prüfen
Datei nicht gefunden	Ungültiger Dateipfad	Überprüfen, ob der Pfad existiert und zugänglich ist

Sicherheit

API-Schlüssel wird nur aus Umgebungsvariablen gelesen — niemals hartcodiert oder protokolliert
Dateiinhalte werden zur Analyse an die renamed.to API gesendet — beachten Sie dies bei der Verarbeitung sensibler Dokumente
Läuft lokal via stdio-Transport — keine Netzwerkports werden auf Ihrem Rechner geöffnet
Keine Datenspeicherung der Server ist zwischen Anfragen zustandslos

Anforderungen

Node.js 20 oder höher. Der Server wird automatisch via npx installiert — keine manuelle Installation erforderlich.

Ressourcen

GitHub Repository npm-Paket API-Dokumentation CLI-Dokumentation