Documentazione

Model Context Protocol

MCP Server

Porti la ridenominazione AI dei file, l'organizzazione e la divisione PDF in Claude Code, Claude Desktop, Cursor, Windsurf e qualsiasi client compatibile con MCP. Dica all'AI come desidera nominare i suoi file usando un inglese semplice — legge il contenuto effettivo del documento e segue le sue istruzioni.

Funzionalità

Prompt in linguaggio naturale — descriva le sue regole di denominazione in inglese semplice (regole per tipo di documento, logica condizionale, localizzazione)
Analisi AI del contenuto — OCR e NLP estraggono date, fornitori, importi, tipi di documento e numeri di riferimento dal contenuto dei file
Divisione PDF — divida i PDF per contenuto/argomento (AI), segnalibri o intervalli di pagine
Strategie di organizzazione — organizzazione automatica in cartelle per anno, azienda, tipo di documento o combinazioni
Modalità di prova — anteprima delle ridenominazioni prima di confermare le modifiche

Avvio Rapido

Aggiunga a Claude Code con un singolo comando:

Terminal

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

Imposti la sua chiave API ed è pronto per iniziare:

$ export RENAMED_API_KEY="rt_..."

Utilizza Claude Desktop, Cursor o Windsurf? Aggiunga al suo file di configurazione MCP:

claude_desktop_config.json

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

Autenticazione

Si registri per un account renamed.to
Impostazioni → Chiavi API e crei una chiave
Imposti la variabile di ambiente nella sua configurazione MCP

Il server accetta anche RENAMED_TOKEN come fallback. Utilizzi lo strumento di stato per verificare la sua connessione.status

Strumenti

rename

Ridenominazione file basata su AI con prompt in linguaggio naturale

filePathsoutputDir?format?dryRun?

pdf_split

Divida i PDF per contenuto, segnalibri o intervalli di pagine

filePathstrategy?outputDir?

watch

Monitori una directory per nuovi file (delega alla CLI)

directoryoutputDir?

status

Verifichi l'autenticazione e la connettività API

Rename

Invia i file all'API renamed.to che legge il contenuto effettivo del documento — OCR per scansioni, NLP per testo — estrae metadati (date, fornitori, importi, numeri di riferimento) e genera nomi di file basati sulle sue istruzioni.

filePathsrequired

Percorsi assoluti o relativi ai file da rinominare.

outputDir

Directory in cui scrivere i file rinominati. Predefinita: la directory di origine.

format

Prompt in linguaggio naturale che descrive come devono essere formattati i nomi dei file. Quando non fornito, l'AI seleziona automaticamente il modello di denominazione migliore per ogni documento.

dryRun

Visualizzi l'anteprima della ridenominazione senza scrivere alcun file.

Esempi di prompt

Il parametro format accetta istruzioni in inglese semplice. L'AI le interpreta e le applica a ogni file in base al suo contenuto:

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

Può specificare regole per tipo di documento, logica condizionale, localizzazione e altro:

Prefissi di reparto — "Add HR_ prefix for employment documents, FIN_ for financial records"
Localizzazione — "Use German date format DD.MM.YYYY, translate document types to German"
Logica condizionale — "If invoice amount > $1000, add LARGE_ prefix"
Formati di settore — "Include matter number for legal documents, client code for accounting"

PDF Split

L'AI legge il documento completo, identifica le sezioni logiche e i confini degli argomenti e crea PDF denominati individualmente per ciascuno.

filePathrequired

Percorso al file PDF da dividere.

strategy

Strategia di divisione: ai (analizza il contenuto e divide per argomento), bookmarks (divide ai confini dei segnalibri PDF) o pages (divide per intervalli di pagine). Predefinita: ai.. Defaults to ai.

outputDir

Directory in cui scrivere i file PDF divisi. Predefinita: la directory di origine.

Annotazioni degli Strumenti

Strumento	Sola Lettura	Distruttivo	Idempotente
`rename`	No	Sì (rinomina i file sul posto)	No
`pdf_split`	No	No (crea nuovi file)	Sì
`watch`	Sì (informativo)	No	Sì
`status`	Sì	No	Sì

Esempi

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

L'AI legge ogni file — anche immagini scansionate tramite OCR — estrae date, fornitori, tipi di documento e genera nomi descrittivi.

"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"

Applica regole di denominazione diverse per tipo di documento con logica condizionale, tutto da un singolo prompt in inglese semplice.

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

Analizza i confini del contenuto e crea PDF denominati individualmente per ogni sezione logica — nessun segnalibro richiesto.

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

Mostra quali sarebbero i nuovi nomi di file senza spostare alcun file. L'AI gestisce localizzazione e traduzione nella denominazione.

Configurazione

Claude Code

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

Claude Desktop

Aggiunga a claude_desktop_config.json:

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

Cursor

Aggiunga alla sua configurazione MCP (Impostazioni → MCP Servers) utilizzando lo stesso formato JSON.

Windsurf

Aggiunga alla sua configurazione MCP utilizzando lo stesso formato JSON.

Gestione degli Errori

Errore	Causa	Risoluzione
Not configured	`RENAMED_API_KEY` non impostata	Aggiunga la sua chiave API all'ambiente (la ottenga qui)
Authentication failed	Chiave API non valida o scaduta	Generi una nuova chiave su (Impostazioni → Chiavi API)
Insufficient credits	Crediti account esauriti	Ricarichi su (Impostazioni → Fatturazione)
Rate limit exceeded	Troppe richieste	Attenda e riprovi
Network error	Impossibile raggiungere l'API	Verifichi la sua connessione internet
File not found	Percorso file non valido	Verifichi che il percorso esista e sia accessibile

Sicurezza

Chiave API viene letta solo dalle variabili di ambiente — mai hardcoded o registrata
Contenuto dei file viene inviato all'API renamed.to per l'analisi — ne sia consapevole quando elabora documenti sensibili
Esecuzione locale tramite trasporto stdio — nessuna porta di rete viene aperta sulla sua macchina
Nessun dato memorizzato il server è stateless tra le richieste

Requisiti

Node.js 20 o successivo. Il server viene installato automaticamente tramite npx — nessuna installazione manuale necessaria.

Risorse

Repository GitHub Pacchetto npm Documentazione API Documentazione CLI