PDFCheck MCP 서버

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

토큰 없이 (하루 10회 무료 검사)

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"
        }
    }
}

클라이언트 설정의 YOUR_API_TOKEN을 교체하세요. 익명으로 접근하려면 Authorization 헤더를 제거하세요.

{
    "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"
            }
        }
    }
}

연결 확인

먼저 어시스턴트에게 check_usage를 호출하도록 요청하세요. 그런 다음 파일을 읽고 base64로 인코딩할 수 있는 클라이언트로 PDF를 분석하세요. 원격 HTTP에서는 로컬 파일 경로만으로는 사용할 수 없습니다.

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

사용 가능한 MCP 도구

이 MCP 도구는 메타데이터 분석과 계정 기록을 다룹니다. 압축, 구조 검증, 서명 등 다른 브라우저 도구는 이 방식으로 제공되지 않습니다.

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"
        }
    }
}

응답 읽기

도구 결과는 result.content[0].text에 JSON 텍스트를 포함합니다. 이 텍스트를 파싱하여 success, data 및 remaining_checks를 읽으세요. 실패 시 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);

로컬 브리지 사용

다음 파일을 pdfcheck-mcp-server.mjs로 기기의 어디에든 저장하세요. 이 경량 스크립트가 AI 도구와 PDFCheck API를 연결합니다.

선택 사항인 로컬 스크립트는 Node.js 18 이상이 필요합니다. 원격 HTTP 연결에는 Node.js나 스크립트 다운로드가 필요하지 않습니다.

별도 디렉터리에 스크립트를 저장하고 그곳에 종속성을 설치하세요. 클라이언트 설정에는 스크립트의 전체 경로를 사용하세요.

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

스크립트 경로를 절대 경로로 바꾸세요. PDFCHECK_API_TOKEN을 계정 토큰으로 설정하거나 익명 분석에는 env를 생략하세요.

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

연결한 후에는 요청한 파일을 읽을 수 있는 클라이언트에서 다음 프롬프트를 사용하세요. 원격 analyze_pdf에는 file_base64와 filename이 필요하며, 로컬 경로만으로는 충분하지 않습니다. 로컬 브리지는 filePath를 받습니다.

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

사용 예시

연결한 후에는 요청한 파일을 읽을 수 있는 클라이언트에서 다음 프롬프트를 사용하세요. 원격 analyze_pdf에는 file_base64와 filename이 필요하며, 로컬 경로만으로는 충분하지 않습니다. 로컬 브리지는 filePath를 받습니다.

PDF 분석

/Users/me/Documents/contract.pdf 파일을 분석하고 언제 만들어졌는지, 어떤 소프트웨어가 사용되었는지 알려줘.

소프트웨어 지표 살펴보기

/Users/me/Downloads/report.pdf의 creator와 producer 필드를 살펴봐줘. 소프트웨어 지표를 AI 작성의 증거로 보지 말고 설명해줘.

일괄 분석

다운로드 폴더에서 내가 선택한 PDF를 하나씩 분석해줘. 기록된 생성 날짜와 수정 날짜를 비교하고, 누락되었거나 서로 맞지 않는 메타데이터를 설명해줘.

할당량 확인

오늘 PDFCheck에서 PDF 검사를 몇 번 더 할 수 있나요?

사용량과 한도

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

메타데이터 분석: 계정 없이 사용하거나 Free 플랜을 사용하면 업로드 한도는 50 MB입니다. Pro와 AI 플랜은 100 MB입니다.

API 메타데이터 분석은 처리 범위가 제한된 경량 모드를 사용합니다. 상세한 글꼴, 이미지 및 색상 분석은 생략되며 metadata.basic.partial_analysis는 true입니다.

메타데이터와 소프트웨어 지표는 작성자, 진위 또는 표준 준수를 입증하지 않습니다.

API 토큰 생성 선택사항

토큰을 비밀로 관리하세요. 환경 변수를 사용하고, 사용하지 않는 토큰은 계정에서 폐기하세요.

익명 접근은 IP당 하루 10회 메타데이터 분석을 허용합니다. API 토큰이 있는 무료 계정은 하루 100회 검사를 제공합니다. 나중에 계정에서 결과를 불러오려면 분석할 때 토큰을 사용하세요.

Model Context Protocol이란?

Model Context Protocol(MCP)은 AI 어시스턴트가 외부 도구 및 데이터 소스에 연결할 수 있게 해주는 개방형 표준입니다. 채팅 창에서 직접 AI 어시스턴트가 PDFCheck와 같은 서비스와 대화할 수 있게 해주는 범용 플러그라고 생각하세요.

원격 HTTP 서버는 클라이언트에서 base64로 인코딩된 PDF 내용을 받습니다. 선택 사항인 로컬 브리지는 사용자 컴퓨터의 PDF를 읽어 REST API로 업로드합니다. 두 방식 모두 메타데이터 분석 결과를 content[0].text 안의 JSON으로 반환합니다.

전송 방식 선택

Bearer 헤더를 사용하는 원격 HTTP MCP를 지원하는 클라이언트나, 로컬 stdio 브리지를 실행할 수 있는 클라이언트를 사용하세요. OAuth 전용 연결은 이 설정에서 지원되지 않습니다.

PDF는 HTTPS로 PDFCheck에 전송됩니다. MCP 클라이언트나 AI 제공업체도 설계에 따라 파일이나 도구 인수를 처리할 수 있습니다. 민감한 문서를 보내기 전에 해당 서비스의 데이터 정책과 PDFCheck 개인정보 처리방침을 확인하세요.

자주 묻는 질문