Vai al contenuto principale
Model Context Protocol

Server MCP di PDFCheck

Analizza, valida e ottimizza file PDF direttamente dai tuoi strumenti IA preferiti โ€” Claude Desktop, GitHub Copilot, Cursor e altri.

Configurazione rapida

Nessun account necessario โ€” ottieni 10 analisi PDF gratuite al giorno. Salva semplicemente lo script e configura il tuo strumento IA.

Cos'รจ il Model Context Protocol?

Il Model Context Protocol (MCP) รจ uno standard aperto che consente agli assistenti IA di connettersi a strumenti esterni e fonti di dati. Pensalo come una spina universale che permette al tuo assistente IA di comunicare con servizi come PDFCheck โ€” direttamente dalla tua finestra di chat.

Linguaggio naturale

Chiedi semplicemente alla tua IA di "analizzare questo PDF" e si occuperร  del resto โ€” nessuna chiamata API manuale necessaria.

Sicuro

Il tuo token API rimane locale sulla tua macchina. I file vengono elaborati e immediatamente eliminati.

Funziona ovunque

Compatibile con Claude Desktop, GitHub Copilot, Cursor, Windsurf e qualsiasi client compatibile con MCP.

Come funziona: Il server MCP viene eseguito localmente sulla tua macchina come un ponte leggero tra il tuo assistente IA e l'API PDFCheck. Quando chiedi alla tua IA di analizzare un PDF, questa chiama il server MCP locale, che inoltra in modo sicuro la richiesta alla nostra API e restituisce i risultati.

Prerequisiti

1

Crea un account PDFCheck gratuito Facoltativo

Facoltativo โ€” ottieni 10 analisi gratuite al giorno senza account. Registrati per sbloccare 50 analisi al giorno.

Crea account gratuito
2

Genera un token API Facoltativo

Per limiti piรน alti, vai alle impostazioni del tuo account e crea un token API. Incollalo nella Configurazione rapida sopra e tutte le configurazioni verranno aggiornate automaticamente.

Gestisci token API
3

Installa Node.js (v18+)

Lo script del server MCP richiede Node.js 18 o successivo. Scaricalo da nodejs.org se non lo hai installato.

Strumenti MCP disponibili

Una volta connesso, il tuo assistente IA ottiene accesso ai seguenti strumenti PDF:

analyze_pdf

POST

Carica e analizza un file PDF. Restituisce metadati, data di creazione, autore, software utilizzato, numero di pagine e stato di verifica.

get_analysis

GET

Recupera un'analisi PDF precedente tramite il suo token di condivisione. Utile per rivisitare o confrontare i risultati.

list_analyses

GET

Elenca tutte le tue analisi PDF precedenti. Restituisce un elenco paginato con nomi dei file, date e token di condivisione.

check_usage

GET

Controlla le informazioni del tuo account e la quota API giornaliera rimanente. Restituisce il tuo nome, email e quante analisi ti restano oggi.

Guida alla configurazione

Scegli il tuo metodo di configurazione. L'URL remoto รจ il piรน semplice โ€” nessun file da scaricare o installare.

Nessun file da scaricare o installare

Aggiungi semplicemente l'URL alla configurazione del tuo strumento IA. Il server MCP viene eseguito sulla nostra infrastruttura โ€” nessun Node.js, nessun npm install, nessuno script locale.

C

Claude Desktop

Apri Impostazioni โ†’ Sviluppatore โ†’ Modifica configurazione, poi aggiungi quanto segue al tuo claude_desktop_config.json:

claude_desktop_config.json

GitHub Copilot

VS Code

Aggiungi una configurazione del server MCP alle tue impostazioni VS Code. Crea o modifica .vscode/mcp.json nel tuo progetto, o aggiungilo alle tue impostazioni globali:

.vscode/mcp.json

Puoi anche impostare questo nelle tue impostazioni globali VS Code settings.json sotto "mcp.servers". GitHub Copilot rileverร  automaticamente gli strumenti MCP in modalitร  agente.

โŒ˜

Cursor

Vai a Impostazioni Cursor โ†’ MCP e aggiungi un nuovo server MCP globale, o crea .cursor/mcp.json nel tuo progetto:

.cursor/mcp.json
W

Windsurf

Apri Impostazioni Windsurf โ†’ MCP e aggiungi un nuovo server, o modifica il tuo mcp_config.json:

~/.codeium/windsurf/mcp_config.json

Inserisci il percorso completo dove hai salvato lo script. Gli snippet di configurazione sottostanti verranno aggiornati automaticamente.

C

Claude Desktop

Apri Impostazioni โ†’ Sviluppatore โ†’ Modifica configurazione, poi aggiungi quanto segue al tuo claude_desktop_config.json:

claude_desktop_config.json

Aggiorna il percorso sopra per corrispondere a dove hai salvato pdfcheck-mcp-server.mjs sulla tua macchina. La configurazione verrร  aggiornata automaticamente. Sostituisci your-api-token-here con il tuo vero token API (ottienine uno dalla pagina dei token API).

GitHub Copilot

VS Code

Aggiungi una configurazione del server MCP alle tue impostazioni VS Code. Crea o modifica .vscode/mcp.json nel tuo progetto, o aggiungilo alle tue impostazioni globali:

.vscode/mcp.json

Puoi anche impostare questo nelle tue impostazioni globali VS Code settings.json sotto "mcp.servers". GitHub Copilot rileverร  automaticamente gli strumenti MCP in modalitร  agente.

โŒ˜

Cursor

Vai a Impostazioni Cursor โ†’ MCP e aggiungi un nuovo server MCP globale, o crea .cursor/mcp.json nel tuo progetto:

.cursor/mcp.json
W

Windsurf

Apri Impostazioni Windsurf โ†’ MCP e aggiungi un nuovo server, o modifica il tuo mcp_config.json:

~/.codeium/windsurf/mcp_config.json

Script del server MCP

Salva il seguente file come pdfcheck-mcp-server.mjs in qualsiasi posizione sulla tua macchina. Questo script leggero collega il tuo strumento IA all'API PDFCheck.

Configurazione una tantum: Prima di utilizzare lo script, installa la dipendenza MCP SDK: npm install @modelcontextprotocol/sdk
pdfcheck-mcp-server.mjs
Suggerimento: Lo script non ha file di configurazione e nessun passaggio di compilazione. Salvalo, installa l'SDK e punta il tuo client MCP verso di esso. Tutto qui!

Esempi di utilizzo

Una volta connesso, puoi usare il linguaggio naturale per interagire con PDFCheck. Ecco alcune cose che puoi chiedere al tuo assistente IA:

Esempio 1 Analizzare un PDF

"Analizza il file /Users/me/Documents/contract.pdf e dimmi quando รจ stato creato e quale software รจ stato utilizzato."

Esempio 2 Verificare la generazione IA

"Controlla se questo PDF sembra essere stato generato dall'IA: /Users/me/Downloads/report.pdf"

Esempio 3 Analisi in batch

"Analizza tutti i PDF nella mia cartella Download e elenca quelli che sono stati modificati dopo la creazione."

Esempio 4 Controllare la quota

"Quante verifiche PDF mi restano oggi su PDFCheck?"

Domande frequenti

Ho bisogno di un token API?

No! Puoi usare il server MCP senza un token API e ottenere 10 analisi PDF gratuite al giorno. Per 50 analisi al giorno, crea un account gratuito e genera un token API.

Il server MCP รจ gratuito?

Sรฌ! Il server MCP รจ completamente gratuito. Senza account ottieni 10 analisi gratuite al giorno. Registra un account gratuito per ottenere 50 analisi al giorno.

I miei file PDF vengono memorizzati sui vostri server?

No. I PDF vengono elaborati in memoria e immediatamente eliminati dopo l'analisi. Solo i metadati estratti vengono memorizzati nella cronologia del tuo account.

Il server MCP invia i miei file a terze parti?

Il server MCP comunica solo con pdf.businesspress.io. I tuoi file vanno direttamente dalla tua macchina alla nostra API tramite HTTPS. Nessun dato viene inviato al tuo provider IA โ€” vedono solo i risultati testuali.

Cosa succede se il mio strumento IA non รจ elencato qui?

Qualsiasi strumento che supporta il Model Context Protocol dovrebbe funzionare. Il server utilizza il trasporto stdio standard. Consulta la documentazione del tuo strumento su come aggiungere un server MCP usando il formato "command" + "args".

Qual รจ la dimensione massima del file PDF?

L'API accetta file PDF fino a 100 MB.

Posso usare questo con la mia istanza PDFCheck auto-ospitata?

Sรฌ. Modifica la costante API_BASE nello script del server per puntare all'URL della tua istanza.

Pronto a connettere i tuoi strumenti IA?

Crea un account gratuito, ottieni il tuo token API e inizia ad analizzare PDF dal tuo assistente IA preferito in pochi minuti.