Renamed.to logorenamed.to
Voltar para renamed.to
Documentação

Model Context Protocol

MCP Server

Traga renomeação de arquivos, organização e divisão de PDFs com IA para Claude Code, Claude Desktop, Cursor, Windsurf e qualquer cliente compatível com MCP. Diga à IA como você quer que seus arquivos sejam nomeados usando português simples — ela lê o conteúdo real do documento e segue suas instruções.

Recursos

  • Comandos em linguagem natural — descreva suas regras de nomenclatura em português simples (regras por tipo de documento, lógica condicional, localização)
  • Análise de conteúdo por IA — OCR e NLP extraem datas, fornecedores, valores, tipos de documento e números de referência do conteúdo dos arquivos
  • Divisão de PDF — divida PDFs por conteúdo/tópico (IA), marcadores ou intervalos de páginas
  • Estratégias de organização — organize automaticamente em pastas por ano, empresa, tipo de documento ou combinações
  • Modo de teste — visualize as renomeações antes de confirmar as alterações

Início Rápido

Adicione ao Claude Code com um único comando:

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

Defina sua chave de API e você está pronto para começar:

$ export RENAMED_API_KEY="rt_..."

Usando Claude Desktop, Cursor ou Windsurf? Adicione ao seu arquivo de configuração MCP:

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

Autenticação

  1. Cadastre-se para uma conta renamed.to
  2. Configurações → Chaves de API e crie uma chave
  3. Defina a variável de ambiente em sua configuração MCP

O servidor também aceita RENAMED_TOKEN como alternativa. Use a ferramenta status para verificar sua conexão.

Ferramentas

rename

Renomeação de arquivos com IA usando comandos em linguagem natural

filePathsoutputDir?format?dryRun?
pdf_split

Divida PDFs por conteúdo, marcadores ou intervalos de páginas

filePathstrategy?outputDir?
watch

Monitore um diretório em busca de novos arquivos (delega para CLI)

directoryoutputDir?
status

Verifique a autenticação e conectividade da API

Rename

Envia arquivos para a API renamed.to que lê o conteúdo real do documento — OCR para digitalizações, NLP para texto — extrai metadados (datas, fornecedores, valores, números de referência) e gera nomes de arquivo com base em suas instruções.

filePathsrequired

Caminhos absolutos ou relativos para os arquivos a serem renomeados.

outputDir

Diretório para gravar os arquivos renomeados. O padrão é o diretório de origem.

format

Comando em linguagem natural descrevendo como os nomes de arquivo devem ser formatados. Quando não fornecido, a IA seleciona automaticamente o melhor padrão de nomenclatura para cada documento.

dryRun

Visualize a renomeação sem gravar nenhum arquivo.

Exemplos de comandos

O parâmetro format aceita instruções em português simples. A IA as interpreta e as aplica a cada arquivo com base em seu conteúdo:

Faturas: {data} - {fornecedor} - Fatura #{numero} - R${valor}
Contratos: {fornecedor} - {tipo} - {data}
Recibos: {data} - {fornecedor} - Recibo

Você pode especificar regras por tipo de documento, lógica condicional, localização e muito mais:

  • Prefixos de departamento — "Adicione prefixo RH_ para documentos de emprego, FIN_ para registros financeiros"
  • Localização — "Use formato de data brasileiro DD/MM/AAAA, traduza tipos de documento para português"
  • Lógica condicional — "Se o valor da fatura > R$1000, adicione prefixo GRANDE_"
  • Formatos por setor — "Inclua número do processo para documentos jurídicos, código do cliente para contabilidade"

PDF Split

A IA lê o documento completo, identifica seções lógicas e limites de tópicos, e cria PDFs nomeados individualmente para cada um.

filePathrequired

Caminho para o arquivo PDF a ser dividido.

strategy

Estratégia de divisão: ai (analisa conteúdo e divide por tópico), bookmarks (divide nos limites de marcadores do PDF) ou pages (divide por intervalos de páginas). O padrão é ai.. Defaults to ai.

outputDir

Diretório para gravar os arquivos PDF divididos. O padrão é o diretório de origem.

Anotações das Ferramentas

FerramentaSomente LeituraDestrutivoIdempotente
renameNãoSim (renomeia arquivos no local)Não
pdf_splitNãoNão (cria novos arquivos)Sim
watchSim (informativo)NãoSim
statusSimNãoSim

Exemplos

"Renomeie todos os PDFs na minha pasta Downloads com base no conteúdo deles"

A IA lê cada arquivo — até imagens digitalizadas via OCR — extrai datas, fornecedores, tipos de documento e gera nomes descritivos.

"Renomeie esses arquivos. Para faturas use '{data} - {fornecedor} - Fatura #{numero}', para contratos use '{fornecedor} - {tipo} - {data}', e adicione prefixo GRANDE_ se o valor for superior a R$1000"

Aplica diferentes regras de nomenclatura por tipo de documento com lógica condicional, tudo a partir de um único comando em português simples.

"Divida este relatório anual de 50 páginas em documentos separados por tópico"

Analisa os limites de conteúdo e cria PDFs nomeados individualmente para cada seção lógica — sem marcadores necessários.

"Faça uma renomeação de teste dessas faturas usando formato de data brasileiro DD/MM/AAAA e traduza tipos de documento para português"

Mostra como seriam os novos nomes de arquivo sem mover nenhum arquivo. A IA lida com localização e tradução na nomenclatura.

Configuração

Claude Code

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

Claude Desktop

Adicione ao claude_desktop_config.json:

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

Cursor

Adicione à sua configuração MCP (Settings → MCP Servers) usando o mesmo formato JSON.

Windsurf

Adicione à sua configuração MCP usando o mesmo formato JSON.

Tratamento de Erros

ErroCausaResolução
Não configuradoRENAMED_API_KEY não definidaAdicione sua chave de API ao ambiente (obtenha uma aqui)
Autenticação falhouChave de API inválida ou expiradaGere uma nova chave em (Configurações → Chaves de API)
Créditos insuficientesCréditos da conta esgotadosRecarregue em (Configurações → Faturamento)
Limite de taxa excedidoMuitas solicitaçõesAguarde e tente novamente
Erro de redeNão é possível alcançar a APIVerifique sua conexão com a internet
Arquivo não encontradoCaminho de arquivo inválidoVerifique se o caminho existe e está acessível

Segurança

  • Chave de API é lida apenas de variáveis de ambiente — nunca codificada ou registrada
  • Conteúdo dos arquivos é enviado para a API renamed.to para análise — esteja ciente disso ao processar documentos sensíveis
  • Executa localmente via transporte stdio — nenhuma porta de rede é aberta em sua máquina
  • Nenhum dado armazenado o servidor é stateless entre solicitações

Requisitos

Node.js 20 ou posterior. O servidor é instalado automaticamente via npx — nenhuma instalação manual necessária.

Recursos

Repositório GitHubPacote npmDocumentação da APIDocumentação do CLI