Claude Desktop + pdfmcp: guia de configuração

Adicione o pdfmcp ao Claude Desktop como um servidor MCP local.

Apenas local. As mesmas 74 ferramentas, rodando na sua máquina: sem conta, sem chave, sem limites. Com Claude Desktop, a configuração desta página executa o pdfmcp na sua máquina; você pode reinstalar ou trocar de cliente quando quiser trocando a configuração.

O que você precisa: o pacote pdfmcp local: instale-o uma vez (ou deixe o uvx baixá-lo na primeira inicialização). Sem conta, sem chave e sem nenhum segredo para substituir.

Onde vai: claude_desktop_config.json (Claude Desktop → Settings → Developer → Edit Config)

{
  "mcpServers": {
    "pdfmcp": {
      "command": "uvx",
      "args": [
        "--from",
        "https://pdfmcp.org/downloads/pdfmcp-4.2.1-py3-none-any.whl",
        "pdfmcp"
      ]
    }
  }
}

Passos

Merge the config below into claude_desktop_config.json (create the file if it doesn't exist).
Fully restart Claude Desktop.
Drop in a PDF and ask Claude to extract the text — it happens on this machine.

Local servers live in the config file — the Settings → Connectors UI is for remote servers and can't start local processes.

uvx downloads the pdfmcp package on first launch and keeps it cached. No key is involved: the tools run on this machine.

Solução de problemas

O servidor local não inicia: instale o pacote uma vez com pip install https://pdfmcp.org/downloads/pdfmcp-4.2.1-py3-none-any.whl e rode pdfmcp em um terminal para ver o erro — geralmente um download de pacote bloqueado, ou Python anterior ao 3.11.
As ferramentas não aparecem: reinicie completamente o cliente depois de editar sua configuração; a maioria dos clientes só carrega servidores MCP na inicialização.
Um mecanismo não inicia: os mecanismos pesados são baixados uma única vez no primeiro uso; confira sua conexão para esse download e tente de novo: depois tudo funciona localmente.

Experimente com

No dispositivoPDF para textoExtraia texto simples, uma seção por página separada por form-feed.No dispositivoComprimir PDFReduza o tamanho do arquivo com Ghostscript. Predefinições: leve (qualidade de impressora), média (ebook), pesada (tela, a menor).Local · MCPOCR — PDF pesquisávelTorne um PDF digitalizado pesquisável: páginas sem camada de texto passam por OCR com Tesseract e ganham uma camada de texto invisível; páginas que já têm texto são mantidas e relatadas como ignoradas.

Mais clientes: Claude Code configuração do MCP · ChatGPT configuração do MCP · Cursor configuração do MCP · Todos os guias de configuração do MCP · Guia da API local