OK Agent

한글(hwp) 파일 열기 — 한글 프로그램 없이 내용 보는 법

최종 수정

한글 프로그램이 없으면 한컴이 무료로 배포하는 '한컴오피스 뷰어'나 웹 변환 서비스로 .hwp를 열 수 있습니다. 내용을 읽고 정리까지 하려면 Claude·ChatGPT 같은 AI에 K-MCP의 HWP 도구를 연결해 두고 파일이나 링크를 주면, AI가 본문을 텍스트로 읽어 요약하거나 표를 뽑아 줍니다. 설치 없이 주소 하나(https://okagent.kr/api/mcp)만 연결하면 되고 무료입니다.

방법 비교

방법좋은 점한계
한컴오피스 뷰어 (무료)원본 모양 그대로 보기편집·요약은 안 됨, 설치 필요
웹 변환 사이트설치 없음파일을 외부 서버에 올림
AI + HWP 도구 (K-MCP)요약·검색·표 추출·다른 작업으로 바로 연결그림·서식은 텍스트로만

AI로 여는 순서

  • Claude나 ChatGPT에 아래 '연결' 방법대로 K-MCP를 추가합니다.
  • hwp 파일 링크(URL)를 줍니다. 내 컴퓨터에 설치(npx)해 쓰는 경우에는 파일 경로를 알려 줘도 됩니다.
  • "이 공문 요약해 줘", "제출 기한만 뽑아 줘"처럼 원하는 걸 말합니다.

AI에게 이렇게 물어보세요

답하는 도구: hwp_to_markdown (@appmonster/mcp-hwp) 도구 설명

AI에 연결하기 (1분, 무료)

설치 없이 주소 하나만 연결하면 됩니다. 조회 도구가 모두 열려 있고, 하루 100회까지는 가입도 필요 없습니다.

https://okagent.kr/api/mcp
Claude
설정 → 커넥터 → 커스텀 커넥터 추가 → 이름 K-MCP, URL에 위 주소
ChatGPT
설정 → 앱과 커넥터 → 고급 설정에서 개발자 모드 켜기 → 커넥터 만들기 → MCP 서버 URL에 위 주소, 인증 없음
Claude Code
claude mcp add --transport http kmcp https://okagent.kr/api/mcp
Cursor
{"mcpServers":{"kmcp":{"url":"https://okagent.kr/api/mcp"}}}

내 컴퓨터에서만 돌리고 싶으면 로컬 설치도 됩니다 (키 필요 없음):

claude mcp add hwp -- npx -y @appmonster/mcp-hwp

개발자: API로 바로 호출

같은 기능을 HTTP로도 씁니다. 도구 목록은 GET https://okagent.kr/api/tools, 명세는 openapi.json에 있습니다.

curl -s -X POST https://okagent.kr/api/tools/hwp_to_markdown \
  -H "content-type: application/json" \
  -d '{"url":"https://example.com/공문.hwp"}'

자주 묻는 질문

hwpx 파일도 되나요?

됩니다. 예전 형식(.hwp 5.0)과 새 형식(.hwpx) 모두 읽습니다. 암호가 걸린 문서와 배포용 문서는 읽을 수 없습니다.

맥이나 아이폰에서도 되나요?

AI 앱(Claude·ChatGPT)에 원격 주소로 연결하면 운영체제와 상관없이 됩니다. 로컬 설치 방식은 Node.js가 있는 맥·윈도우·리눅스에서 됩니다.

파일이 외부에 저장되나요?

원격 연결은 요청한 파일을 읽어 변환한 뒤 결과만 돌려주고 파일을 보관하지 않습니다. 민감한 문서는 내 컴퓨터에서 도는 로컬 설치(npx)를 쓰면 파일이 밖으로 나가지 않습니다.

함께 보면 좋은 글