MarkItDown no Claude — pare de queimar token com PDF (setup de 2 minutos)

Essa é a página que prometi no Reel. Em uns 2 minutos você conecta o MarkItDown da Microsoft no seu Claude e, a partir daí, todo arquivo que você sobe chega já convertido em texto limpo, antes do Claude ler.

Por que isso importa

Quando você sobe um PDF, o Claude tem que processar o arquivo inteiro: formatação, tabela quebrada, imagem, metadado, todo o lixo junto. Cada página pode custar entre 1.500 e 3.000 tokens. Um documento de 20 páginas queima dezenas de milhares de tokens antes de você fazer a primeira pergunta.

O MarkItDown converte o arquivo pra Markdown, que é um texto limpo e estruturado. Resultado: até 70% menos token gasto, e respostas melhores, porque a IA lê Markdown muito melhor do que PDF.

É uma ferramenta gratuita e open-source da Microsoft, com mais de 140 mil estrelas no GitHub.

O que você vai precisar

• Python 3.10 ou mais novo

• Claude Desktop (o app de computador, não a versão do navegador)

• Uns 2 minutos

Passo a passo

1. Instale o Python 3.10+

Baixe em python.org e rode o instalador. No Windows, marque a caixinha "Add Python to PATH" durante a instalação. É importante.

2. Abra o terminal

• Mac: abra o app Terminal.

• Windows: abra o PowerShell.

3. Instale o gerenciador uv

Cole o comando do seu sistema e dê Enter.

Mac / Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows (PowerShell):

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

4. Abra o Claude Desktop → Settings → Developer

Clique no menu Claude (canto superior esquerdo), abra Settings e vá na aba Developer na lateral.

5. Clique em "Edit Config" e cole este bloco

Cole o JSON abaixo no arquivo de configuração, salve e feche.

{"mcpServers":{"markitdown":{"command":"uvx","args":["markitdown-mcp"]}}}

Se já tiver outros servidores MCP ali dentro, é só adicionar o "markitdown" junto, sem apagar o resto.

6. Feche o Claude Desktop por completo e abra de novo

Feche o app inteiro (não só a janela) e abra de novo, pra ele carregar o novo servidor.

7. Teste — suba um PDF ou um Word

Arrasta um arquivo pro chat. O MarkItDown converte pra Markdown limpo antes do Claude ler. Pronto.

Formatos que ele converte

PDF, Word, Excel, PowerPoint, imagens (com leitura de texto), áudio (com transcrição), HTML, CSV, JSON, e até link de vídeo do YouTube.

Quando dá ruído

• "Não apareceu a ferramenta no Claude": confira se fechou o app por completo antes de reabrir. Só fechar a janela não funciona.

• "Comando uvx não encontrado": o passo 3 (uv) não rodou completo, ou faltou marcar "Add Python to PATH" no passo 1. Refaça os dois.

• "Quero ver o que ele faz com cada arquivo": sobe um PDF e pede pro Claude "me mostra o markdown que você recebeu desse arquivo".

Quer ir além?

Repositório oficial: github.com/microsoft/markitdown