Documentation

Model Context Protocol

Serveur MCP

Apportez le renommage de fichiers, l'organisation et la division de PDF par IA dans Claude Code, Claude Desktop, Cursor, Windsurf et tout client compatible MCP. Dites à l'IA comment vous voulez que vos fichiers soient nommés en anglais simple — elle lit le contenu réel du document et suit vos instructions.

Fonctionnalités

Prompts en langage naturel — décrivez vos règles de nommage en anglais simple (règles par type de document, logique conditionnelle, localisation)
Analyse de contenu IA — OCR et NLP extraient dates, fournisseurs, montants, types de documents et numéros de référence du contenu des fichiers
Division de PDF — divisez les PDF par contenu/sujet (IA), signets ou plages de pages
Stratégies d'organisation — tri automatique en dossiers par année, entreprise, type de document ou combinaisons
Mode dry-run — prévisualisez les renommages avant de valider les changements

Démarrage Rapide

Ajoutez à Claude Code avec une seule commande :

Terminal

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

Définissez votre clé API et vous êtes prêt :

$ export RENAMED_API_KEY="rt_..."

Vous utilisez Claude Desktop, Cursor ou Windsurf ? Ajoutez à votre fichier de config MCP :

claude_desktop_config.json

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

Authentification

Inscrivez-vous pour un compte renamed.to
Paramètres → Clés API et créez une clé
Définissez la variable d'environnement dans votre configuration MCP

Le serveur accepte également RENAMED_TOKEN comme alternative. Utilisez l'outil status pour vérifier votre connexion.

Outils

rename

Renommage de fichiers par IA avec prompts en langage naturel

filePathsoutputDir?format?dryRun?

pdf_split

Diviser les PDF par contenu, signets ou plages de pages

filePathstrategy?outputDir?

watch

Surveiller un répertoire pour de nouveaux fichiers (délègue au CLI)

directoryoutputDir?

status

Vérifier l'authentification et la connectivité API

Rename

Envoie des fichiers à l'API renamed.to qui lit le contenu réel du document — OCR pour les scans, NLP pour le texte — extrait les métadonnées (dates, fournisseurs, montants, numéros de référence) et génère des noms de fichiers basés sur vos instructions.

filePathsrequired

Chemins absolus ou relatifs vers les fichiers à renommer.

outputDir

Répertoire où écrire les fichiers renommés. Par défaut le répertoire source.

format

Prompt en langage naturel décrivant comment les noms de fichiers doivent être formatés. Lorsque non fourni, l'IA sélectionne automatiquement le meilleur modèle de nommage pour chaque document.

dryRun

Prévisualiser le renommage sans écrire de fichiers.

Exemples de prompts

Le paramètre format accepte des instructions en anglais simple. L'IA les interprète et les applique à chaque fichier en fonction de son contenu :

Factures : {date} - {fournisseur} - Facture #{numéro} - {montant}€
Contrats : {fournisseur} - {type} - {date}
Reçus : {date} - {fournisseur} - Reçu

Vous pouvez spécifier des règles par type de document, logique conditionnelle, localisation et plus :

Préfixes de département — "Add HR_ prefix for employment documents, FIN_ for financial records"
Localisation — Use German date format DD.MM.YYYY, translate document types to German
Logique conditionnelle — "If invoice amount > $1000, add LARGE_ prefix"
Formats sectoriels — "Include matter number for legal documents, client code for accounting"

PDF Split

L'IA lit le document complet, identifie les sections logiques et les limites de sujets, et crée des PDF nommés individuellement pour chacun.

filePathrequired

Chemin vers le fichier PDF à diviser.

strategy

Stratégie de division : ai (analyse le contenu et divise par sujet), bookmarks (divise aux limites des signets PDF), ou pages (divise par plages de . Defaults to ai.

outputDir

Répertoire où écrire les fichiers PDF divisés. Par défaut le répertoire source.

Annotations des Outils

Outil	Lecture seule	Destructif	Idempotent
`rename`	Non	Oui (renomme les fichiers en place)	Non
`pdf_split`	Non	Non (crée de nouveaux fichiers)	Oui
`watch`	Oui (informatif)	Non	Oui
`status`	Oui	Non	Oui

Exemples

Renomme tous les PDF dans mon dossier Téléchargements en fonction de leur contenu

L'IA lit chaque fichier — même les images scannées via OCR — extrait dates, fournisseurs, types de documents et génère des noms descriptifs.

"Renomme ces fichiers. Pour les factures utilise "{date} - {fournisseur} - Facture #{numéro}", pour les contrats utilise '{fournisseur} - {type} - {date}", et ajoute un préfixe LARGE_ si le montant dépasse 1000€'

Applique différentes règles de nommage par type de document avec logique conditionnelle, le tout à partir d'un seul prompt en langage naturel.

Divise ce rapport annuel de 50 pages en documents séparés par sujet

Analyse les limites de contenu et crée des PDF nommés individuellement pour chaque section logique — aucun signet requis.

Fais un renommage dry run de ces factures en utilisant le format de date français JJ.MM.AAAA et traduis les types de documents en français

Montre à quoi ressembleraient les nouveaux noms de fichiers sans déplacer aucun fichier. L'IA gère la localisation et la traduction dans le nommage.

Configuration

Claude Code

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

Claude Desktop

Ajoutez à claude_desktop_config.json :

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

Cursor

Ajoutez à votre configuration MCP (Paramètres → Serveurs MCP) en utilisant le même format JSON.

Windsurf

Ajoutez à votre configuration MCP en utilisant le même format JSON.

Gestion des Erreurs

Erreur	Cause	Résolution
Non configuré	`RENAMED_API_KEY` non défini	Ajoutez votre clé API à l'environnement (obtenez-en une ici)
Échec d'authentification	Clé API invalide ou expirée	Générez une nouvelle clé sur (Paramètres → Clés API)
Crédits insuffisants	Crédits du compte épuisés	Rechargez sur (Paramètres → Facturation)
Limite de débit dépassée	Trop de requêtes	Attendez et réessayez
Erreur réseau	Impossible de joindre l'API	Vérifiez votre connexion Internet
Fichier non trouvé	Chemin de fichier invalide	Vérifiez que le chemin existe et est accessible

Sécurité

Clé API est lue uniquement depuis les variables d'environnement — jamais codée en dur ou journalisée
Contenu des fichiers est envoyé à l'API renamed.to pour analyse — soyez conscient de cela lors du traitement de documents sensibles
S'exécute localement via transport stdio — aucun port réseau n'est ouvert sur votre machine
Aucune donnée stockée le serveur est sans état entre les requêtes

Exigences

Node.js 20 ou ultérieur. Le serveur est installé automatiquement via npx — aucune installation manuelle nécessaire.

Ressources

Dépôt GitHub Package npm Documentation API Documentation CLI