코리아 에이전트 맵Korea Agent Map

AI 에이전트로 한글(HWP) 문서를 읽고 작성할 수 있을까?Can an AI agent read and write Korean HWP documents?

지금 가능Works today

kordoc, hwp-mcp 같은 오픈소스 MCP를 연결하면 Claude·Codex가 한컴오피스 없이 .hwp·.hwpx를 읽고, .hwpx 문서를 새로 만들거나 양식을 채웁니다. 다만 .hwp(바이너리) 파일을 직접 고쳐 저장하는 기능은 아직 도구마다 제한이 있어 .hwpx로 다루는 편이 안전합니다.

Open-source MCP servers such as kordoc and hwp-mcp let Claude or Codex read .hwp/.hwpx files and create or fill .hwpx documents without Hancom Office. Editing and saving legacy binary .hwp is still limited in most tools, so working in .hwpx is safer.

연결하는 방법How to connect an agent

  1. 제3자 도구(비공식)Third-party tool (unofficial)

    kordoc (읽기·변환·양식 채우기)kordoc (read, convert, fill forms)

    npx -y kordoc setup을 실행하면 Claude Desktop·Claude Code·Cursor·Codex에 MCP가 등록되어 HWP·HWPX·PDF를 마크다운으로 읽고, 문서를 비교하고, 양식을 채우고, 마크다운으로 HWPX 공문서를 만듭니다. 현직 지방공무원이 만든 도구로 소개합니다.Run npx -y kordoc setup to register the MCP in Claude Desktop, Claude Code, Cursor or Codex; it reads HWP/HWPX/PDF as markdown, diffs documents, fills forms and generates HWPX official documents from markdown. Built by a local civil servant.

    필요한 것You need Node.js 20+한컴오피스 불필요No Hancom Office needed

    chrisryugj/kordoc ↗
  2. 제3자 도구(비공식)Third-party tool (unofficial)

    hwp-mcp (rhwp 기반 읽기·쓰기)hwp-mcp (read/write, built on rhwp)

    claude mcp add hwp-mcp -- npx -y hwp-mcp로 연결하면 .hwp·.hwpx 읽기, 페이지 렌더링, .hwpx 텍스트 치환·템플릿 채우기·표 편집·새 문서 만들기를 맥·윈도우·리눅스에서 할 수 있습니다. .hwp 파일 쓰기는 지원하지 않습니다.Connect with claude mcp add hwp-mcp -- npx -y hwp-mcp to read .hwp/.hwpx, render pages, and replace text, fill templates, edit tables or create new .hwpx files on macOS, Windows or Linux. Writing .hwp is not supported.

    필요한 것You need Node.js 20+

    treesoop/hwp-mcp ↗
  3. 제3자 도구(비공식)Third-party tool (unofficial)

    claw-hwp (Claude·Codex 플러그인)claw-hwp (Claude/Codex plugin)

    claude plugin marketplace add https://github.com/DoHyun468/claw-hwp 후 claude plugin install claw-hwp@claw-hwp로 설치하면 대화로 문서 서식·표·차트를 편집합니다. Codex도 같은 저장소로 설치하며, 결과 파일이 한컴오피스에서 깨지지 않게 저장한다고 소개합니다.Install with claude plugin marketplace add https://github.com/DoHyun468/claw-hwp then claude plugin install claw-hwp@claw-hwp to edit formatting, tables and charts by chat; Codex installs from the same repo. It says output opens cleanly in Hancom Office.

    필요한 것You need Claude Code 또는 CodexClaude Code or Codex

    DoHyun468/claw-hwp ↗
  4. 공식 APIOfficial API

    한컴 한글 SDK(기업용)Hancom Hwp SDK (commercial)

    한컴이 판매하는 개발 라이브러리로, 한글 프로그램 없이 HWP·HWPX 생성·변환·편집·비교 기능을 자사 시스템에 넣을 수 있습니다. 개인용 MCP가 아니라 기업이 구매해 탑재하는 제품입니다.Hancom's commercial library for creating, converting, editing and comparing HWP/HWPX inside your own system without the Hwp app. It is a product companies buy and embed, not a personal MCP.

    필요한 것You need SDK 구매(기업)SDK purchase (business)

    한컴 한글 SDK ↗

주의할 점Before you start

  • 한컴이 직접 만든 MCP 서버는 확인되지 않았습니다. 위 MCP는 모두 개인 개발자의 비공식 도구입니다.No Hancom-built MCP server was found; all MCPs above are unofficial community tools.
  • 공문서·계약서는 AI가 고친 뒤 한컴오피스에서 직접 열어 서식과 내용을 확인하세요.For official documents or contracts, open the AI-edited file in Hancom Office and check layout and content yourself.
  • 개인정보나 내부 문서가 담긴 파일은 외부 AI로 보내기 전에 범위를 줄이고, 폐쇄망이면 kordoc의 오프라인 모드(`KORDOC_OFFLINE=1`)를 검토하세요.Trim personal or internal data before sending files to an external AI; for air-gapped networks consider kordoc's offline mode (`KORDOC_OFFLINE=1`).
  • 행정안전부가 2026년 5월부터 공공기관 전자문서에 개방형 형식(HWPX) 사용을 의무화해, 앞으로는 HWPX 문서가 더 많아질 것으로 보입니다.Since May 2026 the Ministry of the Interior requires open-format (HWPX) public documents, so HWPX will become more common.

참고한 출처Sources

공개 자료를 바탕으로 2026.10.12에 정리했습니다. 모든 방법을 직접 실행해 검증한 결과는 아니며, 도구 소개가 공식 지원이나 안전을 보장하지 않습니다. 이용 약관과 최신 문서를 함께 확인해 주세요.Compiled from public sources on 2026.10.12. Not every path was executed by us; listing a tool does not guarantee official support or safety. Check the terms and current docs. 정정 제보Suggest a correction

실제 사례Reported cases

업무·운영Work & ops·연동 도구·스킬Tools & skills·출처 날짜Source date

HWP·HWPX·PDF를 마크다운으로 바꾸는 kordoc을 공개했다Released kordoc, an HWP/HWPX/PDF to Markdown CLI and MCP

류주임이 한글·PDF·오피스 문서를 마크다운으로 바꾸고 양식 채우기와 신구대조를 지원하는 CLI·MCP를 공개했다. 2026-03 생성, 별 약 2,400개.The same Gwangjin-gu developer released kordoc, converting HWP/HWPX/PDF/Office files to Markdown with form filling and diffing via CLI and MCP (created 2026-03, ~2,400 stars).

대안·대응Alternatives noted · LLM이 직접 못 읽는 HWP를 파서로 변환해 우회했다.
Claude CodeClaudeHWPHWPX
chrisryugj · GitHub ↗
업무·운영Work & ops·연동 도구·스킬Tools & skills·출처 날짜Source date

HWP/HWPX를 읽고 쓰는 MCP를 맥에서도 돌게 만들었다Made an HWP/HWPX read-write MCP that runs on macOS without Hancom

treesoop은 rhwp(WASM) 위에 hwp-mcp를 얹어 한컴오피스 없이 HWP 읽기와 HWPX 템플릿 채우기·표 수정을 지원한다. 기존 도구 대부분이 윈도우 COM에 묶인 점을 우회했다.treesoop built hwp-mcp on the rhwp WASM engine to read HWP and fill/edit HWPX without Hancom Office, avoiding the Windows-only COM approach (repo created 2026-03).

대안·대응Alternatives noted · HWP 쓰기가 막혀 있어 HWPX는 ZIP 단위 수정 계층으로 우회했고, .hwp 쓰기는 아직 미지원이다.
Claude CodeCursorChatGPTHWP한컴오피스
treesoop · GitHub ↗
업무·운영Work & ops·연동 도구·스킬Tools & skills·출처 날짜Source date

HWPX 양식 채우기·공문서 검수 플러그인을 만들었다Automated HWPX form filling and official-document checks via a Claude Code plugin

6aneffy의 hwpx-kit은 양식 채우기·메일머지·표 생성·공문서 검수를 Claude Code 플러그인과 CLI로 제공한다. 2026-07 생성.6aneffy's hwpx-kit offers form filling, mail merge, table generation and official-document checks as a Claude Code plugin and CLI (created 2026-07).

대안·대응Alternatives noted · 한글 문서 포맷을 직접 다루는 도구로 우회했다.
Claude CodeHWPHWPX공문서
6aneffy · GitHub ↗
업무·운영Work & ops·연동 도구·스킬Tools & skills·출처 날짜Source date

에이전트가 HWPX를 깨뜨리지 않고 편집하도록 스킬을 만들었다Wrote an agent skill so LLMs can edit HWPX files without corrupting them

kangdacool은 Claude Code·Codex가 hwpx를 안전하게 편집하도록 검증된 규칙과 파이썬 도구를 담은 스킬을 공개했다. 2026-07 생성.kangdacool published a skill with verified rules and Python tools so Claude Code and Codex can edit .hwpx safely (created 2026-07).

대안·대응Alternatives noted · hwpx 구조 규칙을 스킬로 알려줘 파일 손상을 피했다.
Claude CodeCodexHWPHWPX
kangdacool · GitHub ↗
공공·법률Public & legal·연동 도구·스킬Tools & skills·출처 날짜Source date

공문닥터 MCP로 한글 공문서 자동 교정Released an MCP that proofreads Korean official HWP/HWPX documents

Claude, Codex 등 에이전트와 연결해 .hwpx/.hwp 공문서의 맞춤법·띄어쓰기·조사 병기를 자동 교정하는 MCP를 무료로 공개했다.Published a free MCP letting agents like Claude and Codex auto-correct spelling, spacing and particles in Korean official .hwpx/.hwp documents.

대안·대응Alternatives noted · HWP/HWPX 공문서 형식을 MCP로 직접 다뤄 우회했다.
ClaudeCodexHWP
@v81093933 · X ↗
공공·법률Public & legal·발표·출시Announcements·출처 날짜Source date

행안부가 공공문서 hwpx 개방형 형식 의무화 추진MOIS moved to mandate open hwpx format for public documents

행정안전부가 공공기관 전자문서에 개방형 형식 준수를 담은 대통령령 개정안을 2026-05-12 국무회의에서 의결했다고 보도됐다.Reported: MOIS's decree amendment requiring open document formats (e.g. hwpx) for public-sector documents passed the Cabinet on 12 May 2026.

대안·대응Alternatives noted · AI가 읽기 어려운 HWP 한계를 제도로 해소하려는 시도.
HWP
행정안전부 · 한국미디어일보 ↗
공공·법률Public & legal·기업·기관Organizations·출처 날짜Source date

서울시, MCP 기반 행정지원 AI 에이전트 구축 착수Seoul city starts MCP-based admin AI agents (HWP summary, room booking)

서울시가 약 18억원 규모로 MCP 기반 에이전트 환경을 구축해 업무관리·회의실·메일 시스템과 연동한다. 시범 3종은 HWP/HWPX/PDF 문서 요약, 자연어 회의실 예약, 제안평가위원 문자 섭외 자동화다.Seoul ordered a ~KRW 1.8B MCP-based agent layer linked to its work-management, room-booking and mail systems; pilots summarise HWP/HWPX/PDF documents, book rooms by natural language, and auto-text evaluation-committee candidates.

대안·대응Alternatives noted · 행정문서가 HWP·HWPX 형식이라 문서 요약 에이전트가 이를 직접 분석하고 내부망 자체 LLM에서 구동한다.
서울시 자체 LLMHWP서울시 업무관리시스템
서울시 · 전자신문 ↗
공공·법률Public & legal·연동 도구·스킬Tools & skills·출처 날짜Source date

폐쇄망에서도 쓰는 공무원용 로컬 AI 워크스페이스를 만들었다Built an offline local-AI workspace for Korean civil servants

Kminer2053의 gongmuwon은 인터넷 없이 PC 안의 경량 모델(Ollama)로 대화·지식폴더 근거 검색·일정 등록 후 한글(HWPX) 보고서까지 만든다. 자료가 PC 밖으로 나가지 않는다고 밝힌다.Kminer2053's gongmuwon desktop app runs a lightweight local model via Ollama, answers from the user's knowledge folder, registers schedules and produces HWPX reports; the README states data never leaves the PC (created 2026-04).

대안·대응Alternatives noted · 폐쇄망 때문에 클라우드 모델을 못 쓰는 환경을 로컬 모델로 우회했다.
OllamaHWPX폐쇄망
Kminer2053 · GitHub ↗

새 가이드와 사례를 격주 뉴스레터로 받아보기Get new guides and reports every two weeks