Server MCP di PDFCheck

Connetti tramite HTTP

Add this URL to a client that supports remote HTTP MCP servers. For account access, configure a bearer Authorization header.

https://pdfcheck.online/api/mcp

Senza token (10 verifiche gratuite/giorno)

To analyze a PDF, your assistant needs a file-reading tool that can send its base64 contents. Connecting MCP alone does not provide access to your files.

{
    "mcpServers": {
        "pdfcheck": {
            "url": "https://pdfcheck.online/api/mcp"
        }
    }
}

Sostituisci YOUR_API_TOKEN nella configurazione del client. Rimuovi l’header Authorization per usare l’accesso anonimo.

{
    "mcpServers": {
        "pdfcheck": {
            "url": "https://pdfcheck.online/api/mcp",
            "headers": {
                "Authorization": "Bearer YOUR_API_TOKEN"
            }
        }
    }
}

{
    "servers": {
        "pdfcheck": {
            "type": "http",
            "url": "https://pdfcheck.online/api/mcp",
            "headers": {
                "Authorization": "Bearer YOUR_API_TOKEN"
            }
        }
    }
}

{
    "mcpServers": {
        "pdfcheck": {
            "serverUrl": "https://pdfcheck.online/api/mcp",
            "headers": {
                "Authorization": "Bearer YOUR_API_TOKEN"
            }
        }
    }
}

Verifica la connessione

Chiedi prima al tuo assistente di chiamare check_usage. Poi analizza un PDF con un client che possa leggere il file e codificarlo in base64. Un percorso locale da solo non funziona con HTTP remoto.

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "check_usage",
        "arguments": {}
    }
}

Strumenti MCP disponibili

Questi strumenti MCP offrono analisi dei metadati e cronologia dell’account. Compressione, verifica strutturale, firma e altri strumenti del browser non sono disponibili tramite questi metodi.

Send the PDF contents

The analyze_pdf tool accepts file_base64 and filename. Your client must read the PDF and encode it as base64; a local file path alone will not work.

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "analyze_pdf",
        "arguments": {
            "file_base64": "BASE64_PDF_CONTENT",
            "filename": "document.pdf"
        }
    }
}

Leggi la risposta

I risultati degli strumenti contengono testo JSON in result.content[0].text. Analizza il testo per leggere success, data e remaining_checks; in caso di errore può essere restituito anche isError.

if (response.error) throw new Error(response.error.message);
const payload = JSON.parse(response.result.content[0].text);
if (response.result.isError || payload.success === false) {
  throw new Error(payload.message || payload.error);
}
console.log(payload.data, payload.remaining_checks);

Usa il bridge locale

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.

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

Salva lo script in una cartella dedicata, installa lì le sue dipendenze e usa il percorso completo dello script nella configurazione del client.

mkdir pdfcheck-mcp
cd pdfcheck-mcp
npm init -y
npm install @modelcontextprotocol/sdk@1 zod

#!/usr/bin/env node
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { z } from "zod";
import { readFileSync } from "node:fs";
import { basename } from "node:path";

const API_BASE = "https://pdfcheck.online/api/v1";
const TOKEN = process.env.PDFCHECK_API_TOKEN || null;
const headers = TOKEN
  ? { Authorization: `Bearer ${TOKEN}`, Accept: "application/json" }
  : { Accept: "application/json" };

const server = new McpServer({ name: "pdfcheck", version: "1.0.0" });
const result = (data) => ({
  content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
});

server.tool(
  "analyze_pdf",
  "Inspect PDF metadata, dates, software fields, and page count.",
  { filePath: z.string().describe("Absolute path to the PDF file") },
  async ({ filePath }) => {
    const file = new Blob([readFileSync(filePath)], { type: "application/pdf" });
    const body = new FormData();
    body.append("file", file, basename(filePath));
    const response = await fetch(`${API_BASE}/pdf/analyze`, {
      method: "POST", headers, body,
    });
    return result(await response.json());
  }
);

server.tool(
  "get_analysis",
  "Retrieve an accessible analysis by its share token.",
  { token: z.string().describe("Analysis share token") },
  async ({ token }) => {
    const response = await fetch(`${API_BASE}/pdf/${encodeURIComponent(token)}`, { headers });
    return result(await response.json());
  }
);

server.tool("list_analyses", "List your account analyses.", {}, async () => {
  const response = await fetch(`${API_BASE}/pdf`, { headers });
  return result(await response.json());
});

server.tool("check_usage", "Check your account allowance.", {}, async () => {
  const response = await fetch(`${API_BASE}/user`, { headers });
  return result(await response.json());
});

await server.connect(new StdioServerTransport());

Claude / Cursor

Sostituisci il percorso dello script con il suo percorso assoluto. Imposta PDFCHECK_API_TOKEN sul token del tuo account oppure ometti env per l’analisi anonima.

{
    "mcpServers": {
        "pdfcheck": {
            "command": "node",
            "args": [
                "/absolute/path/pdfcheck-mcp-server.mjs"
            ],
            "env": {
                "PDFCHECK_API_TOKEN": "YOUR_API_TOKEN"
            }
        }
    }
}

Usa queste richieste con un client in grado di leggere i file indicati. Lo strumento remoto analyze_pdf richiede file_base64 e filename; il solo percorso locale non basta. Il ponte locale accetta filePath.

{
    "name": "analyze_pdf",
    "arguments": {
        "filePath": "/absolute/path/document.pdf"
    }
}

Esempi di utilizzo

Usa queste richieste con un client in grado di leggere i file indicati. Lo strumento remoto analyze_pdf richiede file_base64 e filename; il solo percorso locale non basta. Il ponte locale accetta filePath.

Analizzare un PDF

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

Esaminare gli indicatori del software

Esamina i campi creator e producer di /Users/me/Downloads/report.pdf. Spiega gli indicatori del software senza considerarli una prova di paternità di un’IA.

Analisi in batch

Analizza uno alla volta i PDF che seleziono dalla cartella Download. Confronta le date di creazione e modifica riportate e spiega i metadati mancanti o incoerenti.

Controllare la quota

Quante verifiche PDF mi restano oggi su PDFCheck?

Utilizzo e limiti

Anonymous metadata analysis: 10 checks per day per IP. Free account: 100 checks per day. Individual tools can have different limits.

Per analizzare i metadati: senza account e con Free, il limite di caricamento è di 50 MB. Con Pro e AI, è di 100 MB.

L’analisi dei metadati dell’API usa una modalità leggera e limitata. L’analisi dettagliata di font, immagini e colori viene saltata; metadata.basic.partial_analysis è true.

I metadati e gli indicatori del software non dimostrano paternità, autenticità o conformità agli standard.

Genera un token API Facoltativo

Mantieni segreti i token. Usa una variabile d’ambiente e revoca i token inutilizzati dal tuo account.

L’accesso anonimo consente 10 analisi dei metadati al giorno per indirizzo IP. Un account gratuito con token API offre 100 verifiche al giorno. Usa il token durante l’analisi se vuoi recuperare il risultato dal tuo account in seguito.

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.

Il server HTTP remoto riceve dal client il contenuto PDF codificato in base64. Il ponte locale opzionale legge un PDF dal computer e lo carica tramite l’API REST. Entrambi restituiscono l’analisi dei metadati come JSON in content[0].text.

Funziona ovunque

Usa un client che supporti MCP HTTP remoto con intestazioni Bearer o che possa eseguire il ponte stdio locale. Questa configurazione non supporta connessioni che utilizzano solo OAuth.

Il PDF viene inviato a PDFCheck tramite HTTPS. Anche il client MCP o il provider IA può elaborare il file o gli argomenti dello strumento, a seconda del suo funzionamento. Consulta le relative politiche sui dati e l’Informativa sulla privacy di PDFCheck prima di inviare documenti sensibili.

Domande frequenti