Claude Code + pdfmcp: guida alla configurazione

Aggiungi pdfmcp a Claude Code con un comando, oppure tramite .mcp.json.

Solo locale. Gli stessi 74 strumenti, sulla tua macchina: niente account, niente chiave, niente limiti. Con Claude Code, la configurazione di questa pagina esegue pdfmcp sulla tua macchina; puoi reinstallare o cambiare client quando vuoi scambiando la configurazione.

Cosa ti serve: il pacchetto pdfmcp locale: installalo una volta (o lascia che uvx lo scarichi al primo avvio). Niente account, niente chiave e nessun segreto da sostituire.

Dove va: 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

Passaggi

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):

Configurazione

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

Risoluzione dei problemi

Il server locale non si avvia: installa il pacchetto una volta con pip install https://pdfmcp.org/downloads/pdfmcp-4.2.1-py3-none-any.whl ed esegui pdfmcp in un terminale per vedere l'errore — di solito un download del pacchetto bloccato, o Python precedente alla 3.11.
Gli strumenti non appaiono: riavvia completamente il client dopo aver modificato la sua configurazione; la maggior parte dei client carica i server MCP solo all'avvio.
Un motore non si avvia: i motori pesanti vengono scaricati una sola volta al primo uso; verifica la tua connessione per quel download e riprova: dopo, tutto funziona localmente.

Provalo con

Sul dispositivoComprimi PDFRiduci le dimensioni del file con Ghostscript. Preset: leggero (qualità di stampa), medio (ebook), pesante (schermo, il più piccolo).Locale · MCPOCR — PDF ricercabileRendi ricercabile un PDF scansionato: le pagine senza livello di testo vengono sottoposte a OCR con Tesseract e acquisiscono un livello di testo invisibile; le pagine che hanno già testo vengono mantenute e segnalate come saltate.Locale · MCPPDF in Word (DOCX)Converti un PDF in un documento Word modificabile. Conversione basata sul testo: paragrafi e intestazioni vengono ricostruiti dal livello di testo; layout esatto, tabelle e immagini non vengono preservati.

Altri client: Claude Desktop Configurazione MCP · ChatGPT Configurazione MCP · Cursor Configurazione MCP · Tutte le guide di configurazione MCP · Guida all'API locale