SSD Nodes Learn Hosting plans →
가이드 Matt Connor작성자 Matt Connor

클로드로 한글(HWP) 파일 다루기: 변환, 스킬, MCP 비교

클로드 업로드 목록에 HWP와 HWPX는 없습니다. PDF나 DOCX로 다시 저장할지, HWPX 스킬을 쓸지, .hwp를 직접 읽는 MCP 서버를 붙일지 고르는 기준과 설치 전 보안 점검을 정리했습니다.

클로드가 한글 파일을 읽을 수 있나요?

클로드에 .hwp나 .hwpx 파일을 그대로 올리는 방법은 공식 지원 목록에 없습니다. Claude 고객센터의 업로드 가능 파일 문서(2026년 11월 13일 확인)는 PDF, DOCX, CSV, TXT, HTML, ODT, RTF, EPUB, JSON, XLSX를 나열합니다. HWP와 HWPX는 이 목록에 없습니다.

그래서 한글 문서를 클로드와 함께 쓰려면 길을 골라야 합니다. 첫째, 한글에서 지원 형식으로 다시 저장해서 올릴 수 있습니다. 둘째, Claude Code나 Claude Desktop에 HWPX 스킬을 설치할 수 있습니다. 셋째, .hwp를 직접 읽는 MCP(Model Context Protocol) 서버를 붙일 수 있습니다.

어느 길이 맞는지는 클로드를 어디서 쓰는지, 그리고 문서가 얼마나 민감한지에 따라 정해집니다. 이 글에서 가장 길게 다루는 부분은 설치 전 점검입니다. 여기 나오는 스킬과 MCP 서버는 모두 개인 개발자가 만든 것이고, 한컴이 직접 배포하는 것은 찾지 못했기 때문입니다.

업로드 목록에 HWP가 없다는 것의 의미

고객센터 문서에는 몇 가지 한도도 적혀 있습니다. 채팅에 올리는 파일은 한 개당 500MB, 한 채팅에 최대 20개입니다. 프로젝트 파일은 한 개당 30MB입니다. 1,000쪽이 넘는 PDF는 받지 않습니다. XLSX는 계정에서 코드 실행과 파일 생성 기능을 켜야 올릴 수 있습니다.

이 문서는 HWP와 HWPX를 아예 언급하지 않습니다. 그래서 정확한 표현은 "지원하지 않는다"가 아니라 "목록에 없다"입니다. 목록에 없는 형식은 올려도 클로드가 내용을 제대로 읽는다는 보장이 없습니다. 중요한 문서라면 목록에 있는 형식으로 바꿔서 올리는 편이 안전합니다.

코드 실행 기능이 켜진 상태에서 .hwpx 파일을 올리면 클로드가 파이썬으로 ZIP을 풀어 읽을 수 있을지도 궁금할 것입니다. 제가 읽은 고객센터 문서에는 이 동작이 어디에도 적혀 있지 않습니다. 파일 생성 문서도 클로드가 만드는 형식으로 .xlsx, .pptx, .docx, PDF만 나열하고 HWPX는 언급하지 않습니다. 직접 확인하고 싶다면 개인정보가 없는 샘플 파일로 먼저 시험해 보세요.

HWPX는 쉽고 .hwp는 어려운 이유

두 형식의 차이를 알면 도구를 고르기가 쉬워집니다. 아래에 나오는 도구 대부분이 HWPX만 다루기 때문입니다.

HWPX는 ZIP 파일입니다. 그 안에 OWPML이라는 XML 문서들이 들어 있습니다. python-hwpx 라이브러리의 README는 이렇게 설명합니다. "HWPX는 ZIP 안에 XML(OWPML)을 담은 형식이라, 한컴오피스가 없어도 파이썬만으로 다룰 수 있습니다." 리눅스나 맥에서 직접 확인할 수 있습니다.

unzip -l 보고서.hwpx

목록에 mimetype 항목과 Contents/section으로 시작하는 XML 파일이 보이면 HWPX입니다. 본문 글자는 이 section XML 안에 들어 있습니다. 그래서 일반적인 ZIP 도구와 XML 라이브러리만으로 읽고 고칠 수 있습니다.

예전 형식인 .hwp(HWP 5.0)는 ZIP이 아닙니다. 같은 명령을 .hwp 파일에 실행하면 unzip은 ZIP 파일이 아니라는 오류를 냅니다. 이 형식을 읽으려면 전용 파서가 필요합니다. 그래서 .hwp를 읽는 도구는 적고, 쓰는 도구는 더 적습니다.

실용적인 결론은 하나입니다. 한글이 있다면 문서를 HWPX로 저장해 두세요. 그러면 아래의 거의 모든 도구를 쓸 수 있습니다. 한글이 없다면 python-hwpx가 HWP 5.0 파일을 열어 HWPX로 바꿔 줍니다. 옮겨지지 않은 내용은 document.conversion_report에 기록됩니다. 암호가 걸린 파일과 배포용 문서는 이 라이브러리가 지원하지 않습니다.

방법 1: PDF나 DOCX로 다시 저장해서 올리기

설치가 필요 없는 가장 단순한 방법입니다. claude.ai 웹이나 모바일 앱만 쓴다면 사실상 이 방법뿐입니다.

  1. 한글에서 문서를 엽니다.
  2. 다른 이름으로 저장하면서 형식을 PDF나 DOCX로 고릅니다.
  3. 저장한 파일을 클로드 채팅이나 프로젝트에 올립니다.

PDF는 화면에 보이는 모양을 유지하는 데 유리합니다. DOCX는 클로드가 고친 내용을 다시 편집 가능한 문서로 받기에 유리합니다. HWPX로 저장하는 것은 이 방법에 도움이 되지 않습니다. HWPX도 업로드 목록에 없기 때문입니다.

주의할 점은 변환 단계에 있습니다. 표의 셀 병합, 공문의 결재란, 머리글과 쪽 번호 같은 요소는 다른 형식으로 저장할 때 원본과 달라질 수 있습니다. 클로드는 원본이 아니라 변환된 파일을 봅니다. 그래서 클로드가 "표가 깨져 있다"고 말한다면 먼저 변환된 파일을 직접 열어 확인하세요. 문제가 변환에서 생긴 것인지, 클로드의 해석에서 생긴 것인지 구분할 수 있습니다.

결과물도 HWP가 아닙니다. 클로드가 만들어 주는 파일은 .docx나 PDF입니다. 최종 제출본이 한글 파일이어야 한다면 한글에서 다시 열어 서식을 정리해야 합니다.

방법 2: Claude Code나 Desktop에 HWPX 스킬 설치하기

스킬은 SKILL.md 파일 하나와 필요한 스크립트를 담은 폴더입니다. 클로드는 작업에 맞는 스킬을 골라 그 안의 지시와 스크립트를 씁니다. Claude Code 문서에 따르면 개인 스킬은 ~/.claude/skills/<스킬 이름>/SKILL.md에, 프로젝트 스킬은 .claude/skills/<스킬 이름>/SKILL.md에 둡니다. 스킬과 MCP가 각각 어떤 일을 맡는지 헷갈린다면 에이전트 스킬, MCP, 규칙 파일의 차이를 먼저 읽어 보세요.

Claude Desktop의 Claude Code 화면도 같은 폴더를 씁니다. 로컬 세션은 내 컴퓨터의 ~/.claude/skills/를 읽습니다. SSH 세션은 내 컴퓨터가 아니라 원격 서버의 홈 디렉터리에 있는 ~/.claude/skills/를 읽습니다.

canine89/hwpxskill: 템플릿으로 HWPX 문서 만들기

이 스킬은 OWPML XML을 직접 고쳐서 서식을 유지하는 방식입니다. 공문, 보고서, 회의록, 제안서, 기본 양식 같은 내장 템플릿으로 새 문서를 만들 수도 있습니다. HWPX만 다루고 .hwp는 언급하지 않습니다. README에 적힌 Claude Code용 설치 명령은 다음과 같습니다.

git clone https://github.com/Canine89/hwpxskill.git
cp -r hwpxskill ~/.claude/skills/hwpxskill
ls ~/.claude/skills/hwpxskill/SKILL.md

마지막 명령이 파일 경로를 그대로 출력하면 위치가 맞습니다. No such file or directory가 나오면 폴더를 다른 위치에 복사한 것이니 경로를 다시 확인하세요.

의존성은 Python 3.6 이상과 lxml입니다. README는 pip install lxml과 가상환경을 권합니다. Ubuntu 24.04의 시스템 파이썬에 그냥 pip install을 하면 externally-managed-environment 오류가 납니다. 배포판이 시스템 파이썬 패키지를 apt로만 관리하도록 막아 두었기 때문입니다. 서버라면 sudo apt install python3-lxml로 설치하는 편이 깔끔합니다.

11월 13일 기준 저장소 페이지에는 라이선스 표시가 없습니다. 회사 업무에 쓰기 전에 사용 조건을 확인하세요.

jkf87/hwpx-skill: 변환과 편집을 함께

MIT 라이선스 스킬입니다. HWPX 생성과 편집 외에 텍스트 추출과 HWP에서 HWPX로의 변환도 합니다. Windows에 한컴오피스가 있으면 한컴의 저장 엔진을 먼저 씁니다. 없으면 rhwp WASM 변환기로 넘어갑니다. 이 변환기는 @rhwp/core 0.7.10으로 고정되어 있고 Node.js 18 이상이 필요합니다.

README의 파이썬 설치 명령은 pip install python-hwpx lxml --break-system-packages입니다. 여기서 --break-system-packages는 바로 위에서 말한 배포판의 보호 장치를 끄는 옵션입니다. 서버에서는 이 옵션을 그대로 따르지 말고 가상환경을 만들어 설치하세요. README에는 Claude Code나 Desktop에 넣는 단계가 따로 없습니다. SKILL.md가 들어 있는 폴더를 위의 skills 경로 아래에 두면 됩니다.

python-hwpx와 그 주변 도구

airmang/python-hwpx는 Apache-2.0 라이선스의 파이썬 라이브러리입니다. Python 3.10 이상이 필요하고, 저장소는 개발 단계를 Beta로 표시합니다. PyPI의 현재 버전은 6.12.0입니다. 한컴오피스 없이 HWPX를 읽고, 고치고, 만들고, 검증합니다.

이 프로젝트는 여러 부분으로 나뉩니다. python-hwpx가 엔진입니다. python-hwpx-automation은 작성 워크플로와 hwpx 명령줄 도구, 선택형 MCP 서버를 제공합니다. hwpx-plugins는 플러그인과 스킬 묶음입니다. README가 Claude Code에 대해 안내하는 것은 python-hwpx-automation의 MCP 서버를 등록하라는 것뿐입니다. hwpx-plugins의 설치 안내는 Codex 기준이고 Claude용 경로는 적혀 있지 않습니다.

claude.ai 웹에서 스킬 쓰기

claude.ai에서도 스킬을 쓸 수 있습니다. 고객센터 문서에 따르면 Free, Pro, Max, Ultra, Team, Enterprise 플랜 모두에서 쓸 수 있고, 코드 실행 기능이 켜져 있어야 합니다. 직접 만든 스킬은 Customize > Skills에서 ZIP으로 올립니다. 같은 문서는 신뢰할 수 있는 출처의 스킬만 설치하라고 하고, 주요 위험으로 프롬프트 인젝션과 데이터 유출을 꼽습니다. 다만 웹 환경에서 HWPX 파일 자체를 받을 수 있는지는 위에서 말했듯 문서에 없으니 먼저 시험해 보세요.

방법 3: MCP 서버로 .hwp를 직접 읽기

MCP 서버는 클로드가 부를 수 있는 도구를 제공하는 별도 프로그램입니다. 스킬과 달리 독립된 프로세스로 실행되므로 .hwp 같은 바이너리 형식을 읽는 엔진을 안에 넣을 수 있습니다. 서버에서 MCP를 운영하는 일반적인 방법은 VPS에서 MCP 서버를 운영하는 방법에 정리해 두었습니다.

treesoop/hwp-mcp: 한글 없이 .hwp 읽기

한글이 설치되지 않은 환경에서 .hwp를 읽어야 한다면 가장 먼저 볼 서버입니다. README와 npm 정보를 정리하면 이렇습니다.

  • MIT 라이선스이고, 11월 13일 기준 별 107개입니다.
  • 읽기와 Markdown 변환은 .hwp와 .hwpx 모두 됩니다. 쓰기는 .hwpx만 됩니다.
  • 한컴오피스가 필요 없습니다. 읽기 엔진은 rhwp(@rhwp/core)이고 WebAssembly로 돌아갑니다.
  • macOS, Windows, Linux를 모두 지원합니다.
  • npm의 최신 버전은 0.3.0이고 2026년 7월 8일에 배포되었습니다. GitHub Releases 목록에는 v0.2.1까지만 있습니다.

README는 Node.js 20 이상을 요구합니다. 그런데 nodejs.org의 릴리스 페이지는 v20을 지원 종료(EOL, end of life)로 표시합니다. 같은 페이지에서 LTS(장기 지원) 버전은 v22, v24, v26입니다. 새로 설치한다면 v22 이상을 쓰세요.

README의 Claude Code 등록 명령은 claude mcp add hwp-mcp -- npx -y hwp-mcp입니다. 이 명령에는 버전이 없습니다. npm 문서에 따르면 버전 없는 npx는 로컬 프로젝트에 같은 패키지가 없으면 레지스트리에서 받아 옵니다. 버전을 붙이면 정확히 같은 이름과 버전만 일치로 봅니다. 그래서 버전 없이 등록하면 오늘 검토한 코드와 다음 달에 실행되는 코드가 다를 수 있습니다. 버전을 고정해서 등록하세요.

node --version
npm view hwp-mcp version
claude mcp add hwp-mcp -- npx -y hwp-mcp@0.3.0
claude mcp list

node --version은 v22 이상이어야 합니다. npm view는 지금 npm에 올라 있는 최신 버전을 보여 줍니다. 0.3.0보다 높게 나오면 변경 내용을 확인한 뒤 숫자를 바꾸세요. claude mcp list의 목록에 hwp-mcp가 보이면 등록된 것입니다. Claude Code의 claude mcp add 문법은 claude mcp add [options] <name> -- <command> [args...]입니다. -- 뒤의 내용은 손대지 않고 서버 실행 명령으로 넘어갑니다.

Claude Desktop의 설정 JSON(claude_desktop_config.json)에 넣는다면 README의 예시에서 인수만 바꾸면 됩니다.

{
  "mcpServers": {
    "hwp-mcp": {
      "command": "npx",
      "args": ["-y", "hwp-mcp@0.3.0"]
    }
  }
}

고객센터 문서에는 Claude Desktop이 Node.js를 내장하고 있어서 따로 설치할 필요가 없다고 적혀 있습니다. 하지만 이 설명은 .mcpb 파일로 설치하는 데스크톱 확장 기준입니다. JSON에 npx를 적는 방식에도 내장 Node가 쓰이는지는 문서에 없습니다. 이 방식을 쓴다면 시스템에 Node.js 22 이상을 설치해 두세요. 제가 확인한 범위에서 treesoop과 jkf87 모두 .mcpb 파일을 배포하지 않습니다.

쓰기 방식도 알아 둘 필요가 있습니다. README에 따르면 .hwpx를 저장할 때 ZIP 안의 Contents/section*.xml을 직접 파싱하고, <hp:t> 텍스트 노드를 찾아 바꾼 뒤 다시 묶습니다. 이때 mimetype 항목은 규격대로 압축하지 않고 저장합니다. .hwpx로 연 파일은 .hwpx로만 저장되고, .hwp 쓰기는 지원하지 않습니다. 텍스트 노드 단위로 바꾸는 방식이라 복잡한 서식에서 결과가 어떻게 될지는 문서마다 다릅니다. 반드시 사본으로 작업하세요.

cp 원본.hwpx 작업본.hwpx

jkf87/hwp-mcp: Windows와 한글로 문서 조작

MIT 라이선스이고 11월 13일 기준 별 270개입니다. Python 3.10 이상이 필요합니다. 이 서버는 설치된 한글 프로그램을 조종하는 방식입니다. 그래서 대부분의 기능에 Windows와 한글이 필요합니다.

macOS나 Linux, 또는 한글이 없는 Windows에서도 서버는 실행됩니다. 이때 쓸 수 있는 도구는 hwp_read_file 하나입니다. 이 도구는 어느 OS에서나 본문 텍스트를 돌려주고, 표는 Markdown 표로 바꿔 줍니다. README의 설치는 저장소를 받아 의존성을 설치하는 방식입니다.

git clone https://github.com/jkf87/hwp-mcp.git
cd hwp-mcp
pip install -r requirements.txt

README의 Claude Desktop 예시는 python으로 저장소 안의 hwp_mcp_stdio_server.py를 실행합니다. 이 저장소에는 설치 전에 꼭 봐야 할 파일이 하나 있습니다. 아래 점검 목록에서 다룹니다.

Dayoooun/hwpx-mcp: HWPX 편집용 포크

mjyoo2/hwp-extension의 포크라고 스스로 밝히는 MIT 라이선스 서버입니다. HWPX만 읽고 쓰며, .hwp는 HWPX로 먼저 바꾸라고 안내합니다. 11월 13일 기준 별 35개입니다. 설치는 직접 빌드하는 방식입니다.

git clone https://github.com/Dayoooun/hwpx-mcp.git
cd hwpx-mcp/mcp-server
npm install
npm run build

빌드가 끝나면 dist/index.js를 node 명령으로 등록합니다. Linux에서는 서버 실행과 HWPX 편집이 되지만 PDF 내보내기는 안 됩니다. PDF 내보내기에는 Windows의 한컴오피스나 macOS의 한/글 for Mac이 필요합니다.

설치 전에 확인할 것

한글 문서에는 공문, 계약서, 개인정보가 담긴 신청서가 많습니다. 그런 문서를 남이 만든 코드에 넘기기 전에 아래를 확인하세요. Claude Code의 MCP 문서도 연결하기 전에 각 서버를 신뢰할 수 있는지 확인하라고 적고 있습니다.

  • 누가 만들었는지 봅니다. 위의 도구는 모두 개인 개발자의 프로젝트입니다. 11월 13일에 한컴의 GitHub 조직(hancom-io)과 웹 검색에서 한컴 공식 MCP 서버는 찾지 못했습니다. hancom-io의 저장소 5개 중 HWPX나 OWPML 관련은 hwpx-owpml-model, dvc, metatag-ex이고, 어느 것도 MCP나 AI 에이전트를 언급하지 않습니다. 한컴의 제품 사이트까지 뒤진 것은 아니니 "없다"가 아니라 "찾지 못했다"로 읽어 주세요.
  • 버전을 고정합니다. npx -y hwp-mcp처럼 버전 없이 등록하면 실행할 때마다 그 시점의 버전이 들어올 수 있습니다. 검토한 버전을 @0.3.0처럼 명시하세요.
  • 동봉된 바이너리를 확인합니다. jkf87/hwp-mcp는 security_module/ 폴더에 미리 빌드된 FilePathCheckerModuleExample.dll을 넣어 두었습니다. README는 이 모듈을 한글의 경고를 우회하는 데 쓴다고 설명합니다. 모듈 등록에 실패해도 기능은 작동하고, 파일을 열거나 저장할 때 보안 대화 상자가 나타날 수 있다고 적혀 있습니다. 내용을 직접 확인하지 않은 DLL을 실행하는 일이므로, 회사 PC라면 보안 담당자와 먼저 검토하세요.
  • 파일 경로 범위를 봅니다. Dayoooun/hwpx-mcp의 README는 파일 경로가 작업 폴더로 제한되지 않는다고 직접 밝힙니다. 절대 경로, 상위 디렉터리 경로, 심볼릭 링크로 작업 폴더 밖의 파일에 닿을 수 있다는 뜻입니다. README는 신뢰하는 로컬 클라이언트에서만 쓰고, OS 권한이나 컨테이너로 범위를 좁히라고 권합니다.
  • 원본은 건드리지 않습니다. treesoop처럼 ZIP을 직접 고치는 도구는 사본으로 시험하세요. 결과를 한글에서 열어 확인한 뒤에 원본을 바꿉니다.
  • 외부로 나가는 요청을 찾습니다. 예를 들어 jacob-g-park/polaris-datainsight-doc-extract 스킬은 HWP, HWPX, DOCX, PPTX, XLSX에서 구조화된 데이터를 뽑습니다. 그 SKILL.md를 보면 파일을 datainsight-api.polarisoffice.com으로 multipart/form-data POST 요청으로 보내고, POLARIS_DATAINSIGHT_API_KEY 환경 변수가 필요합니다. 즉 문서 원본이 내 컴퓨터를 떠나 Polaris Office의 서버로 갑니다. 이 스킬은 Polaris Office나 Anthropic의 공식 목록이 아니라 개인이 올린 것입니다. Polaris 서버에서의 보관 기간에 대한 설명은 찾지 못했습니다. 공문이나 개인정보가 든 문서라면 Polaris의 약관을 먼저 확인하세요.
  • 스킬의 권한을 읽습니다. Claude Code 문서는 스킬이 스스로 넓은 도구 권한을 가질 수 있다고 경고합니다. 저장소에 포함된 스킬은 allowed-tools 항목을 읽어 본 뒤 Claude Code를 실행하세요.
  • 프로젝트 설정 파일을 조심합니다. .mcp.json으로 공유되는 프로젝트 범위 서버는 대화형 세션에서는 사용 전에 승인을 묻습니다. 하지만 claude -p 실행과 Agent SDK 세션에서는 묻지 않고 불러옵니다. 남의 저장소를 받아 자동 실행하는 스크립트라면 .mcp.json부터 확인하세요.

로컬에서 도는 MCP 서버라고 해서 문서 내용이 기기 밖으로 나가지 않는 것은 아닙니다. 서버가 읽은 내용은 대화에 들어가 클로드 모델로 전달됩니다. 로컬 도구와 외부 API 스킬의 차이는 그 밖에 제3자 서버로 원본 파일이 한 번 더 가느냐입니다.

리눅스 VPS의 Claude Code에서 HWP 다루기

국내 안내 글은 대부분 Windows와 한글이 설치된 PC를 전제로 합니다. 하지만 한글이 없는 리눅스 서버에서도 쓸 수 있는 조합이 있습니다. treesoop/hwp-mcp로 .hwp를 읽고, HWPX 스킬이나 python-hwpx로 HWPX를 만들고 고치는 조합입니다. jkf87/hwp-mcp는 서버에서 hwp_read_file만 쓸 수 있습니다.

Claude Code 설치 문서의 요구 사항은 Ubuntu 20.04 이상, Debian 10 이상 또는 Alpine Linux 3.19 이상입니다. 메모리는 4GB 이상, 프로세서는 x64나 ARM64가 필요합니다. 작은 VPS 플랜에서는 메모리부터 확인하세요. 계정은 Pro, Max, Ultra, Team, Enterprise 또는 Console 계정이어야 합니다. 무료 claude.ai 플랜에는 Claude Code가 포함되지 않습니다. 플랜 비교는 어떤 Claude 플랜이 필요한지 고르는 법에 있습니다.

free -h
curl -fsSL https://claude.ai/install.sh | bash
claude --version

free -h의 total 값이 4GB보다 작으면 설치 전에 더 큰 플랜으로 옮기는 편이 낫습니다. claude --version이 버전 번호를 출력하면 설치된 것입니다. 로그인은 브라우저 로그인이나 ANTHROPIC_API_KEY로 합니다. 화면이 없는 서버에서 이 부분이 걸린다면 리눅스에서 Claude Code와 데스크톱 앱을 쓰는 방법을 참고하세요.

서버에서는 MCP 서버를 사용자 범위로 등록해 두면 어느 디렉터리에서 Claude Code를 열어도 쓸 수 있습니다. 사용자 범위 설정은 ~/.claude.json에 저장됩니다.

claude mcp add --scope user hwp-mcp -- npx -y hwp-mcp@0.3.0
mkdir -p ~/hwp-work

내 PC에서 서버로 파일을 옮길 때는 scp를 씁니다.

scp 보고서.hwp ubuntu@203.0.113.10:~/hwp-work/

그다음 서버의 ~/hwp-work에서 Claude Code를 열고 "보고서.hwp를 읽어서 표를 요약해 줘"처럼 요청합니다. 결과를 HWPX로 만들게 했다면 같은 방법으로 내 PC에 내려받아 한글에서 확인하세요. Claude Desktop의 SSH 세션으로 이 서버에 붙으면 스킬도 서버의 ~/.claude/skills/에서 읽습니다. 그러니 스킬은 서버 쪽에 설치해야 합니다.

어떤 방법을 고를까

  • claude.ai 웹이나 앱만 쓴다면 PDF나 DOCX로 저장해서 올립니다. 표와 공문 양식은 변환 후에 꼭 비교합니다.
  • 한글이 있고 결과물이 한글 파일이어야 한다면 HWPX로 저장하고 HWPX 스킬을 씁니다.
  • 한글 없이 .hwp를 읽어야 한다면 treesoop/hwp-mcp를 버전 고정해서 씁니다. 쓰기 결과는 .hwpx입니다.
  • Windows에서 한글 프로그램 자체를 자동으로 조작하고 싶다면 jkf87/hwp-mcp를 보되, 동봉된 DLL부터 검토합니다.

FAQ

클로드에 .hwp 파일을 그냥 올리면 안 되나요?

Claude 고객센터의 업로드 가능 파일 목록(2026년 11월 13일 확인)에는 HWP와 HWPX가 없습니다. 목록에 있는 문서 형식은 PDF, DOCX, CSV, TXT, HTML, ODT, RTF, EPUB, JSON, XLSX입니다. 확실하게 읽히게 하려면 한글에서 PDF나 DOCX로 다시 저장해서 올리세요. 표와 공문 양식은 변환 과정에서 달라질 수 있으니 결과를 원본과 비교하세요.

HWP와 HWPX 중 무엇으로 저장해야 하나요?

스킬이나 MCP 같은 도구를 쓸 생각이라면 HWPX입니다. HWPX는 ZIP 안에 OWPML XML을 담은 형식이라 한컴오피스 없이도 파이썬이나 일반 ZIP 도구로 읽고 고칠 수 있습니다. 예전 .hwp는 ZIP이 아니어서 전용 파서가 필요하고, 그래서 지원하는 도구가 훨씬 적습니다. 다만 claude.ai에 직접 올릴 파일이라면 HWPX도 업로드 목록에 없으니 PDF나 DOCX를 고르세요.

한글이 없는 맥이나 리눅스에서도 .hwp를 읽을 수 있나요?

읽을 수 있습니다. treesoop/hwp-mcp는 WebAssembly 엔진으로 .hwp와 .hwpx를 읽고, macOS, Windows, Linux를 지원하며 한컴오피스가 필요 없습니다. 쓰기는 .hwpx만 됩니다. jkf87/hwp-mcp도 한글 없는 환경에서 hwp_read_file 도구로 본문과 표를 읽을 수 있습니다. 한글이 없으면 그 밖의 기능은 쓸 수 없습니다.

이런 MCP 서버나 스킬을 회사 문서에 써도 안전한가요?

모두 개인 개발자의 프로젝트이고, 2026년 11월 13일 검색에서 한컴 공식 MCP 서버는 찾지 못했습니다. 쓰기 전에 버전을 고정하고(npx -y hwp-mcp@0.3.0처럼), 동봉된 바이너리와 외부 API 호출 여부를 확인하세요. 예를 들어 jkf87/hwp-mcp에는 README가 한글의 보안 경고를 우회하는 데 쓴다고 설명하는 미리 빌드된 DLL이 들어 있습니다. Polaris DataInsight 추출 스킬은 파일을 Polaris Office 서버로 보냅니다. 편집은 항상 사본으로 시험하세요.

claude.ai의 코드 실행 기능으로 .hwpx를 열 수 있나요?

고객센터 문서에는 이에 대한 설명이 없습니다. 업로드 목록에도 HWPX가 없고, 파일 생성 문서도 HWPX를 언급하지 않습니다. 확인하고 싶다면 개인정보가 없는 샘플 .hwpx로 직접 시험해 보세요. 업무 문서는 결과를 확인하기 전까지 PDF나 DOCX로 바꿔 올리는 편이 안전합니다.

이 글이 도움이 되었나요?

#claude#mcp#agent-skills#hwp#korea#claude-desktop