PDFCheck MCP 서버
선호하는 AI 도구에서 직접 PDF 파일을 분석, 검증, 최적화하세요 — Claude Desktop, GitHub Copilot, Cursor 등.
빠른 설정
✓ 토큰이 적용되었습니다 — 아래 모든 설정이 업데이트되었습니다. 토큰을 붙여넣으면 아래의 모든 설정 예제가 자동으로 업데이트됩니다.
계정이 필요 없습니다 — 하루 10회 무료 PDF 분석을 이용할 수 있습니다. 스크립트를 저장하고 AI 도구를 설정하기만 하면 됩니다.
Model Context Protocol이란?
Model Context Protocol(MCP)은 AI 어시스턴트가 외부 도구 및 데이터 소스에 연결할 수 있게 해주는 개방형 표준입니다. 채팅 창에서 직접 AI 어시스턴트가 PDFCheck와 같은 서비스와 대화할 수 있게 해주는 범용 플러그라고 생각하세요.
자연어
AI에게 "이 PDF를 분석해줘"라고 요청하면 나머지를 처리합니다 — 수동 API 호출이 필요 없습니다.
안전
API 토큰이 사용자 기기에 로컬로 유지됩니다. 파일은 처리 후 즉시 삭제됩니다.
어디서나 작동
Claude Desktop, GitHub Copilot, Cursor, Windsurf 및 모든 MCP 호환 클라이언트와 호환됩니다.
작동 방식: MCP 서버는 AI 어시스턴트와 PDFCheck API 사이의 경량 브릿지로서 사용자 기기에서 로컬로 실행됩니다. AI에게 PDF 분석을 요청하면 로컬 MCP 서버를 호출하고, 이 서버가 요청을 안전하게 API로 전달하여 결과를 반환합니다.
사전 요구사항
사용 가능한 MCP 도구
연결되면 AI 어시스턴트가 다음 PDF 도구에 액세스할 수 있습니다:
analyze_pdf
POSTPDF 파일을 업로드하고 분석합니다. 메타데이터, 생성 날짜, 작성자, 사용된 소프트웨어, 페이지 수, 검증 상태를 반환합니다.
get_analysis
GET공유 토큰으로 이전 PDF 분석을 가져옵니다. 결과를 다시 확인하거나 비교할 때 유용합니다.
list_analyses
GET이전의 모든 PDF 분석을 나열합니다. 파일 이름, 날짜, 공유 토큰이 포함된 페이지 분할된 목록을 반환합니다.
check_usage
GET계정 정보와 남은 일일 API 할당량을 확인합니다. 이름, 이메일, 오늘 남은 분석 횟수를 반환합니다.
설정 가이드
설정 방법을 선택하세요. 원격 URL이 가장 쉽습니다 — 다운로드하거나 설치할 파일이 없습니다.
다운로드하거나 설치할 파일 없음
AI 도구 설정에 URL만 추가하세요. MCP 서버가 저희 인프라에서 실행됩니다 — Node.js, npm install, 로컬 스크립트 모두 불필요합니다.
Claude Desktop
설정 → 개발자 → 설정 편집을 열고 claude_desktop_config.json에 다음을 추가하세요:
GitHub Copilot
VS CodeVS Code 설정에 MCP 서버 구성을 추가하세요. 프로젝트에 .vscode/mcp.json을 만들거나 편집하거나 전역 설정에 추가하세요:
전역 VS Code settings.json의 "mcp.servers" 아래에서도 설정할 수 있습니다. GitHub Copilot은 에이전트 모드에서 자동으로 MCP 도구를 감지합니다.
Cursor
Cursor 설정 → MCP로 이동하여 새 전역 MCP 서버를 추가하거나 프로젝트에 .cursor/mcp.json을 만드세요:
Windsurf
Windsurf 설정 → MCP를 열고 새 서버를 추가하거나 mcp_config.json을 편집하세요:
스크립트를 저장한 전체 경로를 입력하세요. 아래의 구성 스니펫이 자동으로 업데이트됩니다.
Claude Desktop
설정 → 개발자 → 설정 편집을 열고 claude_desktop_config.json에 다음을 추가하세요:
위의 경로를 pdfcheck-mcp-server.mjs를 저장한 위치와 일치하도록 업데이트하세요. 구성이 자동으로 업데이트됩니다. your-api-token-here를 실제 API 토큰으로 교체하세요(API 토큰 페이지에서 받을 수 있습니다).
GitHub Copilot
VS CodeVS Code 설정에 MCP 서버 구성을 추가하세요. 프로젝트에 .vscode/mcp.json을 만들거나 편집하거나 전역 설정에 추가하세요:
전역 VS Code settings.json의 "mcp.servers" 아래에서도 설정할 수 있습니다. GitHub Copilot은 에이전트 모드에서 자동으로 MCP 도구를 감지합니다.
Cursor
Cursor 설정 → MCP로 이동하여 새 전역 MCP 서버를 추가하거나 프로젝트에 .cursor/mcp.json을 만드세요:
Windsurf
Windsurf 설정 → MCP를 열고 새 서버를 추가하거나 mcp_config.json을 편집하세요:
MCP 서버 스크립트
다음 파일을 pdfcheck-mcp-server.mjs로 기기의 어디에든 저장하세요. 이 경량 스크립트가 AI 도구와 PDFCheck API를 연결합니다.
npm install @modelcontextprotocol/sdk
사용 예시
연결되면 자연어로 PDFCheck와 상호작용할 수 있습니다. AI 어시스턴트에게 요청할 수 있는 몇 가지 예시입니다:
"/Users/me/Documents/contract.pdf 파일을 분석하고 언제 만들어졌는지, 어떤 소프트웨어가 사용되었는지 알려줘."
"이 PDF가 AI로 생성된 것 같은지 확인해줘: /Users/me/Downloads/report.pdf"
"다운로드 폴더의 모든 PDF를 분석하고 생성 후 수정된 것들을 나열해줘."
"오늘 PDFCheck에서 PDF 검사를 몇 번 더 할 수 있나요?"
자주 묻는 질문
API 토큰이 필요한가요?
아니요! API 토큰 없이 MCP 서버를 사용할 수 있으며 하루 10회 무료 PDF 분석이 제공됩니다. 하루 50회 분석을 원하시면 무료 계정을 만들고 API 토큰을 생성하세요.
MCP 서버는 무료인가요?
네! MCP 서버는 완전히 무료입니다. 계정 없이 하루 10회 무료 분석이 가능합니다. 무료 계정을 등록하면 하루 50회 분석이 가능합니다.
내 PDF 파일이 서버에 저장되나요?
아니요. PDF는 메모리에서 처리되며 분석 후 즉시 삭제됩니다. 추출된 메타데이터만 계정 기록에 저장됩니다.
MCP 서버가 내 파일을 제3자에게 보내나요?
MCP 서버는 pdf.businesspress.io와만 통신합니다. 파일은 HTTPS를 통해 사용자 기기에서 직접 API로 전송됩니다. AI 제공자에게는 데이터가 전송되지 않습니다 — 텍스트 결과만 볼 수 있습니다.
내 AI 도구가 여기에 나열되지 않은 경우는?
Model Context Protocol을 지원하는 모든 도구에서 작동합니다. 서버는 표준 stdio 전송을 사용합니다. "command" + "args" 형식으로 MCP 서버를 추가하는 방법은 도구의 문서를 확인하세요.
PDF 파일의 최대 크기는?
API는 최대 100MB의 PDF 파일을 허용합니다.
자체 호스팅된 PDFCheck 인스턴스에서 사용할 수 있나요?
네. 서버 스크립트의 API_BASE 상수를 자신의 인스턴스 URL로 변경하세요.
AI 도구를 연결할 준비가 되셨나요?
무료 계정을 만들고, API 토큰을 받고, 몇 분 안에 선호하는 AI 어시스턴트에서 PDF 분석을 시작하세요.