pdfmcp 시작하기

pdfmcp를 사용하는 세 가지 로컬 방법: 사용자 기기에서 실행되는 무료 웹 도구, AI 에이전트를 위한 로컬 MCP 서버, 사용자의 코드에서 사용하는 로컬 API. 각각 약 1분이면 준비됩니다.

pdfmcp를 사용하는 세 가지 방법, 모두 로컬

pdfmcp는 세 개의 문이 있는 도구 상자이며, 세 문 모두 사용자의 편에 있습니다. 이 사이트의 웹 도구는 사용자의 브라우저, 사용자의 기기에서 실행됩니다. 파일이 업로드되는 일은 없으며 무엇에도 가입할 필요가 없습니다. 로컬 MCP 서버는 Claude, Cursor 같은 AI 에이전트가 직접 호출할 수 있는 타입 지정 도구로 같은 작업을 공개하며 사용자의 컴퓨터에서 실행됩니다. 그리고 로컬 API를 이용하면 사용자의 코드에서 같은 작업을 역시 사용자의 컴퓨터에서 호출할 수 있습니다.

세 가지 모두 영원히 무료입니다. 유료 등급도, 워터마크도, 평가판 시계도, 계정도, 키도, 일일 한도도 없습니다. 사용자의 기기가 작업을 수행하므로 사용자의 기기가 유일한 실질적 제한입니다.

방법 1: 웹 도구 사용(가입 없음)

도구 색인을 열고 필요한 것을 선택하세요. 병합, 분할, 압축, 변환, OCR, 서명, 가리기 등 다수입니다. «사용자 기기에서»로 표시된 도구는 이 브라우저 탭에서 파일을 완전히 처리합니다. 파일을 놓고, 옵션을 조정하고, 결과를 다운로드하세요. 저희에게 전송되는 것은 없으므로 저장하거나 기록하거나 유출할 것이 없습니다.

일부 작업에는 무거운 기계장치(완전한 OCR, Office 변환, 암호화)가 필요합니다. 그런 페이지에는 «로컬 · MCP»로 표시되어 있으며, 패키지를 이용해 사용자의 컴퓨터에서 로컬로 작업을 실행하는 방법을 같은 개인정보로 설명합니다.

방법 2: 로컬 패키지 설치

패키지는 MCP 페이지의 설치 명령으로 한 번만 설치합니다. 이후에는 사용자의 컴퓨터에서 완전히 실행됩니다. 만들 계정도, 복사할 키도, 만료되는 것도 없습니다.

무거운 엔진(qpdf, OCR 언어 데이터)은 첫 사용 시 SHA-256 검증을 거쳐 한 번만 다운로드되어 다음 사용을 위해 컴퓨터에 남습니다.

방법 3: 로컬 MCP 서버를 AI 에이전트에 연결

MCP 서버는 에이전트와 같은 컴퓨터에서 로컬로(stdio) 실행됩니다. 대부분의 클라이언트는 클라이언트가 패키지를 시작하게 하는 이 구성 형식을 받아들입니다:

{"mcpServers": {"pdfmcp": {"command": "uvx", "args": ["--from", "https://pdfmcp.org/downloads/pdfmcp-4.2.1-py3-none-any.whl", "pdfmcp"]}}}

구성을 편집한 뒤 클라이언트를 재시작하세요. pdfmcp 도구가 목록에 나타납니다. 13개 클라이언트(Claude Desktop, Claude Code, ChatGPT, Cursor, VS Code, Windsurf, Codex, Gemini CLI, Zed, Cline, Continue, JetBrains, 그 외 모든 MCP 클라이언트)를 위한 단계별 가이드가 MCP 페이지에서 링크되어 있습니다. ChatGPT는 로컬 프로세스를 시작할 수 없으므로 ChatGPT 안에는 로컬 문이 없습니다. 대신 로컬 클라이언트 중 하나를 사용하세요.

첫 로컬 호출

사용자의 코드나 터미널에서는 흐름이 평소와 같지만 원격 서버는 없습니다. 패키지를 설치하고, 작업을 선택하고, 사용자의 컴퓨터에 있는 파일에 대해 실행하세요. 작업은 파일을 로컬로 읽고 결과를 로컬로 씁니다.

이 사이트의 작업 카탈로그(각 작업, 그 매개변수와 스키마)는 로컬 패키지도 설명합니다. 같은 카탈로그이기 때문입니다. 도구 페이지에서 보는 것이 에이전트와 코드가 호출할 수 있는 것입니다.

제한과 개인정보, 진지하게

유일한 제한은 사용자 기기의 것입니다. 메모리, 속도, 그리고 브라우저에서는 약 100MB, 500페이지까지의 파일입니다. 소진할 한도도, 기다릴 대기열도 없습니다.

개인정보는 구조적입니다. 모든 것이 로컬로 실행되므로 파일이 컴퓨터를 벗어나는 일도, 서버에 저장되는 일도, AI 학습에 사용되는 일도 없습니다. 이 사이트가 수집하는 유일한 것은 페이지 분석(조회와 집계된 Google Analytics)이며 문서를 건드리는 일은 없습니다.

AI 에이전트 연결 — 무료 로컬 MCP 서버

자주 묻는 질문

pdfmcp는 정말 무료인가요?

네, 영원히 무료입니다. 모든 도구는 로컬로 실행되며 계정도 워터마크도 없습니다. 유료 등급은 없습니다. 선택적 기부 상자(현재 비활성화)가 비즈니스 모델의 전부입니다.

계정이 필요한가요?

아니요. pdfmcp에는 계정이 없습니다. 웹 도구에도, 로컬 MCP 서버에도, 로컬 API에도 없습니다.

내 파일은 어디로 가나요?

어디로도 가지 않습니다. 처리는 사용자의 기기나 컴퓨터에서 일어나며, 파일이 업로드되는 일도 AI 학습에 사용되는 일도 없습니다.

내 에이전트는 로컬 MCP 서버를 어떻게 호출하나요?

사용자의 클라이언트가 가이드의 구성으로 pdfmcp 패키지를 로컬 프로세스(stdio)로 시작합니다. 원격 서버가 없으므로 구성할 비밀 헤더는 없습니다.

일일 제한이 있나요?

아니요. 일일 한도도, 시간당 페이스도, 카운터도 없습니다. 사용자의 기기가 유일한 실질적 제한입니다.

pdfmcp를 오프라인으로 사용할 수 있나요?

대부분 그렇습니다. 페이지와 그 라이브러리가 로드되면 웹 도구는 브라우저에서 작동하고, 로컬 패키지는 사용자의 컴퓨터에서 작동합니다. 연결이 필요한 것은 첫 사용 시의 엔진 다운로드뿐입니다.

원본 게시 위치: https://pdfmcp.org/guides/getting-started/