📜 HWP·PDF 복붙 없이 AI한테 넘기는 확장 도구 3가지 (설치법)

한글 파일 열어서 본문 긁어 붙이고 계셨죠. AI가 문서를 못 여는 게 아니라, 열 도구를 안 붙여준 거예요. 읽는 도구 하나, 내보내는 도구 하나, 참조하는 도구 하나입니다.

아래 명령어를 복사해서 붙여넣으면 돼요.

⚠️ 공통 주의: 도구 모두 터미널(CLI) 에서 설치해요. 데스크탑 앱(Claude Desktop)의 Code 탭에서는 /plugin·mcp add 명령어가 막혀 있어서("isn't available in this environment"), 최초 설치는 터미널에서 해야 합니다.

---

① kordoc CLI (무료) — 한글(HWP) 파일을 그대로 넘겨요

출처: https://github.com/chrisryugj/kordoc

한글 파일을 열어서 본문을 긁어 붙이던 일을 없애요.
HWPX·HWP 5.x·HWP 3.x·PDF·XLSX·DOCX는 물론 스캔 이미지(OCR)까지 마크다운으로 바꿔서 AI에 넘깁니다. 표가 병합돼 있거나 PDF에 표 선이 없어도 구조를 복원해줘요. 한국 문서 전용으로 만들어진 국내 오픈소스(MIT, 1.6k★)입니다.

설치 (한 줄 · 자동 등록)

npx -y kordoc setup

설치 마법사가 깔려 있는 AI 클라이언트를 찾아서 설정 파일까지 알아서 고쳐줘요 — Claude Code, Claude Desktop, Cursor, Windsurf, VS Code, Gemini CLI, Zed, Codex 지원. 윈도우는 cmd /c npx 로 자동 감싸줍니다.

설치 없이 변환만 해보고 싶으면:

npx kordoc 보고서.hwp -o 보고서.md

이렇게 쓰면 돼요

• "이 사업계획서 hwp 읽고 요약해줘"
• "신청서 양식에 이 내용으로 채워줘" — fill 로 양식 필드를 채워요
• "이전 버전이랑 뭐가 바뀌었는지 비교해줘" — compare 로 신구대조표가 나와요
• 마크다운으로 쓴 걸 다시 HWPX로: npx kordoc generate 보고서.md -o out.hwpx

💡 MCP 도구가 15개 붙어요 — 파싱·생성·양식채우기·부분수정·비교·도장(place_seal)·개인정보 가리기(redact_document)까지. 관공서·지원사업 서류 다루는 분이면 체감이 제일 큽니다.

⚠️ 정직한 한계: Node 18 이상 필요. HWP 3.x는 텍스트 추출만 되고 구조 편집은 HWPX여야 해요. HWP 5.x 부분수정은 표의 행 추가·삭제를 지원하지 않고(새로 만들 땐 generate 사용), 문단 삽입·삭제 같은 블록 단위 편집도 안 됩니다. DRM 걸린 문서는 Windows + 한컴오피스가 설치돼 있어야 대체 추출이 돌아가요. 윈도우 PowerShell에서 실행 정책에 막히면 cmd.exe로 하세요.

---

② document-skills PLUGIN (무료 · Anthropic 공식) — 결과를 문서 파일로 받아요

출처: https://github.com/anthropics/skills

"정리해줘" 하면 채팅창에만 뜨고, 결국 내가 워드에 옮겨 적던 일을 없애요.
워드(DOCX)·엑셀(XLSX)·파워포인트(PPTX)·PDF를 직접 만들고 고칩니다. 변경내용 추적과 주석, 엑셀 수식과 차트, 슬라이드 레이아웃까지 다뤄요. 앤트로픽이 실제 프로덕션에서 쓰는 걸 공개한 거라 완성도가 높습니다.

설치 (두 줄)

/plugin marketplace add anthropics/skills

/plugin install document-skills@anthropic-agent-skills

이렇게 쓰면 돼요

• "이 내용으로 워드 보고서 만들어줘"
• "표 정리해서 수식까지 엑셀로 뽑아줘"
• "이 초안으로 발표 덱 10장 만들어줘"
• "이 문서에 변경내용 추적으로 수정 제안 달아줘"

💡 example-skills@anthropic-agent-skills 도 같이 있어요. 문서 말고 다른 공식 스킬을 구경하고 싶으면 그쪽도 깔아보세요.

⚠️ 라이선스 주의: 레포 전체가 오픈소스는 아니에요. 다른 스킬은 Apache 2.0이지만 문서 스킬(docx·pdf·pptx·xlsx)은 "source-available, not open source" 로 명시돼 있습니다. 쓰는 건 무료지만 가져다 재배포·상업적 변형은 라이선스를 확인하세요. 레포에 "데모·교육 목적" 디스클레이머도 붙어 있어요.

---

③ Context7 MCP (무료 티어) — 최신 공식 문서를 보고 코드를 짜요

출처: https://github.com/upstash/context7

AI가 1년 전 기억으로 없는 함수를 지어내던 일을 줄여요.
라이브러리 이름을 말하면 그 라이브러리의 현재 버전 공식 문서를 실시간으로 가져와서 그걸 보고 코드를 씁니다. Upstash가 만든 MIT 오픈소스(59.7k★)예요.

설치 (한 줄)

npx ctx7 setup --claude

로그인·API 키 발급·스킬 설치까지 한 번에 끝나요. 설치할 때 CLI 모드와 MCP 모드 중에 고를 수 있습니다.

플러그인으로 깔고 싶으면:

/plugin marketplace add upstash/context7
/plugin install context7@context7-marketplace

이렇게 쓰면 돼요

• "use context7 — Next.js 15에서 미들웨어 설정하는 법 알려줘"
• "/context7:docs shadcn 버튼 variant"
• 라이브러리 지정: "use context7 with /vercel/next.js for app router setup"
• 설치하고 나면 라이브러리 얘기를 꺼낼 때 자동으로 붙기도 해요

💡 API 키는 선택이에요. 없어도 익명으로 동작하고, 키를 넣으면 한도가 올라갑니다.

⚠️ 정직한 숫자: 2026년 1월에 무료 티어가 크게 줄었어요. 월 6,000회 수준이던 게 500회로 잘렸다가 현재 월 1,000회로 조정됐고, 시간당 60회 제한이 있습니다. 가볍게 쓰기엔 충분하지만 "무제한 무료"는 아니에요. 그리고 레포가 직접 밝히듯 문서는 커뮤니티가 기여하는 거라 정확성·완전성을 보장하지 않습니다. Node 18 이상 필요.

---

세 도구를 한 줄로 정리하면 이래요.

도구	분류	비용	무엇을 하나
kordoc	CLI	무료	내 문서를 읽어서 넘김 (HWP·PDF·오피스)
document-skills	PLUGIN	무료	결과를 문서로 내보냄 (워드·엑셀·PPT)
Context7	MCP	무료 티어	최신 공식 문서를 참조함

부담되면 ① kordoc부터 하세요. npx -y kordoc setup 한 줄이면 끝나고, 한글 파일 쓰는 분이면 효과가 제일 큽니다.
파일을 못 다루는 게 아니라, 다룰 손을 안 붙여준 거예요. 필요하면 찾는 게 아니라,
있는 줄 알아야 찾을 수 있는 것들이라 정리해봤어요.
설치하다 막히면 인스타 DM으로 편하게 물어보세요 👀

@oliveves.ai