Claude Desktop + pdfmcp: 설정 가이드

Claude Desktop에 pdfmcp를 로컬 MCP 서버로 추가하세요.

로컬만 해당됩니다. 같은 74개 도구가 사용자의 컴퓨터에서 실행됩니다. 계정 없음, 키 없음, 제한 없음. Claude Desktop에서는 이 페이지의 구성으로 pdfmcp가 사용자의 컴퓨터에서 실행됩니다. 구성을 바꾸면 언제든 다시 설치하거나 클라이언트를 변경할 수 있습니다.

필요한 것: 로컬 pdfmcp 패키지: 한 번 설치하세요(또는 첫 시작 시 uvx가 다운로드하게 하세요). 계정도, 키도, 교체할 비밀도 없습니다.

들어가는 위치: claude_desktop_config.json (Claude Desktop → Settings → Developer → Edit Config)

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

단계

1. Merge the config below into claude_desktop_config.json (create the file if it doesn't exist).
2. Fully restart Claude Desktop.
3. Drop in a PDF and ask Claude to extract the text — it happens on this machine.

Local servers live in the config file — the Settings → Connectors UI is for remote servers and can't start local processes.

uvx downloads the pdfmcp package on first launch and keeps it cached. No key is involved: the tools run on this machine.

문제 해결

• 로컬 서버가 시작되지 않음: 패키지를 pip install https://pdfmcp.org/downloads/pdfmcp-4.2.1-py3-none-any.whl(으)로 한 번 설치하고 터미널에서 pdfmcp를 실행해 오류를 확인하세요 — 보통 패키지 다운로드가 차단되었거나 Python이 3.11보다 오래된 경우입니다.
• 도구가 나타나지 않습니다: 구성을 편집한 뒤 클라이언트를 완전히 재시작하세요. 대부분의 클라이언트는 시작할 때만 MCP 서버를 불러옵니다.
• 엔진이 시작되지 않습니다: 무거운 엔진은 첫 사용 시 한 번만 다운로드됩니다. 그 다운로드를 위한 연결을 확인하고 다시 시도하세요. 이후에는 모든 것이 로컬로 작동합니다.

다음으로 시도해 보세요

다른 클라이언트: Claude Code MCP 설정 · ChatGPT MCP 설정 · Cursor MCP 설정 · 모든 MCP 설정 가이드 · 로컬 API 가이드