Dokumentacja

Model Context Protocol

Serwer MCP

Przenieś zmianę nazw plików AI, organizację i dzielenie PDF do Claude Code, Claude Desktop, Cursor, Windsurf i dowolnego klienta kompatybilnego z MCP. Powiedz AI, jak chcesz nazwać swoje pliki w prostym języku angielskim — odczyta rzeczywistą treść dokumentu i zastosuje Twoje instrukcje.

Funkcje

Polecenia w języku naturalnym — opisz swoje reguły nazewnictwa w prostym języku angielskim (reguły według typu dokumentu, logika warunkowa, lokalizacja)
Analiza treści AI — OCR i NLP wyodrębniają daty, dostawców, kwoty, typy dokumentów i numery referencyjne z treści plików
Dzielenie PDF — podziel pliki PDF według treści/tematu (AI), zakładek lub zakresów stron
Strategie organizacji — automatyczna organizacja w foldery według roku, firmy, typu dokumentu lub kombinacji
Tryb próbny — podgląd zmian nazw przed zatwierdzeniem

Szybki Start

Dodaj do Claude Code za pomocą jednego polecenia:

Terminal

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

Ustaw swój klucz API i gotowe:

$ export RENAMED_API_KEY="rt_..."

Używasz Claude Desktop, Cursor lub Windsurf? Dodaj do swojego pliku konfiguracyjnego MCP:

claude_desktop_config.json

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

Uwierzytelnianie

Zarejestruj się dla konta renamed.to
Ustawienia → Klucze API i utwórz klucz
Ustaw zmienną środowiskową w konfiguracji MCP

Serwer akceptuje również RENAMED_TOKEN jako zapasowy. Użyj narzędzia status, aby zweryfikować połączenie.

Narzędzia

rename

Zmiana nazw plików oparta na AI z poleceniami w języku naturalnym

filePathsoutputDir?format?dryRun?

pdf_split

Podziel pliki PDF według treści, zakładek lub zakresów stron

filePathstrategy?outputDir?

watch

Monitoruj katalog pod kątem nowych plików (delegacja do CLI)

directoryoutputDir?

status

Zweryfikuj uwierzytelnianie i łączność z API

Rename

Wysyła pliki do API renamed.to, które odczytuje rzeczywistą treść dokumentu — OCR dla skanów, NLP dla tekstu — wyodrębnia metadane (daty, dostawcy, kwoty, numery referencyjne) i generuje nazwy plików na podstawie Twoich instrukcji.

filePathsrequired

Bezwzględne lub względne ścieżki do plików do zmiany nazwy.

outputDir

Katalog, w którym zapisać pliki o zmienionych nazwach. Domyślnie: katalog źródłowy.

format

Polecenie w języku naturalnym opisujące, jak powinny być formatowane nazwy plików. Gdy nie podane, AI automatycznie wybiera najlepszy wzorzec nazewnictwa dla każdego dokumentu.

dryRun

Podgląd zmiany nazwy bez zapisywania plików.

Przykłady poleceń

Parametr format akceptuje instrukcje w prostym języku angielskim. AI je interpretuje i stosuje do każdego pliku na podstawie jego treści:

Invoices: {date} - {vendor} - Invoice #{number} - ${amount}
Contracts: {vendor} - {type} - {date}
Receipts: {date} - {vendor} - Receipt

Możesz określić reguły według typu dokumentu, logikę warunkową, lokalizację i więcej:

Prefiksy działów — "Add HR_ prefix for employment documents, FIN_ for financial records"
Lokalizacja — "Use German date format DD.MM.YYYY, translate document types to German"
Logika warunkowa — "If invoice amount > $1000, add LARGE_ prefix"
Formaty branżowe — "Include matter number for legal documents, client code for accounting"

PDF Split

AI odczytuje cały dokument, identyfikuje logiczne sekcje i granice tematów oraz tworzy indywidualnie nazwane pliki PDF dla każdego.

filePathrequired

Ścieżka do pliku PDF do podziału.

strategy

Strategia podziału: ai (analizuj treść i podziel według tematu), bookmarks (podziel na granicach zakładek PDF) lub pages (podziel według zakresów stron). Domyślnie: ai.. Defaults to ai.

outputDir

Katalog, w którym zapisać podzielone pliki PDF. Domyślnie: katalog źródłowy.

Adnotacje Narzędzi

Narzędzie	Tylko do odczytu	Destrukcyjne	Idempotentne
`rename`	Nie	Tak (zmienia nazwy plików w miejscu)	Nie
`pdf_split`	Nie	Nie (tworzy nowe pliki)	Tak
`watch`	Tak (informacyjne)	Nie	Tak
`status`	Tak	Nie	Tak

Przykłady

"Rename all the PDFs in my Downloads folder based on their content"

AI odczytuje każdy plik — nawet zeskanowane obrazy za pomocą OCR — wyodrębnia daty, dostawców, typy dokumentów i generuje opisowe nazwy.

"Rename these files. For invoices use '{date} - {vendor} - Invoice #{number}', for contracts use '{vendor} - {type} - {date}', and add a LARGE_ prefix if the amount is over $1000"

Stosuj różne reguły nazewnictwa według typu dokumentu z logiką warunkową, wszystko z jednego polecenia w prostym języku angielskim.

"Split this 50-page annual report into separate documents by topic"

Analizuj granice treści i twórz indywidualnie nazwane pliki PDF dla każdej logicznej sekcji — nie są wymagane zakładki.

"Do a dry run rename of these invoices using German date format DD.MM.YYYY and translate document types to German"

Pokaż, jak będą wyglądać nowe nazwy plików bez przenoszenia żadnych plików. AI obsługuje lokalizację i tłumaczenie w nazewnictwie.

Konfiguracja

Claude Code

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

Claude Desktop

Dodaj do claude_desktop_config.json:

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

Cursor

Dodaj do swojej konfiguracji MCP (Ustawienia → MCP Servers) używając tego samego formatu JSON.

Windsurf

Dodaj do swojej konfiguracji MCP używając tego samego formatu JSON.

Obsługa Błędów

Błąd	Przyczyna	Rozwiązanie
Not configured	`RENAMED_API_KEY` nie ustawiony	Dodaj swój klucz API do środowiska (pobierz go tutaj)
Authentication failed	Nieprawidłowy lub wygasły klucz API	Wygeneruj nowy klucz na (Ustawienia → Klucze API)
Insufficient credits	Brak kredytów na koncie	Doładuj na (Ustawienia → Rozliczenia)
Rate limit exceeded	Zbyt wiele żądań	Poczekaj i spróbuj ponownie
Network error	Nie można połączyć się z API	Sprawdź swoje połączenie internetowe
File not found	Nieprawidłowa ścieżka pliku	Sprawdź, czy ścieżka istnieje i jest dostępna

Bezpieczeństwo

Klucz API jest odczytywany tylko ze zmiennych środowiskowych — nigdy nie jest zakodowany na stałe ani logowany
Treść plików jest wysyłana do API renamed.to do analizy — pamiętaj o tym podczas przetwarzania poufnych dokumentów
Wykonanie lokalne przez transport stdio — żaden port sieciowy nie jest otwierany na Twoim komputerze
Brak przechowywanych danych serwer jest bezstanowy między żądaniami

Wymagania

Node.js 20 lub nowszy. Serwer jest instalowany automatycznie przez npx — nie jest wymagana ręczna instalacja.

Zasoby

Repozytorium GitHub Pakiet npm Dokumentacja API Dokumentacja CLI