Claude Code + pdfmcp: guia de configuração

Adicione o pdfmcp ao Claude Code com um comando, ou via .mcp.json.

Apenas local. As mesmas 74 ferramentas, rodando na sua máquina: sem conta, sem chave, sem limites. Com Claude Code, 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: Wherever your client keeps its MCP server list

claude mcp add pdfmcp -- uvx --from https://pdfmcp.org/downloads/pdfmcp-4.2.1-py3-none-any.whl pdfmcp

Passos

Run the command above (or add the JSON below to .mcp.json in your project root).
Restart Claude Code and run /mcp to confirm pdfmcp is connected.
Try: “Use pdfmcp to merge these two PDFs” — it runs on this machine.

Project-scoped .mcp.json alternative (same local server, no key):

Configuração

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

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 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.Local · MCPPDF para Word (DOCX)Converta um PDF em um documento Word editável. Conversão baseada em texto: parágrafos e títulos são reconstruídos a partir da camada de texto; layout exato, tabelas e imagens não são preservados.

Mais clientes: Claude Desktop 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