Claude Code + pdfmcp: 설정 가이드

하나의 명령으로, 또는 .mcp.json을 통해 pdfmcp를 Claude Code에 추가합니다.

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

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

들어가는 위치: Wherever your client keeps its MCP server list

claude mcp add pdfmcp -- uvx --from https://pdfmcp.org/downloads/pdfmcp-4.2.1-py3-none-any.whl pdfmcp

단계

1. Run the command above (or add the JSON below to .mcp.json in your project root).
2. Restart Claude Code and run /mcp to confirm pdfmcp is connected.
3. Try: “Use pdfmcp to merge these two PDFs” — it runs on this machine.

Project-scoped .mcp.json alternative (same local server, no key):

구성

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

문제 해결

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

다음으로 시도해 보세요

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