Documentación

Model Context Protocol

Servidor MCP

Integre el renombrado de archivos, organización y división de PDFs impulsados por IA en Claude Code, Claude Desktop, Cursor, Windsurf y cualquier cliente compatible con MCP. Dígale a la IA cómo desea que se nombren sus archivos usando inglés simple; el sistema lee el contenido real del documento y sigue sus instrucciones.

Características

Instrucciones en lenguaje natural — describa sus reglas de nomenclatura en inglés simple (reglas por tipo de documento, lógica condicional, localización)
Análisis de contenido con IA — OCR y NLP extraen fechas, proveedores, montos, tipos de documentos y números de referencia del contenido de los archivos
División de PDFs — divida PDFs por contenido/tema (IA), marcadores o rangos de páginas
Estrategias de organización — ordene automáticamente en carpetas por año, empresa, tipo de documento o combinaciones
Modo de prueba — previsualice los renombrados antes de confirmar los cambios

Inicio Rápido

Agregue a Claude Code con un solo comando:

Terminal

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

Configure su clave API y estará listo:

$ export RENAMED_API_KEY="rt_..."

¿Usa Claude Desktop, Cursor o Windsurf? Agregue a su archivo de configuración MCP:

claude_desktop_config.json

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

Autenticación

Regístrese para una cuenta de renamed.to
Configuración → Claves API y cree una clave
Configure la variable de entorno en su configuración MCP

El servidor también acepta RENAMED_TOKEN como alternativa. Use la herramienta status para verificar su conexión.

Herramientas

rename

Renombrado de archivos impulsado por IA con instrucciones en lenguaje natural

filePathsoutputDir?format?dryRun?

pdf_split

Divida PDFs por contenido, marcadores o rangos de páginas

filePathstrategy?outputDir?

watch

Monitoree un directorio en busca de archivos nuevos (delega al CLI)

directoryoutputDir?

status

Verifique la autenticación y conectividad de la API

Rename

Envía archivos a la API de renamed.to que lee el contenido real del documento (OCR para escaneos, NLP para texto), extrae metadatos (fechas, proveedores, montos, números de referencia) y genera nombres de archivo basados en sus instrucciones.

filePathsrequired

Rutas absolutas o relativas a los archivos que se van a renombrar.

outputDir

Directorio donde escribir los archivos renombrados. Por defecto es el directorio de origen.

format

Instrucción en lenguaje natural que describe cómo deben formatearse los nombres de archivo. Cuando no se proporciona, la IA selecciona automáticamente el mejor patrón de nomenclatura para cada documento.

dryRun

Previsualice el renombrado sin escribir ningún archivo.

Ejemplos de instrucciones

El parámetro format acepta instrucciones en inglés simple. La IA las interpreta y las aplica a cada archivo según su contenido:

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

Puede especificar reglas por tipo de documento, lógica condicional, localización y más:

Prefijos de departamento — "Add HR_ prefix for employment documents, FIN_ for financial records"
Localización — "Use German date format DD.MM.YYYY, translate document types to German"
Lógica condicional — "If invoice amount > $1000, add LARGE_ prefix"
Formatos de industria — "Include matter number for legal documents, client code for accounting"

PDF Split

La IA lee el documento completo, identifica secciones lógicas y límites de temas, y crea PDFs nombrados individualmente para cada uno.

filePathrequired

Ruta al archivo PDF que se va a dividir.

strategy

Estrategia de división: ai (analiza el contenido y divide por tema), bookmarks (divide en los límites de marcadores del PDF) o pages (divide por rangos de páginas). Por defecto es ai.. Defaults to ai.

outputDir

Directorio donde escribir los archivos PDF divididos. Por defecto es el directorio de origen.

Anotaciones de Herramientas

Herramienta	Solo Lectura	Destructiva	Idempotente
`rename`	No	Sí (renombra archivos en el lugar)	No
`pdf_split`	No	No (crea nuevos archivos)	Sí
`watch`	Sí (informativo)	No	Sí
`status`	Sí	No	Sí

Ejemplos

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

La IA lee cada archivo (incluso imágenes escaneadas vía OCR), extrae fechas, proveedores, tipos de documentos y genera nombres descriptivos.

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

Aplica diferentes reglas de nomenclatura por tipo de documento con lógica condicional, todo desde una sola instrucción en inglés simple.

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

Analiza los límites de contenido y crea PDFs nombrados individualmente para cada sección lógica; no se requieren marcadores.

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

Muestra cómo serían los nuevos nombres de archivo sin mover ningún archivo. La IA maneja la localización y traducción en la nomenclatura.

Configuración

Claude Code

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

Claude Desktop

Agregue a claude_desktop_config.json:

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

Cursor

Agregue a su configuración MCP (Settings → MCP Servers) usando el mismo formato JSON.

Windsurf

Agregue a su configuración MCP usando el mismo formato JSON.

Manejo de Errores

Error	Causa	Resolución
Not configured	`RENAMED_API_KEY` no está configurada	Agregue su clave API al entorno (obtenga una aquí)
Authentication failed	Clave API inválida o expirada	Genere una nueva clave en (Configuración → Claves API)
Insufficient credits	Créditos de cuenta agotados	Recargue en (Configuración → Facturación)
Rate limit exceeded	Demasiadas solicitudes	Espere y reintente
Network error	No se puede contactar la API	Verifique su conexión a internet
File not found	Ruta de archivo inválida	Verifique que la ruta existe y es accesible

Seguridad

Clave API se lee solo de variables de entorno, nunca codificada o registrada
Contenidos de archivos se envían a la API de renamed.to para análisis; tenga en cuenta esto al procesar documentos sensibles
Se ejecuta localmente vía transporte stdio; no se abren puertos de red en su máquina
No se almacenan datos el servidor no tiene estado entre solicitudes

Requisitos

Node.js 20 o posterior. El servidor se instala automáticamente vía npx; no se necesita instalación manual.

Recursos

Repositorio GitHub Paquete npm Documentación API Documentación CLI