Iniziare con pdfmcp
Tre modi locali di usare pdfmcp: strumenti web gratuiti sul tuo dispositivo, il server MCP locale per gli agenti IA e l'API locale dal tuo codice, ognuno pronto in circa un minuto.
Tre modi di usare pdfmcp, tutti locali
pdfmcp è una cassetta degli attrezzi con tre porte, e tutte e tre sono dalla tua parte. Gli strumenti web di questo sito girano nel tuo browser, sul tuo dispositivo: il tuo file non viene mai caricato e non devi registrarti a nulla. Il server MCP locale espone le stesse operazioni come strumenti tipizzati che agenti IA come Claude e Cursor possono chiamare direttamente, girando sulla tua macchina. E l'API locale permette di chiamare le stesse operazioni dal tuo codice, anch'essa sulla tua macchina.
Tutte e tre sono gratuite per sempre. Nessun piano a pagamento, nessuna filigrana, nessun orologio di prova, nessun account, nessuna chiave e nessuna quota giornaliera: il tuo dispositivo fa il lavoro, quindi il tuo dispositivo è l'unico limite pratico.
Modo 1: Usa uno strumento web (senza registrazione)
Apri l'indice degli strumenti e scegli ciò che ti serve: unire, dividere, comprimere, convertire, OCR, firmare, oscurare e altro. Gli strumenti contrassegnati «Sul tuo dispositivo» elaborano il tuo file interamente in questa scheda del browser: rilascia il file, regola le opzioni e scarica il risultato. Nulla ci viene trasmesso, quindi non c'è nulla da conservare, registrare o far trapelare.
Alcune operazioni richiedono macchinari pesanti (OCR completo, conversione Office, crittografia). Quelle pagine sono contrassegnate «Locale · MCP» e spiegano come eseguire il lavoro localmente con il pacchetto, sulla tua macchina, con la stessa privacy.
Modo 2: Installa il pacchetto locale
Il pacchetto si installa una sola volta con il comando di installazione della pagina MCP. Dopo, gira interamente sulla tua macchina: nessun account da creare, nessuna chiave da copiare e nulla che scada.
I motori pesanti (qpdf, dati linguistici OCR) vengono scaricati una sola volta, con verifica SHA-256, al primo uso e restano sulla tua macchina per gli usi successivi.
Modo 3: Collega il server MCP locale al tuo agente IA
Il server MCP gira localmente (stdio) sulla stessa macchina del tuo agente. La maggior parte dei client accetta questa forma di configurazione, che fa avviare il pacchetto dal client:
{"mcpServers": {"pdfmcp": {"command": "uvx", "args": ["--from", "https://pdfmcp.org/downloads/pdfmcp-4.2.1-py3-none-any.whl", "pdfmcp"]}}}Riavvia il client dopo aver modificato la sua configurazione; gli strumenti pdfmcp appariranno nella sua lista. Guide passo passo per 13 client (Claude Desktop, Claude Code, ChatGPT, Cursor, VS Code, Windsurf, Codex, Gemini CLI, Zed, Cline, Continue, JetBrains e qualsiasi altro client MCP) sono collegate dalla pagina MCP. ChatGPT non può avviare processi locali, quindi dentro ChatGPT non c'è una porta locale: usa invece uno dei client locali.
La tua prima chiamata locale
Dal tuo codice o dal tuo terminale, il flusso è lo stesso di sempre, ma senza server remoto: installa il pacchetto, scegli un'operazione ed eseguila su un file della tua macchina. L'operazione legge il file localmente e scrive il risultato localmente.
Il catalogo delle operazioni di questo sito (ogni operazione, i suoi parametri e i suoi schemi) descrive anche il pacchetto locale, perché è lo stesso catalogo: ciò che vedi nelle pagine degli strumenti è ciò che il tuo agente e il tuo codice possono chiamare.
Limiti e privacy, sul serio
Gli unici limiti sono quelli del tuo dispositivo: memoria, velocità e, nel browser, file fino a circa 100 MB e 500 pagine. Non c'è nessuna quota da consumare né coda da aspettare.
La privacy è architetturale. Tutto gira localmente, quindi i tuoi file non lasciano mai la tua macchina, non vengono mai conservati su nessun server e non vengono mai usati per addestrare IA. L'unica cosa che questo sito raccoglie è l'analisi delle pagine (visualizzazioni e Google Analytics aggregato), che non tocca mai i tuoi documenti.
Collega il tuo agente IA — server MCP locale gratuito
Domande frequenti
pdfmcp è davvero gratuito?
Sì, gratis per sempre. Tutti gli strumenti girano localmente, senza account e senza filigrana. Non c'è nessun piano a pagamento: una cassa donazioni opzionale (attualmente disattivata) è tutto il modello di business.
Ho bisogno di un account?
No. Non ci sono account in pdfmcp: né per gli strumenti web, né per il server MCP locale, né per l'API locale.
Dove vanno i miei file?
Da nessuna parte: l'elaborazione avviene sul tuo dispositivo o sulla tua macchina, e i tuoi file non vengono mai caricati né usati per addestrare IA.
Come chiama il mio agente il server MCP locale?
Il tuo client avvia il pacchetto pdfmcp come processo locale (stdio) con la configurazione delle guide. Non c'è nessun header segreto da configurare, perché non c'è nessun server remoto.
C'è un limite giornaliero?
No. Nessuna quota giornaliera, nessun ritmo orario e nessun contatore: il tuo dispositivo è l'unico limite pratico.
Posso usare pdfmcp offline?
In gran parte sì: una volta caricate la pagina e le sue librerie, gli strumenti web funzionano nel tuo browser, e il pacchetto locale funziona sulla tua macchina. Solo i download dei motori al primo uso richiedono una connessione.
Pubblicato originariamente su https://pdfmcp.org/guides/getting-started/